Add config files for mkdocs deployment

Author: emmuhamm

.github/workflows/deploy-docs_ghpage.yml

@@ -0,0 +1,29 @@
+name: Deploy Docs to Pages
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ "main" ]   # or "develop"
+  # optional schedule:
+  # schedule:
+  #   - cron: "0 0 * * 6"
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r docs/requirements.txt
+          # if you want mkdocstrings to import your package:
+          pip install .
+
+      - name: Deploy
+        run: mkdocs gh-deploy --force

mkdocs.yml

@@ -0,0 +1,55 @@
+site_name: DUNE Run Control (drunc) Developer Documentation
+
+repo_name: DUNE-DAQ/drunc
+repo_url: https://github.com/DUNE-DAQ/drunc
+
+theme:
+  name: material
+  palette: 
+    # Palette toggle for light/dark mode
+    - scheme: default
+      toggle:
+        icon: material/lightbulb
+        name: Switch to dark mode
+    - scheme: slate
+      toggle:
+        icon: material/lightbulb-outline
+        name: Switch to light mode
+  icon:
+    repo: fontawesome/brands/git-alt
+
+
+markdown_extensions:
+  - admonition
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
+
+plugins:
+  - search
+  - exclude:
+      glob:
+        - Developer-Wiki/*
+  - gen-files:
+      # scripts:
+      #   - docs/utils/generate_ghpages_docstrings.py
+  - literate-nav:
+      nav_file: README.md
+  - section-index
+  - mkdocstrings:
+      default_handler: python
+      handlers:
+        python:
+          options:
+            show_source: true
+            show_root_heading: true
+            show_category_heading: true
+            merge_init_into_class: true
+          paths: [.]
+
+# hooks:
+# - docs/utils/mkdocs_hooks.py

requirements.txt

@@ -0,0 +1,10 @@
+mkdocs
+mkdocs-material
+mkdocs-mermaid2-plugin
+mkdocs-gen-files
+mkdocs-literate-nav
+mkdocs-section-index
+mkdocstrings
+mkdocstrings-python
+pymdown-extensions
+mkdocs-exclude