[MITgcm-support] readthedoc build error

[Edward W Doddridge]

Hi Dan,

There is a bug in Sphinx 1.7.5<https://github.com/sphinx-doc/sphinx/issues/5048> that is causing the docs builds to fail. You can see that this is also affecting the continuous integration tests on Travis - https://travis-ci.org/MITgcm/MITgcm/jobs/394922177

Manually setting a different version of Sphinx should fix this problem.

Cheers,
Ed


________________________________
Edward Doddridge
Postdoctoral researcher
Earth, Atmospheric and Planetary Sciences
Massachusetts Institute of Technology

www.doddridge.me<http://www.doddridge.me>

On 21 Jun 2018, at 21:47, Daniel Goldberg <dan.goldberg at ed.ac.uk<mailto:dan.goldberg at ed.ac.uk>> wrote:

Hello All

I am in the process of writing documentation for a physical package, and have installed the required libs following the instructions here:

https://mitgcm.readthedocs.io/en/latest/contributing/contributing.html#building-the-manual

however, on calling "make html" in the MITgcm/doc directory, i received the following errors (see attached log):

Exception occurred:
  File "/disk/scratch/local.2/fenics/miniconda3/lib/python3.6/site-packages/sphinx/environment/collector                                                                                s/toctree.py", line 172, in _walk_toc
    subnode[0]['secnumber'] = list(number)
TypeError: 'NoneType' object is not iterable

There are continually python issues with my school's IT infrastructure but I thought that using miniconda would take care of this?

Is there another way of testing whether the libraries have installed correctly other than the test i have just done? (is the html generator run overnight?)

Thanks
Dan

--

Daniel Goldberg, PhD
Lecturer in Glaciology
School of Geosciences, University of Edinburgh
Geography Building, Drummond Street, Edinburgh EH8 9XP


em: D<mailto:dgoldber at mit.edu>an.Goldberg at ed.ac.uk<mailto:an.Goldberg at ed.ac.uk>
web: https://www.geos.ed.ac.uk/homes/dgoldber
<sphinx-err-8lq_htha.log>The University of Edinburgh is a charitable body, registered in
Scotland, with registration number SC005336.
_______________________________________________
MITgcm-support mailing list
MITgcm-support at mitgcm.org<mailto:MITgcm-support at mitgcm.org>
http://mailman.mitgcm.org/mailman/listinfo/mitgcm-support

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.mitgcm.org/pipermail/mitgcm-support/attachments/20180621/6426bd7e/attachment.html>