[AstroPy] Fail to build documentation for astropy 1.3

Thu Jan 26 07:50:16 EST 2017

I believe we don't have the downloadables for the latest releases on the
main docs page, see the discussion here
https://github.com/astropy/astropy/issues/5677

Brigitta

On 26 January 2017 at 09:44, Christoph Deil <Christoph.Deil at mpi-hd.mpg.de>
wrote:

> 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/ 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> 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),
> 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...
> intersphinx inventory has moved: http://docs.python.org/2/objects.inv ->
> https://docs.python.org/2/objects.inv
> loading intersphinx inventory from http://matplotlib.org/objects.inv...
> loading intersphinx inventory from http://pandas.pydata.org/
> pandas-docs/stable/objects.inv...
> loading intersphinx inventory from http://ipython.
> readthedocs.io/en/stable/objects.inv...
> loading intersphinx inventory from http://docs.scipy.org/
> doc/scipy/reference/objects.inv...
> intersphinx inventory has moved: http://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...
> intersphinx inventory has moved: http://pytest.org/latest/objects.inv ->
> http://docs.pytest.org/en/latest/objects.inv
> loading intersphinx inventory from http://docs.h5py.org/en/
> latest/objects.inv...
> loading intersphinx inventory from http://docs.scipy.org/
> doc/numpy/objects.inv...
> intersphinx inventory has moved: http://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
> 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 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
>
> 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 listAstroPy at scipy.orghttps://mail.scipy.org/mailman/listinfo/astropy
>
>
> _______________________________________________
> AstroPy mailing list
> AstroPy at scipy.org
> 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/370cb4f6/attachment.html>