From: Dmitry Shachnev Date: Tue, 2 Jun 2020 12:22:52 +0300 Subject: Use local intersphinx inventory To prevent Sphinx from downloading https://docs.python.org/3/objects.inv during build. --- doc/conf.py | 5 ++--- doc/tutorial/deploying.rst | 9 ++++++--- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/conf.py b/doc/conf.py index 437b08f..8b21457 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -159,9 +159,8 @@ texinfo_documents = [ ] intersphinx_mapping = { - 'python': ('https://docs.python.org/3/', None), - 'requests': ('https://requests.readthedocs.io/en/latest/', None), - 'readthedocs': ('https://docs.readthedocs.io/en/stable', None), + 'python': ('/usr/share/doc/python3-doc/html', None), + 'requests': ('/usr/share/doc/python-requests-doc/html', None), } # Sphinx document translation with sphinx gettext feature uses these settings: diff --git a/doc/tutorial/deploying.rst b/doc/tutorial/deploying.rst index 6b7913f..f5fd24e 100644 --- a/doc/tutorial/deploying.rst +++ b/doc/tutorial/deploying.rst @@ -155,13 +155,16 @@ Read the Docs ~~~~~~~~~~~~~ `Read the Docs`_ offers integration with both GitHub and GitLab. The quickest -way of getting started is to follow :doc:`the RTD -tutorial `, which is loosely based on this one. +way of getting started is to follow `the RTD tutorial`_, which is loosely +based on this one. You can publish your sources on GitHub as explained :ref:`in the previous section `, then skip directly to -:ref:`readthedocs:tutorial/index:Sign up for Read the Docs`. +`Sign up for Read the Docs`_. If you choose GitLab instead, the process is similar. +.. _the RTD tutorial: https://docs.readthedocs.io/en/stable/tutorial/index.html +.. _Sign up for Read the Docs: https://docs.readthedocs.io/en/stable/tutorial/index.html#sign-up-for-read-the-docs + GitHub Pages ~~~~~~~~~~~~