This repository contains all of BlockCypher's API documentation, presented with the help of Slate.
We welcome Pull Requests to help us improve our documentation. If you're making edits, it's a good idea to run your fork of our docs locally before submitting a Pull Request; to do so, follow these instructions straight from Slate.
To get started with Slate, please check out the Getting Started section in our wiki.
You're going to need:
- Linux or macOS โ Windows may work, but is unsupported.
- Ruby, version 2.3.1 or newer
- Bundler โ If Ruby is already installed, but the
bundle
command doesn't work, just rungem install bundler
in a terminal.
- Fork this repository on Github.
- Clone your forked repository (not our original one) to your hard drive with
git clone https://github.com/YOURUSERNAME/docs.git
cd docs
- Install all dependencies:
bundle install
- Start the test server:
bundle exec middleman server
# either run this to run locally
bundle install
bundle exec middleman server
# OR run this to run with vagrant
vagrant up
# OR run this to run with docker
docker build . -t slate:latest # this only needs to be run once
docker run -p 4567:4567 -v $(pwd)/source:/srv/slate/source slate:latest
You can now see the docs at http://localhost:4567.
We build our docs locally then serve them from our own server. If you want to build them locally---instead of running them via middleman server
, if you're curious about the html output---you can run this command:
bundle exec middleman build
This creates a ./build
directory, which contains all the generated HTML, CSS, Javascript, and assets.
Just submit an issue. And, of course, feel free to submit Pull Requests with bug fixes or proposed changes.