question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Documentation building fails

See original GitHub issue

Description

make html and make html-noplot fails on docs/

Steps/Code to Reproduce

cd docs make html

Expected Results

Should build without errors

Actual Results

Sphinx version: 1.4.4 Python version: 2.7.6 (CPython) Docutils version: 0.11 release Jinja2 version: 2.7.2 Last messages:

Loaded extensions: Traceback (most recent call last): File “/usr/local/lib/python2.7/dist-packages/sphinx/cmdline.py”, line 243, in main opts.warningiserror, opts.tags, opts.verbosity, opts.jobs) File “/usr/local/lib/python2.7/dist-packages/sphinx/application.py”, line 204, in init self._init_builder(self.buildername) File “/usr/local/lib/python2.7/dist-packages/sphinx/application.py”, line 280, in _init_builder self.emit(‘builder-inited’) File “/usr/local/lib/python2.7/dist-packages/sphinx/application.py”, line 552, in emit results.append(callback(self, *args)) File “/home/rameshwar/Open-Source/scikit-learn/doc/sphinxext/sphinx_gallery/gen_gallery.py”, line 119, in generate_gallery_rst File “/home/rameshwar/Open-Source/scikit-learn/doc/sphinxext/sphinx_gallery/gen_rst.py”, line 464, in generate_dir_rst File “/home/rameshwar/Open-Source/scikit-learn/doc/sphinxext/sphinx_gallery/gen_rst.py”, line 669, in generate_file_rst File “/home/rameshwar/Open-Source/scikit-learn/doc/sphinxext/sphinx_gallery/gen_rst.py”, line 441, in save_thumbnail File “/home/rameshwar/Open-Source/scikit-learn/doc/sphinxext/sphinx_gallery/gen_rst.py”, line 379, in scale_image File “/usr/local/lib/python2.7/dist-packages/PIL/Image.py”, line 2410, in open fp = builtins.open(filename, “rb”) IOError: [Errno 2] No such file or directory: ‘/home/rameshwar/Open-Source/scikit-learn/doc/sphinxext/sphinx_gallery/_static/no_image.png’

Versions

Linux-3.19.0-42-generic-x86_64-with-Ubuntu-14.04-trusty ‘Python’, ‘2.7.6 (default, Oct 26 2016, 20:30:19) \n[GCC 4.8.4]’ ‘NumPy’, ‘1.11.1’ ‘SciPy’, ‘0.13.3’ ‘Scikit-Learn’, ‘0.19.0’

Issue Analytics

  • State:closed
  • Created 6 years ago
  • Comments:7 (7 by maintainers)

github_iconTop GitHub Comments

1reaction
lestevecommented, Oct 22, 2017

I upgraded to Sphinx 1.6.4 and also removed the numpy_ext/ and sphinx_gallery/ directories in doc/sphinxext/. Build is running successfully now. I think we should delete these folders too in make clean. What do you think @jnothman ?

Glad you got it working, closing. doc/sphinxext/numpy_ext and doc/sphinxext/sphinx_gallery folders don’t exist in master any more so there is no point deleting them in make clean.

0reactions
jnothmancommented, Oct 22, 2017

The problem @lesteve is that if there are files left in those directories, git won’t remove them upon checkout. They can then interfere with doc building.

We’ve previously cleaned up reminded directories in sklearn for this reason. Could do same for doc. To be safe could only remove pyc and similar files.

Read more comments on GitHub >

github_iconTop Results From Across the Web

Why Most IT Documentation Fails - IT Glue
Most documentation efforts fail, especially in smaller IT service providers ... for documentation, and a dashboard for building engagement, ...
Read more >
Eight reasons why documentation fails for users, and what to ...
The longer you're at an organization, the more you get pulled in different directions, since you build up a larger base of documentation...
Read more >
0.3.3: documentation build fails #590 - GitHub
md:21: ERROR: Unknown directive type "margin". /home/tkloczko/rpmbuild/BUILD/sphinx-book-theme-0.3.3/docs/notebooks.md: WARNING: Executing notebook failed: ...
Read more >
Failure and documentation of building structures
Failure and documentation of building structures. Dr. Niels-Jørgen Aagaard. 1. , Erik Steen Pedersen. 2. Abstract. In recent years, a number of structural ......
Read more >
"Why Documents Fail And What You Can Do About It" - YouTube
Why Documents Fail And What You Can Do About ItProduct design documents are like vacation photos. They help the people that were there ......
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found