The OSKR Owner's Manual is generated via the Sphinx Documentation Generator.
Most people will want to view the documents directly online at:
- HTML
This repository is only of use if you wish to modify the document, create additional content, etc.
Docs can be viewed online by clicking on the doc directory, viewed on your local machine, or built out in to pretty html or pdf documents. These built out files will be placed within a [_build] directory.
To install:
virtualenv -p python3 ./oom
source ./oom/bin/activate
pip install -r requirements.txt
To build locally:
source ./bin/activate # if virtualenv hasn't been activated yet
make html
or, to make a single large html file:
make singlehtml
To generate PDFs on OSX:
brew cask install mactex-no-gui # one time install
make latexpdf
To read locally in your browser:
open _build/html/index.html
To read the pdf locally:
open _build/latex/oom.pdf