psycopg2/doc
Daniele Varrazzo 626078388a Use pip-tools to create the requirement file to build the docs
Docs building just broke. The requirement file had some version upper
boundary that caused problems between Sphinx and jinja2.
2022-03-26 02:45:40 +01:00
..
src Fix typo in large object usage documentation 2021-11-21 16:10:42 +01:00
.gitignore Dropped customized doc template 2020-01-27 04:32:31 +00:00
COPYING.LESSER Trim trailing whitespace from all files throughout project 2017-12-01 21:42:14 -08:00
Makefile Fix building docs for the website 2021-06-17 03:54:14 +01:00
pep-0249.txt Trim trailing whitespace from all files throughout project 2017-12-01 21:42:14 -08:00
README.rst Website on https 2019-12-31 13:09:13 +01:00
release.rst Don't build .exe packages anymore 2021-06-30 14:52:27 +01:00
requirements.in Use pip-tools to create the requirement file to build the docs 2022-03-26 02:45:40 +01:00
requirements.txt Use pip-tools to create the requirement file to build the docs 2022-03-26 02:45:40 +01:00
SUCCESS Trim trailing whitespace from all files throughout project 2017-12-01 21:42:14 -08:00

How to build psycopg documentation
----------------------------------

Building the documentation usually requires building the library too for
introspection, so you will need the same prerequisites_.  The only extra
prerequisite is virtualenv_: the packages needed to build the docs will be
installed when building the env.

.. _prerequisites: https://www.psycopg.org/docs/install.html#install-from-source
.. _virtualenv: https://virtualenv.pypa.io/en/latest/

Build the env once with::

    make env

Then you can build the documentation with::

    make

You should find the rendered documentation in the ``html`` directory.