Add a GitHub Action to run tox

.github/workflows/tox.yml

@@ -0,0 +1,46 @@
+name: tox
+on: [push, pull_request]
+jobs:
+  tox-jobs:
+    strategy:
+      fail-fast: false
+      matrix:
+        job: [docs]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+          # cache: 'pip'  # Only use if there are requirements.txt files
+      - run: pip install --upgrade pip
+      - run: pip install setuptools tox
+      - run: pip install --editable .
+      - run: tox -e ${{ matrix.job }}
+
+  tox:
+    strategy:
+      fail-fast: false
+      # max-parallel: 4
+      matrix:  # https://docs.djangoproject.com/en/stable/faq/install/#what-python-version-can-i-use-with-django
+        os: [ubuntu-latest]  # [macos-latest, ubuntu-latest, windows-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', 'pypy3.10']
+        django-version: ['3.2', '4.2', '5.0']
+        elasticsearch-version: ['7.17.9']  # https://pypi.org/project/elasticsearch7
+        exclude:
+          - python-version: '3.8'
+            django-version: '5.0'
+          - python-version: '3.9'
+            django-version: '5.0'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          # cache: 'pip'  # Only use if there are requirements.txt files
+      - run: python3 --version && python --version
+      - run: pip install --upgrade pip
+      # - run: pip install django==${{ matrix.django-version }} elasticsearch==${{ matrix.elasticsearch-version }} tox
+      - run: pip install tox
+      - run: tox -e "py${{ matrix.python-version }}-django${{ matrix.django-version }}-es7.x"

docs/conf.py

@@ -76,7 +76,7 @@ def get_version(package):
 #
 # 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 = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -165,7 +165,7 @@ def get_version(package):
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
-    'http://docs.python.org/': None,
+    'python': ('https://docs.python.org/3', None),
     'django': ('https://django.readthedocs.io/en/latest/', None),
     'haystack': ('https://django-haystack.readthedocs.io/en/latest/', None)
 }