Update docs build configuration (#924)

akx · web-flow · commit f7af1b72e765 · 2022-11-02T08:25:47.000+02:00
* Use Python 3.11 * Use Sphinx 5 (and update extlinks configuration) * Use Python 3 intersphinx mapping * Install Babel from the build directory Refs #920
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -3,10 +3,17 @@
 version: 2
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-22.04
   tools:
-    python: "3.9"
-
+    python: "3.11"
+  jobs:
+    pre_build:
+      # Replace any Babel version something may have pulled in
+      # with the copy we're working on.  We'll also need to build
+      # the data files at that point, or date formatting _within_
+      # Sphinx will fail.
+      - pip install -e .
+      - make import-cldr
 sphinx:
    configuration: docs/conf.py
 
diff --git a/docs/conf.py b/docs/conf.py
@@ -251,10 +251,10 @@
 #texinfo_show_urls = 'footnote'
 
 intersphinx_mapping = {
-    'https://docs.python.org/2/': None,
+    'https://docs.python.org/3/': None,
 }
 
 extlinks = {
-    'gh': ('https://github.com/python-babel/babel/issues/%s', '#'),
-    'trac': ('http://babel.edgewall.org/ticket/%s', 'ticket #'),
+    'gh': ('https://github.com/python-babel/babel/issues/%s', '#%s'),
+    'trac': ('http://babel.edgewall.org/ticket/%s', 'ticket #%s'),
 }
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -1 +1 @@
-Sphinx~=4.4.0
+Sphinx~=5.3.0

Original file line number	Diff line number	Diff line change
`@@ -251,10 +251,10 @@`
`251`	`251`	`#texinfo_show_urls = 'footnote'`
`252`	`252`
`253`	`253`	`intersphinx_mapping = {`
`254`		`- 'https://docs.python.org/2/': None,`
	`254`	`+ 'https://docs.python.org/3/': None,`
`255`	`255`	`}`
`256`	`256`
`257`	`257`	`extlinks = {`
`258`		`- 'gh': ('https://github.com/python-babel/babel/issues/%s', '#'),`
`259`		`- 'trac': ('http://babel.edgewall.org/ticket/%s', 'ticket #'),`
	`258`	`+ 'gh': ('https://github.com/python-babel/babel/issues/%s', '#%s'),`
	`259`	`+ 'trac': ('http://babel.edgewall.org/ticket/%s', 'ticket #%s'),`
`260`	`260`	`}`