From: Aarni Koskela <akx@iki.fi>
Date: Wed, 2 Nov 2022 06:25:47 +0000 (+0200)
Subject: Update docs build configuration (#924)
X-Git-Tag: v2.12.0~36
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=f7af1b72e765278b3431de3f3b92c6b9a189b18e;p=thirdparty%2Fbabel.git

Update docs build configuration (#924)

* Use Python 3.11
* Use Sphinx 5 (and update extlinks configuration)
* Use Python 3 intersphinx mapping
* Install Babel from the build directory

Refs https://github.com/python-babel/babel/issues/920
---

diff --git a/.readthedocs.yml b/.readthedocs.yml
index a4a09ac6..cc83f360 100644
--- 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
index 24c6ce21..c0e23894 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -251,10 +251,10 @@ texinfo_documents = [
 #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
index aaedb211..c133306c 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1 +1 @@
-Sphinx~=4.4.0
+Sphinx~=5.3.0