Experiment with the mkdocs offline plugin

In doing so, don't emphasise online docs over offline, but instead make this
about an online/offline split and both are as important as each other.

.gitignore

@@ -110,7 +110,7 @@ venv.bak/
 
 # mkdocs documentation
 /site
-/docs-local
+/docs-offline
 
 # mypy
 .mypy_cache/

Makefile

@@ -12,11 +12,11 @@ format-check:
 	black --check src
 docs-serve:
 	rm -rf .screenshot_cache
-	mkdocs serve
+	mkdocs serve --config-file mkdocs-online.yml
 docs-build:
-	mkdocs build
-docs-local-build:
-	mkdocs build --config-file mkdocs-local.yml
+	mkdocs build --config-file mkdocs-online.yml
+docs-build-offline:
+	mkdocs build --config-file mkdocs-offline.yml
 docs-deploy:
 	rm -rf .screenshot_cache
 	mkdocs gh-deploy

mkdocs-common.yml

@@ -62,9 +62,9 @@ theme:
       name: Switch to light mode
 
 plugins:
-
-- autorefs:
-- mkdocstrings:
+  - search:
+  - autorefs:
+  - mkdocstrings:
       custom_templates: docs/_templates
       default_handler: python
       handlers:
@@ -79,7 +79,7 @@ plugins:
               - "!^can_replace$"
     watch:
       - src/textual
-- exclude:
+  - exclude:
       glob:
         - "**/_template.md"
 

mkdocs-offline.yml

@@ -1,7 +1,9 @@
 INHERIT: mkdocs-common.yml
 
-site_dir: docs-local
-use_directory_urls: false
+plugins:
+  - offline
+
+site_dir: docs-offline
 
 nav:
   - Introduction:

mkdocs-online.yml

@@ -4,7 +4,6 @@ site_url: https://textual.textualize.io/
 edit_uri: edit/main/docs/
 
 plugins:
-  - search:
   - blog:
   - rss:
       match_path: blog/posts/.*