Fixes #392 -- Enable Sphinx extension and update source links

[zachborboa]

django/djangoproject.com#392

[pauloxnet]

It can be interesting to investigate if we can add a test in this PR and also to have an idea of what we'll see in the documentation.

[zachborboa]

It can be interesting to investigate if we can add a test in this PR and also to have an idea of what we'll see in the documentation.

Tests have been added

[pauloxnet]

It can be interesting to investigate if we can add a test in this PR and also to have an idea of what we'll see in the documentation.

Tests have been added

Thanks. Can you provide also a screenshot of how it looks ?

[zachborboa]

Thanks. Can you provide also a screenshot of how it looks ?

screenshot:

[zachborboa]

Ready for review. Thank you

[smithdc1]

This ticket on trac seems related to this PR. https://code.djangoproject.com/ticket/29942

[zachborboa]

This ticket on trac seems related to this PR. https://code.djangoproject.com/ticket/29942

Agreeing with the ticket. Quite a lot more of the helpful [source] links could be added to the docs when the import failures get fixed.

The errors are currently being silently ignored, but can be unhidden when generating the docs by increasing verbosity:

$ cd django/docs/
$ export SPHINXOPTS="-v"
$ run make html

The solution is to probably install the required modules in the environment where the docs are generated. This would fix errors like missing the psycopg2 module for postgres so that source links to modules like django.contrib.postgres.aggregates.BitAnd are added to sections missing them like https://docs.djangoproject.com/en/dev/ref/contrib/postgres/aggregates/#bitand.

[sarahboyce]

Superseded by #16918