test deployment (#5)

Author: afuetterer

.github/workflows/ci.yml

@@ -47,3 +47,6 @@ jobs:
       with:
         parallel-finished: true
         base-path: tika
+
+  docs:
+    uses: ./.github/workflows/documentation.yml

.github/workflows/documentation.yml

@@ -2,18 +2,14 @@
 name: Documentation
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["master"]
-
+  workflow_call:
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: write
-  pages: write
-  id-token: write
+# Set permissions at the job level.
+permissions: {}
 
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
@@ -22,32 +18,55 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  # Single deploy job since we're just deploying
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
+  build:
+    runs-on: ubuntu-slim
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Install dependencies
-        run: |
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+          cache: 'pip'
+
+      - run: |
           python -m pip install --upgrade pip
           python -m pip install . --group=docs
-      - name: Sphinx APIDoc
-        run: |
-          sphinx-apidoc -f -o docs/source/ .
-      - name: Sphinx build
-        run: |
-          sphinx-build -b html docs/source/ docs/build/html
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
+          python -m pip list
+
+      - run: |
+          sphinx-build --builder html docs/source/ docs/build/html
+
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
-          # Upload entire repository
+          name: docs-html
           path: './docs/build/html'
+
+  deploy:
+    needs: build
+    # Deploy only on push to master
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-slim
+    steps:
+      # - name: Download HTML artifact
+      #   uses: actions/download-artifact@v4
+      #   with:
+      #     name: docs-html
+      #     path: docs/build/html
+
+      # - name: Setup Pages
+      #   uses: actions/configure-pages@v5
+
+      # - name: Upload Pages artifact
+      #   uses: actions/upload-pages-artifact@v4
+      #   with:
+      #     path: docs/build/html
+
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

docs/source/conf.py

@@ -11,9 +11,9 @@
 # Add the parent directory of the documentation root to sys.path
 sys.path.insert(0, os.path.abspath("../.."))
 
-project = 'tika-python'
-copyright = '2024, Chris A. Mattmann'
-author = 'Chris A. Mattmann'
+project = "tika-python"
+copyright = "2024, Chris A. Mattmann"
+author = "Chris A. Mattmann"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -26,16 +26,34 @@
     "sphinx.ext.autosectionlabel",
     "sphinx.ext.todo",
     "sphinx.ext.duration",
-    "myst_parser"
+    "myst_parser",
 ]
 
-templates_path = ['_templates']
-exclude_patterns = ['tika.tests*']
-
+templates_path = ["_templates"]
+exclude_patterns = ["tika.tests*"]
 
 
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme = 'furo'
-html_static_path = ['_static']
+html_theme = "furo"
+html_static_path = ["_static"]
+html_theme_options = {
+    "source_repository": "https://github.com/chrismattmann/tika-python",
+    "source_branch": "master",
+    "source_directory": "docs/source/",
+    "footer_icons": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/chrismattmann/tika-python",
+            # Embedded SVG instructions from furo docs
+            # Ref: https://pradyunsg.me/furo/customisation/footer/#configuration
+            "html": """
+                <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 16 16">
+                    <path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path>
+                </svg>
+            """,
+            "class": "",
+        },
+    ],
+}

docs/source/readme.rst

@@ -49,6 +49,7 @@ docs = [
 [project.urls]
 homepage = "http://github.com/chrismattmann/tika-python"
 repository = "http://github.com/chrismattmann/tika-python.git"
+documentation = "https://chrismattmann.github.io/tika-python"
 
 [project.scripts]
 tika-python = "tika.tika:main"