build: clone the localizethedocs locales

Author: hwhsu1231

.readthedocs.yaml

@@ -5,6 +5,22 @@
 # Required
 version: 2
 
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+  jobs:
+    post_checkout:
+      - |
+        PO_LOCALES=docs/locales
+        PO_REPOURL=https://github.com/localizethedocs/highlightjs-docs-l10n.git
+        case "$READTHEDOCS_VERSION" in
+          latest) PO_BRANCH="po/latest";;
+          stable) PO_BRANCH="po/stable";;
+        esac
+        git clone --branch=$PO_BRANCH $PO_REPOURL $PO_LOCALES
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
    configuration: docs/conf.py
@@ -15,6 +31,5 @@ sphinx:
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-   version: 3.7
    install:
    - requirements: docs/requirements.txt

docs/conf.py

@@ -91,6 +91,10 @@
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
 
+# -- Options for Internationalization ------------------------------------------
+
+gettext_compact = False
+gettext_additional_targets = ['index','literal-block','raw']
 
 # -- Options for HTML output ---------------------------------------------------
 

docs/requirements.txt

@@ -1,2 +1,3 @@
-myst-parser == 0.15.0
-sphinx-rtd-theme == 0.5.2
+sphinx == 9.1.0
+myst-parser == 5.1.0
+sphinx-rtd-theme == 3.1.0