Revision 08adeb5bef7e076e183ab2c81ab9cef19122d4b6 authored by Artem Artemev on 26 April 2019, 10:10:33 UTC, committed by Artem Artemev on 26 April 2019, 10:10:33 UTC
1 parent 8e3e4e8
README.md
# GPflow documentation
## Online
[![Documentation Status (master)](https://readthedocs.org/projects/gpflow/badge/?version=master)](http://gpflow.readthedocs.io/en/master/?badge=master)
[![Documentation Status (develop)](https://readthedocs.org/projects/gpflow/badge/?version=develop)](http://gpflow.readthedocs.io/en/develop/?badge=develop)
We use readthedocs to build the online documentation, and have separate versions for the `master` and `develop` branches: https://gpflow.readthedocs.io/en/master/ (for the latest official release e.g. on PyPI) and https://gpflow.readthedocs.io/en/develop/ (for the latest cutting-edge code available from the develop branch on github).
## Compiling documentation
To compile the GPflow documentation locally:
1. Install doc dependencies
```
pip install sphinx sphinx_rtd_theme numpydoc nbsphinx
```
2. Install pandoc
```
pip install pandoc
```
If pandoc does not install via pip, or step 4 does not work, go to pandoc.org/installing.html
3. Change directory to `doc`
```
cd doc
```
4. Compile the documentation as html
```
make html
```
5. Check documentation locally by opening (in a browser) doc/build/html/index.html
![swh spinner](/static/img/swh-spinner.gif)
Computing file changes ...