Skip to content

Commit

Permalink
Fix docs build for Sphinx #8
Browse files Browse the repository at this point in the history
I have no idea what I'm doing, I based this on
zopefoundation/zope.testing#49 after looking at
the configuration examples at
https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html

Fixes #76.
  • Loading branch information
mgedmin committed Sep 26, 2024
1 parent bd81ab0 commit 3823cb2
Showing 1 changed file with 10 additions and 13 deletions.
23 changes: 10 additions & 13 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -48,10 +48,7 @@
templates_path = ['_templates']

# The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string:
#
# source_suffix = ['.rst', '.md']
source_suffix = '.rst'
source_suffix = {'.rst': 'restructuredtext'}

# The encoding of source files.
#
Expand All @@ -62,7 +59,7 @@

# General information about the project.
project = 'zope.publisher'
copyright = '2017, Zope Community'
copyright = '2017-2024, Zope Community'
author = 'Zope Community'

# The version info for the project you're documenting, acts as replacement for
Expand All @@ -79,7 +76,7 @@
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
language = None
#language = None

# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:
Expand Down Expand Up @@ -353,13 +350,13 @@

# Example configuration for intersphinx: refer to the Python standard library.
intersphinx_mapping = {
'https://docs.python.org/': None,
'https://zopeinterface.readthedocs.io/en/latest': None,
'https://zopeevent.readthedocs.io/en/latest/': None,
'https://zopecomponent.readthedocs.io/en/latest/': None,
'https://zopelocation.readthedocs.io/en/latest/': None,
'https://zopecontainer.readthedocs.io/en/latest/': None,
'https://zopesite.readthedocs.io/en/latest/': None,
'python': ('https://docs.python.org/', None),
'zopeinterface': ('https://zopeinterface.readthedocs.io/en/latest', None),
'zopeevent': ('https://zopeevent.readthedocs.io/en/latest/', None),
'zopecomponent': ('https://zopecomponent.readthedocs.io/en/latest/', None),
'zopelocation': ('https://zopelocation.readthedocs.io/en/latest/', None),
'zopecontainer': ('https://zopecontainer.readthedocs.io/en/latest/', None),
'zopesite': ('https://zopesite.readthedocs.io/en/latest/', None),
}

extlinks = {
Expand Down

0 comments on commit 3823cb2

Please sign in to comment.