This repository hosts the documentation for the Hyperledger Labs project Perun, a blockchain-agnostic state channels framework.
The documentation is written in reStructuredText or Markdown (of CommonMark flavor) and can be built with Sphinx. The latest generated HTML documentation is published at https://labs.hyperledger.org/perun-doc/.
Clone the repository with submodules.
git clone https://github.com/hyperledger-labs/perun-doc.git
cd perun-doc
git submodule update --init --recursiveTo check if python, sphinx and sphinx-rtd-theme are installed, run setup.sh from the project root directory. If any of the components are missing, the script will install them.
# from project root directory
./setup.shNote: "sphinx-build" and other binaries are installed to ~/.local/bin.
Make sure that this directory is included in the $PATH environment
variable. By default that may not be the case, e.g. if you're using bash
on Ubuntu 17.0, Ubuntu 18.04, or Debian Stable (Buster).
Use make to build the documentation. During development the most important make targets are:
# from project root directory
make help # to see usage info
make html # to build html into ./build/html/
make linkcheck # to check all external links for integrityThis work is licensed under a Creative Commons Attribution 4.0 International License (CC-BY-4.0).