enh: Build documentation in root dir

TEParsons · May 26, 2024 · 983d6f9 · 983d6f9
1 parent 12a587e
commit 983d6f9
Show file tree

Hide file tree

Showing 14 changed files with 41 additions and 193 deletions.
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -0,0 +1,37 @@
+name: Publish docs
+
+on: push
+
+jobs:
+  build:
+    name: Build docs
+    runs-on: macos-11
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.10"
+
+    - name: Install dependencies
+      run: |
+        python3 -m pip install mkdocs mkdocs-torillic
+    
+    - name: Build docs
+      run: |
+        mkdocs build
+    
+    - name: Commit
+      run: |
+        git add --all
+        git commit --all -m "sys: Build documentation"
+    
+    - name: Push
+      uses: ad-m/github-push-action@master
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        branch: gh-pages
+        force: true
diff --git a/.gitignore b/.gitignore
@@ -15,4 +15,6 @@ sphinx/example/stderr.txt
 mkdocs/example/site
 
 scratch.*
-*.code-workspace
+*.code-workspace
+
+.export
diff --git a/docs/dist.stub b/docs/dist.stub
diff --git a/docs/src/examples.md → docs_src/examples.md b/docs/src/examples.md → docs_src/examples.md
diff --git a/docs/src/index.md → docs_src/index.md b/docs/src/index.md → docs_src/index.md
diff --git a/docs/src/logo.png → docs_src/logo.png b/docs/src/logo.png → docs_src/logo.png
diff --git a/docs/src/previews/mkdocs.png → docs_src/previews/mkdocs.png b/docs/src/previews/mkdocs.png → docs_src/previews/mkdocs.png
diff --git a/docs/mkdocs.yaml → mkdocs.yaml b/docs/mkdocs.yaml → mkdocs.yaml
@@ -3,12 +3,10 @@ theme:
   features: 
     - navigation.pathnavigation
 site_name: Torillic
-docs_dir: src
+docs_dir: docs_src
 site_dir: docs
 nav:
   - Home: index.md
   - Example Statblocks: examples.md
-exclude_docs: |
-  desktop.ini
 markdown_extensions:
   - nl2br
diff --git a/utils/__init__.py b/utils/__init__.py
diff --git a/utils/build.py b/utils/build.py
diff --git a/utils/export.py b/utils/export.py
diff --git a/utils/publish.py b/utils/publish.py
diff --git a/utils/version.py b/utils/version.py
diff --git a/version b/version