Update docs config (#208)

* Update docs config: auto-detect version, remove Travis button

- Read version/release from emails.__version__ instead of hardcoded 0.5
- Remove travis_button option from theme configs (Travis CI is no longer used)
- Fix intersphinx_mapping format for modern Sphinx

* Use docs/requirements.txt for documentation build dependencies in CI

* Add missing docs/_static directory

Author: lavr

.github/workflows/tests.yaml

@@ -61,6 +61,22 @@ jobs:
       - name: run django tests
         run: tox -e ${{ matrix.tox }}
 
+  docs:
+    name: "docs"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: pip
+      - name: install dependencies
+        run: |
+          pip install -e .
+          pip install sphinx -r docs/requirements.txt
+      - name: build docs
+        run: sphinx-build -W -b html docs docs/_build/html
+
   typecheck:
     name: "typecheck"
     runs-on: ubuntu-latest

docs/_static/.gitkeep

@@ -1,12 +1,14 @@
 import sys, os
 sys.path.append(os.path.abspath('_themes'))
+sys.path.append(os.path.abspath('..'))
 sys.path.append(os.path.abspath('.'))
 
 from conf_base import *
 from conf_theme_alabaster import *
 
 #from conf_theme_flask import *
 
-version = '0.5'
-release = '0.5.1'
+from emails import __version__ as _emails_version
+version = '.'.join(_emails_version.split('.')[:2])
+release = _emails_version
 html_theme_path = ['_themes', ] + html_theme_path

docs/conf.py

@@ -117,7 +117,6 @@
 html_theme_options = {
     'github_user': 'lavr',
     'github_repo': 'python-emails',
-    'travis_button': True
 }
 
 # Theme options are theme-specific and customize the look and feel of a theme
@@ -279,4 +278,4 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'http://docs.python.org/': None}
+intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}

docs/conf_base.py

@@ -11,6 +11,5 @@
     'github_user': 'lavr',
     'github_repo': 'python-emails',
     'github_banner': True,
-    'travis_button': True,
     'code_font_size': '0.8em'
 }