certbot/docs
Brad Warren d8057f0e17
Fix Sphinx (#6070)
Fixes #4686.

In Sphinx 1.6, they changed how they handle images in latex and PDF files. You can learn more about this by reading the linked issue (or I can answer any questions), but the shortish version is we now need to use the extension sphinx.ext.imgconverter. This is only available in Sphinx 1.6+.

I also updated our pinned versions to use the latest Sphinx and a new dependency it pulled in called sphinxcontrib-websupport. To build the latex and PDF docs, you must first run:

apt-get install imagemagick latexmk texlive texlive-latex-extra

Afterwards, if you create the normal Certbot dev environment using this branch, activate the virtual environment, and from the root of the repo run make -C docs clean latex latexpdf, you'll successfully build the PDF docs.

* fix #4686

* bump minimum Sphinx req
2018-08-06 09:45:56 -07:00
..
_static Fix docs warnings 2015-01-24 13:13:13 +00:00
_templates add let's encrypt status to footer and fix link 2018-01-24 13:56:40 -08:00
api fixes #5380 (#5812) 2018-04-03 11:44:13 -07:00
man docs: Fix generation of manpage certbot(1). 2016-05-31 20:37:05 -04:00
.gitignore gitignores for various doc files 2015-10-21 17:06:36 -07:00
api.rst docs: markup fixes, separate section for api docs, link to demo video, improved phrasing 2015-01-26 14:58:24 +01:00
challenges.rst fix a few nits 2017-07-20 11:16:48 -07:00
ciphers.rst docs(ciphers): newer keylength.com recommendations (#4266) 2017-03-03 10:44:12 -08:00
cli-help.txt Release 0.26.1 2018-07-16 16:36:59 -07:00
conf.py Fix Sphinx (#6070) 2018-08-06 09:45:56 -07:00
contributing.rst Add mypy info to Certbot docs (#6033) 2018-05-31 13:57:23 -07:00
index.rst Adding 'What Is a Certificate' section 2017-07-20 11:14:08 -07:00
install.rst Gpg2 doc (#5981) 2018-07-18 08:34:09 -07:00
intro.rst Adding 'What Is a Certificate' section 2017-07-20 11:14:08 -07:00
make.bat CRLF: unix2dos docs/make.bat 2015-11-04 07:27:30 +00:00
Makefile sphinx-quickstart 2014-11-30 02:38:33 +01:00
packaging.rst Remove linode and ovh links which aren't valid yet. (#6198) 2018-07-13 14:21:23 -07:00
resources.rst Remove duplication in resources.rst 2016-08-24 14:37:47 -07:00
using.rst OVH DNS Authenticator (#5423) 2018-07-10 20:52:32 -07:00
what.rst Adding 'What Is a Certificate' section 2017-07-20 11:14:08 -07:00