[AstroPy] Fail to build documentation for astropy 1.3

[Christoph Deil]

One more thing: if you just want to have the Astropy docs for offline reading, you don’t need to build them yourself.

At http://docs.astropy.org/en/stable/ <http://docs.astropy.org/en/stable/> in the lower right corner there’s a little black box.
If you click it, it will expand and there’s a link to download a PDF, HTML and EPUB version of the docs.

Christoph


> On 26 Jan 2017, at 10:17, Simon Conseil <simon at sconseil.fr> wrote:
> 
> Hi,
> 
> I can reproduce on a fresh environment, and I found that pyyaml and matplotlib are now hard requirements to build the docs: pyyaml for the astropy.io.misc.yaml module, and matplotlib for astropy.visualization.wcsaxes. Once you install both it should build !
> You may also want to install sphinx-gallery <http://sphinx-gallery.readthedocs.io/> to build the examples, but this one is correctly mentioned in the install doc page.
> 
> Cheers,
> Simon
> 
> 
> Le 26/01/2017 à 08:42, Christoph Deil a écrit :
>> 
>>> On 26 Jan 2017, at 04:00, Masato Onodera <masato.onodera at gmail.com <mailto:masato.onodera at gmail.com>> wrote:
>>> 
>>> Hello, 
>>> 
>>> I'd like to build a documentation of astropy-1.3 to look at it when I'm not connected to the internet.  I followed the instruction (http://docs.astropy.org/en/stable/install.html#building-documentation <http://docs.astropy.org/en/stable/install.html#building-documentation>), but either ways do not work for me producing the following error message (this is for the case of "python setup.py build_docs").  I also tried both python 2.7 and 3.5 and got the same error.   Are there any ideas how to fix this?
>>> 
>>> Best regards,
>>> Masato Onodera
>>> 
>>> 
>>> Running Sphinx v1.5.1
>>> loading pickled environment... not yet created
>>> loading intersphinx inventory from http://docs.python.org/2/objects.inv <http://docs.python.org/2/objects.inv>...
>>> intersphinx inventory has moved: http://docs.python.org/2/objects.inv <http://docs.python.org/2/objects.inv> -> https://docs.python.org/2/objects.inv <https://docs.python.org/2/objects.inv>
>>> loading intersphinx inventory from http://matplotlib.org/objects.inv <http://matplotlib.org/objects.inv>...
>>> loading intersphinx inventory from http://pandas.pydata.org/pandas-docs/stable/objects.inv <http://pandas.pydata.org/pandas-docs/stable/objects.inv>...
>>> loading intersphinx inventory from http://ipython.readthedocs.io/en/stable/objects.inv <http://ipython.readthedocs.io/en/stable/objects.inv>...
>>> loading intersphinx inventory from http://docs.scipy.org/doc/scipy/reference/objects.inv <http://docs.scipy.org/doc/scipy/reference/objects.inv>...
>>> intersphinx inventory has moved: http://docs.scipy.org/doc/scipy/reference/objects.inv <http://docs.scipy.org/doc/scipy/reference/objects.inv> -> https://docs.scipy.org/doc/scipy/reference/objects.inv <https://docs.scipy.org/doc/scipy/reference/objects.inv>
>>> loading intersphinx inventory from http://pytest.org/latest/objects.inv <http://pytest.org/latest/objects.inv>...
>>> intersphinx inventory has moved: http://pytest.org/latest/objects.inv <http://pytest.org/latest/objects.inv> -> http://docs.pytest.org/en/latest/objects.inv <http://docs.pytest.org/en/latest/objects.inv>
>>> loading intersphinx inventory from http://docs.h5py.org/en/latest/objects.inv <http://docs.h5py.org/en/latest/objects.inv>...
>>> loading intersphinx inventory from http://docs.scipy.org/doc/numpy/objects.inv <http://docs.scipy.org/doc/numpy/objects.inv>...
>>> intersphinx inventory has moved: http://docs.scipy.org/doc/numpy/objects.inv <http://docs.scipy.org/doc/numpy/objects.inv> -> https://docs.scipy.org/doc/numpy/objects.inv <https://docs.scipy.org/doc/numpy/objects.inv>
>>> loading intersphinx inventory from /Users/monodera/packages/astropy-1.3/astropy_helpers/astropy_helpers/sphinx/local/python2_local_links.inv...
>>> [autosummary] generating autosummary for: analytic_functions/index.rst, changelog.rst, config/config_0_4_transition.rst, config/index.rst, constants/index.rst, convolution/index.rst, convolution/kernels.rst, convolution/using.rst, coordinates/angles.rst, coordinates/definitions.rst, ..., wcs/relax.rst, whatsnew/0.1.rst, whatsnew/0.2.rst, whatsnew/0.3.rst, whatsnew/0.4.rst, whatsnew/1.0.rst, whatsnew/1.1.rst, whatsnew/1.2.rst, whatsnew/1.3.rst, whatsnew/index.rst
>>> [automodsumm] vo/conesearch/index.rst: found 27 automodsumm entries to generate
>>> [automodsumm] time/index.rst: found 30 automodsumm entries to generate
>>> [automodsumm] io/ascii/index.rst: found 55 automodsumm entries to generate
>>> [automodsumm] convolution/index.rst: found 22 automodsumm entries to generate
>>> [automodsumm] stats/index.rst: found 34 automodsumm entries to generate
>>> [automodsumm] vo/samp/index.rst: found 11 automodsumm entries to generate
>>> [automodsumm] constants/index.rst: found 2 automodsumm entries to generate
>>> [automodsumm] nddata/utils.rst: found 9 automodsumm entries to generate
>>> [automodsumm] units/index.rst: found 86 automodsumm entries to generate
>>> [automodsumm] logging.rst: found 3 automodsumm entries to generate
>>> [automodsumm] cosmology/index.rst: found 11 automodsumm entries to generate
>>> [automodsumm] visualization/wcsaxes/index.rst: found 10 automodsumm entries to generate
>>> [automodsumm] io/votable/index.rst: found 33 automodsumm entries to generate
>>> [automodsumm] config/index.rst: found 10 automodsumm entries to generate
>>> [automodsumm] io/misc.rst: found 9 automodsumm entries to generate
>>> [automodsumm] utils/index.rst: found 91 automodsumm entries to generate
>>> [automodsumm] io/registry.rst: found 11 automodsumm entries to generate
>>> [automodsumm] testhelpers.rst: found 13 automodsumm entries to generate
>>> [automodsumm] wcs/index.rst: found 30 automodsumm entries to generate
>>> [automodsumm] table/index.rst: found 22 automodsumm entries to generate
>>> [automodsumm] visualization/index.rst: found 27 automodsumm entries to generate
>>> [automodsumm] coordinates/index.rst: found 69 automodsumm entries to generate
>>> [automodsumm] modeling/index.rst: found 189 automodsumm entries to generate
>>> [automodsumm] nddata/index.rst: found 33 automodsumm entries to generate
>>> [automodsumm] analytic_functions/index.rst: found 2 automodsumm entries to generate
>>> ________________________________________________________________________________
>>> Example directory ../examples does not have a README.txt file
>>> Skipping this directory
>>> ________________________________________________________________________________
>>> Traceback (most recent call last):
>>>   File "<stdin>", line 39, in <module>
>>> NameError: name 'self' is not defined
>>> Sphinx Documentation subprocess failed with return code 1
>>> _______________________________________________
>>> AstroPy mailing list
>>> AstroPy at scipy.org <mailto:AstroPy at scipy.org>
>>> https://mail.scipy.org/mailman/listinfo/astropy <https://mail.scipy.org/mailman/listinfo/astropy>
>> 
>> Hi Masato,
>> 
>> that’s a weird error message, with the traceback not mentioning a filename.
>> 
>> Could you please try again from a fresh Astropy 1.3 version to make sure you don’t have any accidental local file edits or something like that.
>> 
>> This should work:
>> 
>> Go to https://pypi.python.org/pypi/astropy/1.3 <https://pypi.python.org/pypi/astropy/1.3> and click on astropy-1.3.tar.gz
>> tar zxf astropy-1.3.tar.gz
>> cd astropy-1.3
>> python setup.py build_docs
>> # runs for ~ 10 minutes
>> open docs/_build/html/index.html
>> 
>> It does work for me. Here’s my full build log:
>> https://gist.github.com/cdeil/b0c0774b45966ecf05f04bde3d0a88a4 <https://gist.github.com/cdeil/b0c0774b45966ecf05f04bde3d0a88a4>
>> 
>> If it still doesn’t work for you, maybe you could post your full build log also.
>> It might contain a clue like another warning or error about what’s wrong.
>> 
>> Good luck!
>> Christoph
>> 
>> 
>> _______________________________________________
>> AstroPy mailing list
>> AstroPy at scipy.org <mailto:AstroPy at scipy.org>
>> https://mail.scipy.org/mailman/listinfo/astropy <https://mail.scipy.org/mailman/listinfo/astropy>
> 
> _______________________________________________
> AstroPy mailing list
> AstroPy at scipy.org
> https://mail.scipy.org/mailman/listinfo/astropy

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/astropy/attachments/20170126/d04476f1/attachment.html>