docs: restructure abbreviations into individual pages for sidebar

2026-08-06 15:38:15 -04:00
parent 742fd7941d
commit 82d761b026
14 changed files with 106 additions and 70 deletions
@@ -98,7 +98,7 @@ def build_concat(root: Path) -> str:
        chunks.append("#" * (depth + 1) + " " + heading)
        if _is_function_page(path, root):
            body = _with_entries(body, path, entries)
-        elif path.stem == "04-abbreviations":
+        elif "04-abbreviations" in path.parts:
            abbrs = mt.parse_abbreviations(DOCS.parent / "conf.d")
            body = _with_abbreviations(body, abbrs)
        if body:
@@ -699,7 +699,7 @@ def build_site(root: Path, out: Path) -> list[dict]:

        if not is_function_dir:
            target = out / rel
-            if path.stem == "04-abbreviations":
+            if "04-abbreviations" in path.parts:
                abbrs = mt.parse_abbreviations(DOCS.parent / "conf.d")
                body = _with_abbreviations(body, abbrs)
            target.parent.mkdir(parents=True, exist_ok=True)
@@ -1,68 +0,0 @@
---
-title: Abbreviations
-manTitle: 4. ABBREVIATIONS
-sidebar:
-  order: 8
-helpKeywords:
- abbreviations
- abbr
- abbrs
---
-
-Abbreviations expand when you press Space or Enter. They are terminal-aware:
-some expand differently in Kitty vs WezTerm vs other terminals.
-
-## 4.1 Editors
-
-<!-- GENERATED: Editors -->
-
-## 4.2 Navigation and Listing
-
-<!-- GENERATED: Navigation and Listing -->
-
-## 4.3 Git
-
-<!-- GENERATED: Git -->
-
-## 4.4 Terminal Windows, Tabs, and Panes
-
-These abbreviations control the terminal emulator. Each has a Kitty
-variant and a WezTerm variant; the correct one is inserted based on
-`$TERM` or `$TERM_PROGRAM`.
-
-<!-- GENERATED: Terminal Windows, Tabs, and Panes -->
-
-## 4.5 Chezmoi
-
-<!-- GENERATED: Chezmoi -->
-
-## 4.6 Docker
-
-<!-- GENERATED: Docker -->
-
-## 4.7 Systemctl
-
-<!-- GENERATED: Systemctl -->
-
-## 4.8 AI Assistants
-
-<!-- GENERATED: AI Assistants -->
-
-## 4.9 Miscellaneous
-
-<!-- GENERATED: Miscellaneous -->
-
-## 4.10 Shell Aliases
-
-These aliases are defined in conf.d/tricks.fish via alias (which creates Fish
-functions). They are active in all interactive sessions.
-
-<!-- GENERATED: Shell Aliases -->
-
-## 4.11 History Expansion
-
-Bash-style history expansions trigger on Space or Enter. Some are implemented
-as abbreviations (e.g. `!*`), while others (`!!`, `!$`, `!.`) are implemented
-as keybindings, but they all serve the same purpose.
-
-<!-- GENERATED: History Expansion -->
@@ -0,0 +1,6 @@
+---
+title: Editors
+manTitle: 4.1 EDITORS
+---
+
+<!-- GENERATED: Editors -->
@@ -0,0 +1,6 @@
+---
+title: Navigation and Listing
+manTitle: 4.2 NAVIGATION AND LISTING
+---
+
+<!-- GENERATED: Navigation and Listing -->
@@ -0,0 +1,6 @@
+---
+title: Git
+manTitle: 4.3 GIT
+---
+
+<!-- GENERATED: Git -->
@@ -0,0 +1,10 @@
+---
+title: Terminal Windows, Tabs, and Panes
+manTitle: 4.4 TERMINAL WINDOWS, TABS, AND PANES
+---
+
+These abbreviations control the terminal emulator. Each has a Kitty
+variant and a WezTerm variant; the correct one is inserted based on
+`$TERM` or `$TERM_PROGRAM`.
+
+<!-- GENERATED: Terminal Windows, Tabs, and Panes -->
@@ -0,0 +1,6 @@
+---
+title: Chezmoi
+manTitle: 4.5 CHEZMOI
+---
+
+<!-- GENERATED: Chezmoi -->
@@ -0,0 +1,6 @@
+---
+title: Docker
+manTitle: 4.6 DOCKER
+---
+
+<!-- GENERATED: Docker -->
@@ -0,0 +1,6 @@
+---
+title: Systemctl
+manTitle: 4.7 SYSTEMCTL
+---
+
+<!-- GENERATED: Systemctl -->
@@ -0,0 +1,6 @@
+---
+title: AI Assistants
+manTitle: 4.8 AI ASSISTANTS
+---
+
+<!-- GENERATED: AI Assistants -->
@@ -0,0 +1,6 @@
+---
+title: Miscellaneous
+manTitle: 4.9 MISCELLANEOUS
+---
+
+<!-- GENERATED: Miscellaneous -->
@@ -0,0 +1,9 @@
+---
+title: Shell Aliases
+manTitle: 4.10 SHELL ALIASES
+---
+
+These aliases are defined in conf.d/tricks.fish via alias (which creates Fish
+functions). They are active in all interactive sessions.
+
+<!-- GENERATED: Shell Aliases -->
@@ -0,0 +1,10 @@
+---
+title: History Expansion
+manTitle: 4.11 HISTORY EXPANSION
+---
+
+Bash-style history expansions trigger on Space or Enter. Some are implemented
+as abbreviations (e.g. `!*`), while others (`!!`, `!$`, `!.`) are implemented
+as keybindings, but they all serve the same purpose.
+
+<!-- GENERATED: History Expansion -->
@@ -0,0 +1,27 @@
+---
+title: Abbreviations
+manTitle: 4. ABBREVIATIONS
+sidebar:
+  order: 8
+helpKeywords:
+- abbreviations
+- abbr
+- abbrs
+---
+
+Abbreviations expand when you press Space or Enter. They are terminal-aware:
+some expand differently in Kitty vs WezTerm vs other terminals.
+
+<CardGrid>
+  <LinkCard title="Editors" href="/04-abbreviations/01-editors/" />
+  <LinkCard title="Navigation and Listing" href="/04-abbreviations/02-navigation-and-listing/" />
+  <LinkCard title="Git" href="/04-abbreviations/03-git/" />
+  <LinkCard title="Terminal Windows, Tabs, and Panes" href="/04-abbreviations/04-terminal-windows-tabs-and-panes/" />
+  <LinkCard title="Chezmoi" href="/04-abbreviations/05-chezmoi/" />
+  <LinkCard title="Docker" href="/04-abbreviations/06-docker/" />
+  <LinkCard title="Systemctl" href="/04-abbreviations/07-systemctl/" />
+  <LinkCard title="AI Assistants" href="/04-abbreviations/08-ai-assistants/" />
+  <LinkCard title="Miscellaneous" href="/04-abbreviations/09-miscellaneous/" />
+  <LinkCard title="Shell Aliases" href="/04-abbreviations/10-shell-aliases/" />
+  <LinkCard title="History Expansion" href="/04-abbreviations/11-history-expansion/" />
+</CardGrid>