Add a bilingual MkDocs Material documentation site

Build the docs/ pages into a Material for MkDocs site with English (default)
and Spanish via the mkdocs-static-i18n plugin: a translated landing page plus
Spanish counterparts (docs/*.es.md) of every page, an in-theme language
switcher, search, a light/dark palette and translated navigation. Add
docs/requirements.txt, the Docs GitHub Pages deploy workflow, and a contributor
section on building and publishing the site. Ignore the local .venv-docs/ and
the built site/ directory.

Author: Paururo

.github/CONTRIBUTING.md

@@ -64,6 +64,31 @@ If you’d like to contribute code, follow these steps:
 
 4. You’re ready to start contributing!
 
+## Building the Documentation
+
+The documentation site is built with [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) and is bilingual (English + Spanish) through the `mkdocs-static-i18n` plugin. English pages live in `docs/*.md`; their Spanish counterparts are the `docs/*.es.md` siblings.
+
+```bash
+python3 -m venv .venv-docs
+.venv-docs/bin/pip install -r docs/requirements.txt
+.venv-docs/bin/mkdocs serve          # live preview at http://127.0.0.1:8000/get_MNV/
+.venv-docs/bin/mkdocs build --strict # production build into ./site
+```
+
+### Publishing
+
+The site is published to GitHub Pages on the `gh-pages` branch and served at
+`https://pathogenomics-lab.github.io/get_MNV/`. The **Docs** workflow
+(`.github/workflows/docs.yml`) deploys automatically on pushes to the default
+branch that touch the docs, and can also be run manually. To publish from any
+branch locally:
+
+```bash
+.venv-docs/bin/mkdocs gh-deploy --force
+```
+
+Enable serving once under **Settings → Pages → Source: Deploy from a branch → `gh-pages` / `(root)`**. To surface the docs from another website, just link to that URL.
+
 ## Submitting a Pull Request
 1. Ensure that your code follows the coding guidelines and passes all tests.
 2. Write a clear commit message detailing what your change does.

.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Docs
+
+# Build the bilingual Material for MkDocs site and publish it to the gh-pages
+# branch, which GitHub Pages serves at https://pathogenomics-lab.github.io/get_MNV/.
+#
+# Triggers:
+#   - push to the default branch touching docs/, mkdocs.yml or this workflow
+#   - manual run (workflow_dispatch), selectable on any branch that has this file
+#
+# You can also publish from any branch locally, without CI:
+#   .venv-docs/bin/mkdocs gh-deploy --force
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: docs-pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    name: Build and deploy docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - name: Install build dependencies
+        run: pip install -r docs/requirements.txt
+      - name: Validate (strict build)
+        run: mkdocs build --strict
+      - name: Configure git identity
+        run: |
+          git config user.name "Paururo"
+          git config user.email "50167687+Paururo@users.noreply.github.com"
+      - name: Deploy to gh-pages
+        run: mkdocs gh-deploy --force

.gitignore

@@ -14,3 +14,7 @@ src-tauri/gen/
 minimal_example.tar.gz
 minimal_example/
 /test_pancreas/
+
+# Documentation site (MkDocs)
+/.venv-docs/
+/site/