diff --git a/docs/build-manual.py b/docs/build-manual.py index 9461f4e..f630d67 100644 --- a/docs/build-manual.py +++ b/docs/build-manual.py @@ -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) diff --git a/docs/manual/04-abbreviations.md b/docs/manual/04-abbreviations.md deleted file mode 100644 index cc54bff..0000000 --- a/docs/manual/04-abbreviations.md +++ /dev/null @@ -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 - - - -## 4.2 Navigation and Listing - - - -## 4.3 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`. - - - -## 4.5 Chezmoi - - - -## 4.6 Docker - - - -## 4.7 Systemctl - - - -## 4.8 AI Assistants - - - -## 4.9 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. - - - -## 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. - - diff --git a/docs/manual/04-abbreviations/01-editors.md b/docs/manual/04-abbreviations/01-editors.md new file mode 100644 index 0000000..1b77576 --- /dev/null +++ b/docs/manual/04-abbreviations/01-editors.md @@ -0,0 +1,6 @@ +--- +title: Editors +manTitle: 4.1 EDITORS +--- + + diff --git a/docs/manual/04-abbreviations/02-navigation-and-listing.md b/docs/manual/04-abbreviations/02-navigation-and-listing.md new file mode 100644 index 0000000..eb08003 --- /dev/null +++ b/docs/manual/04-abbreviations/02-navigation-and-listing.md @@ -0,0 +1,6 @@ +--- +title: Navigation and Listing +manTitle: 4.2 NAVIGATION AND LISTING +--- + + diff --git a/docs/manual/04-abbreviations/03-git.md b/docs/manual/04-abbreviations/03-git.md new file mode 100644 index 0000000..10ecdfa --- /dev/null +++ b/docs/manual/04-abbreviations/03-git.md @@ -0,0 +1,6 @@ +--- +title: Git +manTitle: 4.3 GIT +--- + + diff --git a/docs/manual/04-abbreviations/04-terminal-windows-tabs-and-panes.md b/docs/manual/04-abbreviations/04-terminal-windows-tabs-and-panes.md new file mode 100644 index 0000000..a0328b1 --- /dev/null +++ b/docs/manual/04-abbreviations/04-terminal-windows-tabs-and-panes.md @@ -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`. + + diff --git a/docs/manual/04-abbreviations/05-chezmoi.md b/docs/manual/04-abbreviations/05-chezmoi.md new file mode 100644 index 0000000..4171b05 --- /dev/null +++ b/docs/manual/04-abbreviations/05-chezmoi.md @@ -0,0 +1,6 @@ +--- +title: Chezmoi +manTitle: 4.5 CHEZMOI +--- + + diff --git a/docs/manual/04-abbreviations/06-docker.md b/docs/manual/04-abbreviations/06-docker.md new file mode 100644 index 0000000..24e1d56 --- /dev/null +++ b/docs/manual/04-abbreviations/06-docker.md @@ -0,0 +1,6 @@ +--- +title: Docker +manTitle: 4.6 DOCKER +--- + + diff --git a/docs/manual/04-abbreviations/07-systemctl.md b/docs/manual/04-abbreviations/07-systemctl.md new file mode 100644 index 0000000..cf73fc7 --- /dev/null +++ b/docs/manual/04-abbreviations/07-systemctl.md @@ -0,0 +1,6 @@ +--- +title: Systemctl +manTitle: 4.7 SYSTEMCTL +--- + + diff --git a/docs/manual/04-abbreviations/08-ai-assistants.md b/docs/manual/04-abbreviations/08-ai-assistants.md new file mode 100644 index 0000000..aeb4033 --- /dev/null +++ b/docs/manual/04-abbreviations/08-ai-assistants.md @@ -0,0 +1,6 @@ +--- +title: AI Assistants +manTitle: 4.8 AI ASSISTANTS +--- + + diff --git a/docs/manual/04-abbreviations/09-miscellaneous.md b/docs/manual/04-abbreviations/09-miscellaneous.md new file mode 100644 index 0000000..35841c0 --- /dev/null +++ b/docs/manual/04-abbreviations/09-miscellaneous.md @@ -0,0 +1,6 @@ +--- +title: Miscellaneous +manTitle: 4.9 MISCELLANEOUS +--- + + diff --git a/docs/manual/04-abbreviations/10-shell-aliases.md b/docs/manual/04-abbreviations/10-shell-aliases.md new file mode 100644 index 0000000..1aaa833 --- /dev/null +++ b/docs/manual/04-abbreviations/10-shell-aliases.md @@ -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. + + diff --git a/docs/manual/04-abbreviations/11-history-expansion.md b/docs/manual/04-abbreviations/11-history-expansion.md new file mode 100644 index 0000000..60a8a87 --- /dev/null +++ b/docs/manual/04-abbreviations/11-history-expansion.md @@ -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. + + diff --git a/docs/manual/04-abbreviations/index.md b/docs/manual/04-abbreviations/index.md new file mode 100644 index 0000000..ba3a6d9 --- /dev/null +++ b/docs/manual/04-abbreviations/index.md @@ -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. + + + + + + + + + + + + + +