feat(mkdocs): 全マークダウンを結合するフックを追加

.gitignore

@@ -3,6 +3,7 @@ __pycache__/
 .cache/
 
 site
+docs/all.txt
 
 # IDE / Editor
 .vscode/

hooks/gather.py

@@ -0,0 +1,12 @@
+from pathlib import Path
+
+src_dir = Path("./docs/content")
+out_file = Path("./docs/all.txt")
+
+def gather_md(*args, **kwargs):
+    md_files = sorted(src_dir.rglob("*.md"))
+
+    with out_file.open("w", encoding="utf-8") as out:
+        for md in md_files:
+            out.write(f"\n\n# [{md.relative_to(src_dir)}]\n\n")
+            out.write(md.read_text(encoding="utf-8"))

mkdocs.yml

@@ -83,6 +83,9 @@ plugins:
   - redirects:
       redirect_maps:
         'index.md': 'content/index.md'
+  - mkdocs-simple-hooks:
+      hooks:
+        on_pre_build: "hooks.gather:gather_md"
 
 hooks:
   - hooks/check.py

requirements.txt

@@ -1,4 +1,5 @@
 mkdocs
 mkdocs-material
 pymdown-extensions
-mkdocs-redirects
+mkdocs-redirects
+mkdocs-simple-hooks