Skip to content

janbormet/perun-doc

 
 

Repository files navigation

Perun Documentation

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/.

Build

Clone the repository with submodules.

git clone https://github.com/hyperledger-labs/perun-doc.git
cd perun-doc
git submodule update --init --recursive

To 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.sh

Note: "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 integrity

License

This work is licensed under a Creative Commons Attribution 4.0 International License (CC-BY-4.0).

About

Blockchain-agnostic state channels framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 55.0%
  • Makefile 16.2%
  • Shell 15.9%
  • HTML 12.9%