Merge pull request #968 from brainsick/makefile-sphinx-fix

update Sphinx build instructions
This commit is contained in:
Rémi Verschelde
2018-01-11 14:13:40 +01:00
committed by GitHub
2 changed files with 7 additions and 1 deletions
+1 -1
View File
@@ -10,7 +10,7 @@ LATEXDEPS = latex dvipng
# User-friendly check for sphinx-build
ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD make variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
endif
# check for latex dependencies
+6
View File
@@ -53,6 +53,12 @@ You can then build the HTML documentation from the root folder of this repositor
make html
```
or:
```sh
make SPHINXBUILD=~/.local/bin/sphinx-build html
```
The compilation might take some time as the `classes/` folder contains many files to parse.
You can then test the changes live by opening `_build/html/index.html` in your favourite browser.