first commit

.gitignore

@@ -0,0 +1,2 @@
+.cache
+site/

Dockerfile

@@ -0,0 +1,3 @@
+FROM docker.io/squidfunk/mkdocs-material
+
+RUN pip install mkdocs-glightbox

Makefile

@@ -0,0 +1,8 @@
+init:
+	podman run --rm -ti -v ${PWD}:/docs docker.io/squidfunk/mkdocs-material new .
+
+preview:
+	podman run --rm -ti -v ${PWD}:/docs -p 8000:8000 docker.io/squidfunk/mkdocs-material
+
+build:
+	podman run --rm -ti -v ${PWD}:/docs docker.io/squidfunk/mkdocs-material build

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.

docs/physical-network.md

@@ -0,0 +1,10 @@
+# Physical Network
+
+``` mermaid
+graph LR
+  A[Start] --> B{Error?};
+  B -->|Yes| C[Hmm...];
+  C --> D[Debug];
+  D --> B;
+  B ---->|No| E[Yay!];
+```

mkdocs.yml

@@ -0,0 +1,32 @@
+site_name: Cowley-tech homelab docs
+site_url: https://docs.lab.cowley.tech
+theme:
+  name: material
+  language: en
+  palette:
+    primary: blue grey
+#    - scheme: default
+#      toggle:
+#        icon: material/brghtness-7
+#        name: Switch to dark mode
+#    - scheme: slate
+#      toggle:
+#        icon: material/brghtness-4
+#        name: Switch to light mode
+  features:
+    - navigation.instant
+    - search.suggest
+    - search.highlight
+  icon:
+    logo: logo-monochrome
+plugins:
+  - search
+
+markdown_extensions:
+  - footnotes
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - tables