Add MkDocs workflow.

Author: DanAlbert

.github/workflows/build-pages.yml

@@ -0,0 +1,52 @@
+name: GitHub Pages
+
+on:
+  workflow_dispatch:
+  push:
+  pull_request:
+
+jobs:
+  gh-pages-build:
+    name: Build GitHub Pages
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v5
+    - uses: actions/setup-python@v6
+      with:
+        python-version: "3.13"
+        cache: "pip"
+
+    - run: pip install -r requirements.txt
+
+    - name: build docs
+      run: |
+        mkdocs build
+
+    - name: Upload static files as artifact
+      id: deployment
+      uses: actions/upload-pages-artifact@v3
+      with:
+        path: site/
+
+  deploy:
+    name: Deploy GitHub Pages
+    needs: gh-pages-build
+
+    concurrency:
+      group: "github-pages"
+      cancel-in-progress: false
+
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -11,3 +11,5 @@ libwebp
 **/.cxx
 display-p3/third_party
 
+# MkDocs build output
+/site

docs/index.md

@@ -0,0 +1,17 @@
+# Welcome to MkDocs
+
+For full documentation visit [mkdocs.org](https://www.mkdocs.org).
+
+## Commands
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs -h` - Print help message and exit.
+
+## Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.

mkdocs.yml

@@ -0,0 +1,31 @@
+site_name: Android NDK Samples
+site_url: !ENV SITE_URL
+repo_url: !ENV REPO_URL
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  features:
+    - content.action.edit
+    - content.action.view
+
+  palette:
+    # Palette toggle for automatic mode
+    - media: "(prefers-color-scheme)"
+      toggle:
+        icon: material/brightness-auto
+        name: Switch to light mode
+
+    # Palette toggle for light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default 
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+
+    # Palette toggle for dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to system preference

requirements.txt

@@ -0,0 +1,41 @@
+alabaster==1.0.0
+babel==2.17.0
+backrefs==5.9
+certifi==2025.8.3
+charset-normalizer==3.4.3
+click==8.3.0
+colorama==0.4.6
+docutils==0.21.2
+ghp-import==2.1.0
+idna==3.10
+imagesize==1.4.1
+Jinja2==3.1.6
+Markdown==3.9
+MarkupSafe==3.0.3
+mergedeep==1.3.4
+mkdocs==1.6.1
+mkdocs-get-deps==0.2.0
+mkdocs-material==9.6.21
+mkdocs-material-extensions==1.3.1
+packaging==25.0
+paginate==0.5.7
+pathspec==0.12.1
+platformdirs==4.4.0
+Pygments==2.19.2
+pymdown-extensions==10.16.1
+python-dateutil==2.9.0.post0
+PyYAML==6.0.3
+pyyaml_env_tag==1.1
+requests==2.32.5
+roman-numerals-py==3.1.0
+six==1.17.0
+snowballstemmer==3.0.1
+Sphinx==8.2.3
+sphinxcontrib-applehelp==2.0.0
+sphinxcontrib-devhelp==2.0.0
+sphinxcontrib-htmlhelp==2.1.0
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==2.0.0
+sphinxcontrib-serializinghtml==2.0.0
+urllib3==2.5.0
+watchdog==6.0.0