Files
scikit-image/doc
Juan Nunez-Iglesias e5991c8aa3 Add missing comment '#' markers for doctest skip
Dunno how these got through but when we start running these it's gonna
fail dramatically!
2015-04-05 16:52:58 +10:00
..
2015-03-14 10:35:04 -05:00
2015-03-03 23:41:32 -08:00
2012-10-29 18:10:39 +01:00
2013-03-13 12:08:08 +01:00
2015-03-14 20:27:03 +01:00

Building docs

To build docs, run make in this directory. make help lists all targets.

Requirements

Sphinx and Latex is needed to build doc.

Spinx:

pip install sphinx

Latex Ubuntu:

sudo apt-get install -qq texlive texlive-latex-extra dvipng

Latex Mac:

Install the full MacTex installation or install the smaller BasicTex and add ucs and dvipng packages:

sudo tlmgr install ucs dvipng

Fixing Warnings

  • "citation not found: R###" $ cd doc/build; grep -rin R### . There is probably an underscore after a reference in the first line of a docstring (e.g. [1]_)

  • "Duplicate citation R###, other instance in..."" There is probably a [2] without a [1] in one of the docstrings

  • Make sure to use pre-sphinxification paths to images (not the _images directory)