Fix broken extlinks in newer Sphinx versions.

[StykMartin]

At this moment it is impossible to build documentation on a newer version of sphinx. This is basically a blocker for Fedora packages.

Closes: #174

Sphinx 6 introduced a breaking change for extlinks.
extlinks: Sphinx-6.0 will require base URL to contain exactly one \'%s\' and all other \'%\' need to be escaped as \'%%\'.'

[StykMartin]

EL7

[root@873093213d60 documentation]# make
python2 -c '__requires__ = ["Sphinx >= 1.0", "CherryPy < 3.0",]; import pkg_resources; import bkr; bkr.__path__ = ["../Common/bkr", "../Server/bkr", "../Client/src/bkr"]; exec(open("/usr/bin/sphinx-build").read())' -b man -d _build/doctrees   . _build/man
/bin/sh: line 1:   515 Trace/breakpoint trap   (core dumped) /sbin/ldconfig -p 2> /dev/null
/bin/sh: line 1:   518 Trace/breakpoint trap   (core dumped) /sbin/ldconfig -p 2> /dev/null
Making output directory...
Running Sphinx v1.1.3
loading pickled environment... not yet created
loading intersphinx inventory from http://docs.python.org/objects.inv...
loading intersphinx inventory from http://beaker-project.org/dev/objects.inv...
WARNING: intersphinx inventory 'http://beaker-project.org/dev/objects.inv' not fetchable due to <class 'urllib2.URLError'>: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:618)>
building [man]: all manpages
updating environment: 181 added, 0 changed, 0 removed
2023-10-19 19:29:47,912 rdflib INFO RDFLib Version: 4.1.2
reading sources... [100%] whats-new/upgrade-23
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... bkr.1 { } bkr-workflow-xslt.1 { } beaker-wizard.1 { } beaker-create-kickstart.8 { } beaker-create-ipxe-image.8 { } beaker-import.8 { } beaker-init.8 { } beaker-repo-update.8 { } beaker-usage-reminder.8 { } bkr-list-systems.1 { } bkr-labcontroller-create.1 { } bkr-distros-list.1 { } bkr-task-list.1 { } bkr-job-list.1 { } bkr-labcontroller-modify.1 { } bkr-harness-test.1 { } bkr-system-reserve.1 { } bkr-distros-edit-version.1 { } bkr-job-submit.1 { } bkr-watchdogs-extend.1 { } bkr-list-labcontrollers.1 { } bkr-remove-account.1 { } bkr-update-inventory.1 { } bkr-workflow-installer-test.1 { } bkr-pool-delete.1 { } bkr-job-modify.1 { } bkr-user-modify.1 { } bkr-job-clone.1 { } bkr-system-history-list.1 { } bkr-loan-return.1 { } bkr-system-release.1 { } bkr-machine-test.1 { } bkr-system-power.1 { } bkr-labcontroller-list.1 { } bkr-pool-create.1 { } bkr-system-provision.1 { } bkr-job-logs.1 { } bkr-distros-tag.1 { } bkr-distros-untag.1 { } bkr-group-create.1 { } bkr-watchdog-extend.1 { } bkr-policy-list.1 { } bkr-job-results.1 { } bkr-system-details.1 { } bkr-policy-revoke.1 { } bkr-group-members.1 { } bkr-pool-modify.1 { } bkr-watchdog-show.1 { } bkr-job-cancel.1 { } bkr-policy-grant.1 { } bkr-system-delete.1 { } bkr-task-details.1 { } bkr-pool-systems.1 { } bkr-pool-add.1 { } bkr-system-create.1 { } bkr-update-prefs.1 { } bkr-system-modify.1 { } bkr-loan-grant.1 { } bkr-pool-remove.1 { } bkr-task-delete.1 { } bkr-system-status.1 { } bkr-job-delete.1 { } bkr-distro-trees-list.1 { } bkr-workflow-simple.1 { } bkr-task-add.1 { } bkr-job-watch.1 { } bkr-pool-list.1 { } bkr-job-comment.1 { } bkr-group-list.1 { } bkr-update-openstack-trust.1 { } bkr-group-modify.1 { } bkr-whoami.1 { } bkr-distro-trees-verify.1 { } bkr-system-list.1 { }
build succeeded, 1 warning.

Build finished. The manual pages are in _build/man.
For 'Unknown node: container', see https://bitbucket.org/birkenfeld/sphinx/issue/1018/
python2 -c '__requires__ = ["Sphinx >= 1.0", "CherryPy < 3.0",]; import pkg_resources; import bkr; bkr.__path__ = ["../Common/bkr", "../Server/bkr", "../Client/src/bkr"]; exec(open("/usr/bin/sphinx-build").read())' -b text -d _build/doctrees   . _build/text
/bin/sh: line 1:   525 Trace/breakpoint trap   (core dumped) /sbin/ldconfig -p 2> /dev/null
/bin/sh: line 1:   528 Trace/breakpoint trap   (core dumped) /sbin/ldconfig -p 2> /dev/null
Making output directory...
Running Sphinx v1.1.3
loading pickled environment... done
loading intersphinx inventory from http://beaker-project.org/dev/objects.inv...
WARNING: intersphinx inventory 'http://beaker-project.org/dev/objects.inv' not fetchable due to <class 'urllib2.URLError'>: <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:618)>
building [text]: targets for 181 source files that are out of date
updating environment: 0 added, 2 changed, 0 removed
reading sources... [100%] man/subcommands
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] whats-new/upgrade-23
/data/documentation/whats-new/release-0.13.rst:4: WARNING: undefined label: proposal-enhanced-user-groups (if the link has no caption the label must precede a section header)
/data/documentation/whats-new/release-0.16.rst:51: WARNING: undefined label: beakerdev:proposal-external-tasks (if the link has no caption the label must precede a section header)
/data/documentation/whats-new/release-19.rst:18: WARNING: undefined label: beakerdev:proposal-system-page-improvements (if the link has no caption the label must precede a section header)
/data/documentation/whats-new/release-20.rst:36: WARNING: undefined label: beakerdev:proposal-predefined-access-policies (if the link has no caption the label must precede a section header)
build succeeded, 5 warnings.

Build finished. The text files are in _build/text.

[StykMartin]

/packit rebuild-failed