Error building Docs

I have been trying to build the docs for some time but always end up getting this error:

Makefile:30: recipe for target 'html' failed
make: *** [html] Error 2

I tried restarting with a fresh virtual environment and installing all the required packages but the result was the same. I run Ubuntu 18.04 and a full traceback of the issue is attached below. Thanks for any help with this.


Can you provide the version of Matplotlib you’re on?

import matplotlib
print (matplotlib.__version__)

Hi @story645,

The version is 3.2.1

I also identified multiple points in the contribution/doc-building documentation which could be improved to reduce confusion for new comers. Could be trivial for people consistently interacting with the codebase but I had to google each step individually to make sense of the docs.

This is potentially something that I can see myself contributing to after I solve this particular issue.

Ok, so we definitely need to make it clearer that you need to follow the dev version of the build docs:


I was finally able to solve this after starting a fresh environment and installing correct texlive and graphviz packages.

Also had to invoke make SPHINXOPTS= html to get rid of errors which was failing the build.

Thanks a lot for your help :slight_smile:

1 Like