doc,.github/workflows/Test.yml: removed btd uses, looks obsolete

.github/workflows/Test.yml

@@ -9,28 +9,34 @@ jobs:
 
 
   doc:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
     runs-on: ubuntu-latest
     name: '📓 Docs'
+
     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: '⬆️ Deploy to gh-pages'
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: doc/_build/html
+          publish_branch: gh-pages
+          keep_files: false
 
 
   lin-build:

doc/guide/install.rst

@@ -7,7 +7,7 @@ Linux
 =====
 
 Debian/Ubuntu
-----------
+-------------
 
 openFPGALoader is available in the default repositories:
 

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
+    openFPGALoader --cable jlink_base --fpga-part ti60f225 -f  /somewhere/project/outflow/*.hex