This site serves the protocol documentation for theQRL. The site is hosted at https://api.theqrl.org
This documentation is build using the Slate API documentation builder.
Slate helps you create beautiful, intelligent, responsive API documentation.
There are some great instructions on how to edit the site over in the Slate WIKI
- The main page is built from /source/index.html.md, Edit this File
- Proto files are pulled in from the /source/includes/ directory. Look here for the proto files and Edit here
- Code blocks that show up on the right are first after the section header
<aside class="success"></aside>
gives a call out in the bodyalert
andnotice
also work and change the style.
>
gives a call out in the code section on the right- Code blocks that start with ```javascript will be shown when the javascript tab is selected
- Code blocks that start with ```python will be shown when the python tab is selected
- Code blocks that start with ```shell will be shown when the cURL tab is selected
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/slate.git
cd slate
- Initialize and start Slate. You can either do this locally, or with Vagrant:
# either run this to run locally
bundle install
bundle exec middleman server
You can now see the docs at http://localhost:4567. Whoa! That was fast!
To build a clean static site simply. This will build into the /build directory
bundle exec middleman build --clean
OR run this to run with vagrant
vagrant up
Now that Slate is all set up on your machine, you'll probably want to learn more about editing Slate markdown, or how to publish your docs.
If you'd prefer to use Docker, instructions are available in the wiki.
For those who don't have JavaScript runtime or are experiencing JavaScript runtime issues with ExecJS, it is recommended to add the rubyracer gem to your gemfile and run bundle
again.
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
#grab the RVM script
\curl -sSL https://get.rvm.io -o rvm.sh
# install
cat rvm.sh | bash -s stable
#source it
source ~/.rvm/scripts/rvm
rvm install ruby --default
Install bundler with the following.
gem install bundler
From the root directory with the latest changes made in the source files, run the following commands.
# Install
bundle install
bundle exec middleman build --clean
This will take any new changes in the /source direcctory and build it into the /build folder with a static directory and index.html file. Move the /build directory to your webroot to serve the file.
- James Gordon - Site Layout and development - fr1t2
See also the list of contributors who participated in this project.
Drop in the discord if you need to ask a question QRL Discord Server