From 67b2cc7d5ce48926a208bf402c9ce99aef8757af Mon Sep 17 00:00:00 2001
From: Gwenhael Goavec-Merou <gwenhael.goavec-merou@trabucayre.com>
Date: Mon, 16 Feb 2026 11:01:57 +0100
Subject: [PATCH] doc: try to fix action

---
 .github/workflows/Test.yml    | 46 +++++++++++++++++++++++------------
 doc/guide/install.rst         |  2 +-
 doc/guide/troubleshooting.rst |  4 +--
 doc/vendors/efinix.rst        |  4 +--
 4 files changed, 36 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/Test.yml b/.github/workflows/Test.yml
index fa1d279..7b5ab11 100644
--- a/.github/workflows/Test.yml
+++ b/.github/workflows/Test.yml
@@ -9,28 +9,44 @@ jobs:
 
 
   doc:
+    if: github.event_name == 'push'
     runs-on: ubuntu-latest
     name: '📓 Docs'
+
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
     steps:
+      - name: '🧰 Checkout'
+        uses: actions/checkout@v4
 
-    - name: '🧰 Checkout'
-      uses: actions/checkout@v4
+      - name: '🐍 Setup Python'
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
 
-    - name: '📓 BuildTheDocs (BTD)'
-      uses: buildthedocs/btd@v0
-      with:
-        token: ${{ github.token }}
-        skip-deploy: ${{ github.event_name == 'pull_request' }}
+      - name: '📦 Install dependencies'
+        run: |
+          pip install sphinx PyYAML tabulate
 
-    - name: '🧹 Clean HTML build'
-      if: ${{ github.event_name != 'pull_request' }}
-      run: sudo rm -rf doc/_build/html/.git
+      - name: '📓 Build docs'
+        run: |
+          sphinx-build -b html doc doc/_build/html
 
-    - name: '📤 Upload artifact: HTML'
-      uses: actions/upload-artifact@v4
-      with:
-        name: openFPGALoader-Documentation
-        path: doc/_build/html
+      - name: '⬆️ Upload Pages artifact'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: doc/_build/html
+
+      - name: '🚀 Deploy to GitHub Pages'
+        id: deployment
+        uses: actions/deploy-pages@v4
 
 
   lin-build:
diff --git a/doc/guide/install.rst b/doc/guide/install.rst
index 1f43172..511697f 100644
--- a/doc/guide/install.rst
+++ b/doc/guide/install.rst
@@ -7,7 +7,7 @@ Linux
 =====
 
 Debian/Ubuntu
-----------
+-------------
 
 openFPGALoader is available in the default repositories:
 
diff --git a/doc/guide/troubleshooting.rst b/doc/guide/troubleshooting.rst
index a6e1547..64e40d6 100644
--- a/doc/guide/troubleshooting.rst
+++ b/doc/guide/troubleshooting.rst
@@ -1,7 +1,7 @@
 .. _troubleshooting:
 
-Troubleshooting
-###############
+Troubleshooting Guide
+#####################
 
 I installed openFPGALoader but it says `command not found` when I try to launch it
 ==================================================================================
diff --git a/doc/vendors/efinix.rst b/doc/vendors/efinix.rst
index a47115b..0b64f17 100644
--- a/doc/vendors/efinix.rst
+++ b/doc/vendors/efinix.rst
@@ -41,11 +41,11 @@ bin file load
     openFPGALoader --cable jlink_base -m  /somewhere/project/outflow/*.bin
 
 hex file flash
--------------
+--------------
 
 Example for ti60f225.
 NOTE: JTAG chains with more than one device (eg --index-chain) are currently not supported for writing to SPI flash
 
 .. code-block:: bash
 
-    openFPGALoader --cable jlink_base --fpga-part ti60f225 -f  /somewhere/project/outflow/*.hex
\ No newline at end of file
+    openFPGALoader --cable jlink_base --fpga-part ti60f225 -f  /somewhere/project/outflow/*.hex