This repository builds the documentation for hello.
It uses Sphinx, recommonmark, and GitHub Actions to produce documentation from the Markdown source files in this repository.
Use a local development server that regenerates the output whenever the input changes:
sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem
pip-3.7 install -r requirements.txt
export GITHUB_REPOSITORY="helloSystem/docs"
export PATH=~/.local/bin/:$PATH
gmake watch
Now open https://127.0.0.1:8000 in a web browser. It will be regenerated and refreshed whenever one of the input files changes.
One can also generate documentation in various output formats locally:
sudo pkg install -y py37-pip gmake # on FreeBSD, e.g., on helloSystem
pip-3.7 install -r requirements.txt
export GITHUB_REPOSITORY="helloSystem/docs"
export PATH=~/.local/bin/:$PATH
gmake html
gmake epub
gmake html
gmake qthelp
qmake # list more output formats