Skip to content

Latest commit

 

History

History
91 lines (59 loc) · 2.13 KB

README.rst

File metadata and controls

91 lines (59 loc) · 2.13 KB

SpinalDoc

How to build this documentation

With pipenv

Requirements (system)

  • make
  • git

Requirements (Python 3):

  • pipenv (will automatically download all the project requirements from pypi)

Create a virtual environment with pipenv (will use the Pipfile for installing the necessary packages)

pipenv install

then you can build the documentation

pipenv run make html

if you want run make multiple times, prepone pipenv run on each command can be annoying, you can spawn a subshell with

pipenv shell

and then you can use make the usual way

make html     # for html
make latex    # for latex
make latexpdf # for latex (will require latexpdf installed)
make          # list all the available output format

all the outputs will be in docs folder (for html: docs/html)

Without pipenv/virtualenv

Requirements (system):

  • make
  • git

Requirements (Python 3):

  • sphinx
  • sphinx-rtd-theme
  • sphinxcontrib-wavedrom

After installing the requirements you can run

make html     # for html
make latex    # for latex
make latexpdf # for latex (will require latexpdf installed)
make          # list all the available output format

Versioning

The documentation will show on the top left the last pushed tag. The magic is in the makefile:

SPHINXOPTS    = -Dversion=$(shell git describe --tags --abbrev=0)

this will ovveride the version variable in conf.py.

Continuous Integration(CI)

This repo use Travis for his CI needs. If you want have a gh-pages preview on your fork, you need to activate your repo on Travis admin page. After that you only need add GITHUB_TOKEN as Environment Variable with your Github personal token (you only need grant repo/public_repo access) More details here: