From 8b9bd248fd7263c5c1ee0df57e3101bac0e5b1ab Mon Sep 17 00:00:00 2001 From: Gitea Actions Date: Fri, 12 Jun 2026 04:58:11 +0000 Subject: [PATCH] chore(docs): regenerate man page, HTML docs, and wiki --- docs/fish-config.1 | 47 ++++++++++++++++++++++++-- docs/html/10-6-dependency-catalog.html | 2 +- docs/html/11-7-customization.html | 29 ++++++++++++++-- docs/html/index.html | 2 ++ docs/html/sitemap.json | 2 +- docs/wiki/6-dependency-catalog.md | 2 +- docs/wiki/7-customization.md | 32 +++++++++++++++++- 7 files changed, 107 insertions(+), 9 deletions(-) diff --git a/docs/fish-config.1 b/docs/fish-config.1 index 05ce0c3..70624ba 100644 --- a/docs/fish-config.1 +++ b/docs/fish-config.1 @@ -1754,7 +1754,7 @@ cargo Rust toolchain (via rustup); used by fish-deps to install Rust-based tools and to build fish from source. All paths are gated on type -q cargo and degrade gracefully. starship Cross-shell prompt; loaded via type -q starship guard. - Without it fish falls back to its built-in default prompt. + Without it the Catppuccin nim-style fallback prompt activates. uv Python package and project manager (Astral); used by the fish-from-source build path in fish-deps. All consumers degrade gracefully without it. @@ -2019,7 +2019,7 @@ Puffer key intercepts . ! $ * keys intercepted for smart expansion Starship prompt fish_prompt replaced by Starship + OSC 133 markers Catppuccin colors 30+ fish_color_* variables set to Mocha palette FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors -Right prompt fish_right_prompt: Docker context + timestamp +Right prompt fish_right_prompt: exit code (on failure) + dim timestamp; always rendered; Docker context added when starship+C3 active \f[R] .fi .PP @@ -2145,6 +2145,49 @@ This allows ov to use them as sticky section headers when browsing scrollback logs. Without Starship, fish\[cq]s built-in prompt handles these markers automatically. +.SS Catppuccin Fallback Prompt +.PP +When Starship is absent or C3 overrides are disabled, a built-in +nim-style two-line prompt activates from functions/fish_prompt.fish. +No external dependencies \[em] fish builtins only. +.PP +Layout: +.IP +.nf +\f[C] +┬─[user\[at]host:\[ti]/path] (main) +╰─>$ +\f[R] +.fi +.PP +Elements: +.IP +.nf +\f[C] +user Yellow (Catppuccin Yellow); red if root +\[at]host Blue (local) or Teal (SSH) +\[ti]/path prompt_pwd abbreviation (Catppuccin Text) +(main) Current git branch in Catppuccin Pink; omitted outside repos +─[V:name] Active Python venv basename; omitted when none +─[N/I/R/V] Vi-mode indicator when vi bindings are active +┬─ / ╰─> Connector lines: Catppuccin Green on success, Red on failure +\f[R] +.fi +.PP +The right prompt (fish_right_prompt.fish) always renders, regardless of +C3 state. +On failure it shows a red ✘ and the exit code; on success it shows only +the dim timestamp. +When starship is installed and C3 is enabled, the active Docker context +is also shown (if non-default): +.IP +.nf +\f[C] +✘ 1 󰡨 myctx Fri Jun 12 00:51:21 2026 ← failed, starship+C3 active +✘ 1 Fri Jun 12 00:51:21 2026 ← failed, fallback prompt +Fri Jun 12 00:51:21 2026 ← success (no ✘) +\f[R] +.fi .SS FZF .PP FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in diff --git a/docs/html/10-6-dependency-catalog.html b/docs/html/10-6-dependency-catalog.html index c0085c8..dc40fb9 100644 --- a/docs/html/10-6-dependency-catalog.html +++ b/docs/html/10-6-dependency-catalog.html @@ -504,7 +504,7 @@ tailscale Mesh VPN client Rust-based tools and to build fish from source. All paths are gated on type -q cargo and degrade gracefully. starship Cross-shell prompt; loaded via type -q starship guard. - Without it fish falls back to its built-in default prompt. + Without it the Catppuccin nim-style fallback prompt activates. uv Python package and project manager (Astral); used by the fish-from-source build path in fish-deps. All consumers degrade gracefully without it. diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html index 20d703d..fb4f1a5 100644 --- a/docs/html/11-7-customization.html +++ b/docs/html/11-7-customization.html @@ -659,7 +659,7 @@ Puffer key intercepts . ! $ * keys intercepted for smart expansion Starship prompt fish_prompt replaced by Starship + OSC 133 markers Catppuccin colors 30+ fish_color_* variables set to Mocha palette FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors -Right prompt fish_right_prompt: Docker context + timestamp +Right prompt fish_right_prompt: exit code (on failure) + dim timestamp; always rendered; Docker context added when starship+C3 active

The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish, and six expand_bang_*.fish functions. All are gated together — disabling C3 removes the entire bang-expansion system at once.

@@ -749,14 +749,37 @@ immediately after, placing both markers on the prompt line itself. This allows ov to use them as sticky section headers when browsing scrollback logs. Without Starship, fish's built-in prompt handles these markers automatically.

-

FZF

+

Catppuccin +Fallback Prompt

+

When Starship is absent or C3 overrides are disabled, a built-in +nim-style two-line prompt activates from functions/fish_prompt.fish. No +external dependencies — fish builtins only.

+

Layout:

+
┬─[user@host:~/path] (main)
+╰─>$
+

Elements:

+
user        Yellow (Catppuccin Yellow); red if root
+@host       Blue (local) or Teal (SSH)
+~/path      prompt_pwd abbreviation (Catppuccin Text)
+(main)      Current git branch in Catppuccin Pink; omitted outside repos
+─[V:name]   Active Python venv basename; omitted when none
+─[N/I/R/V]  Vi-mode indicator when vi bindings are active
+┬─ / ╰─>    Connector lines: Catppuccin Green on success, Red on failure
+

The right prompt (fish_right_prompt.fish) always renders, regardless +of C3 state. On failure it shows a red ✘ and the exit code; on success +it shows only the dim timestamp. When starship is installed and C3 is +enabled, the active Docker context is also shown (if non-default):

+
✘ 1   󰡨 myctx   Fri Jun 12 00:51:21 2026     ← failed, starship+C3 active
+✘ 1   Fri Jun 12 00:51:21 2026               ← failed, fallback prompt
+Fri Jun 12 00:51:21 2026                     ← success (no ✘)
+

FZF

FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in integrations/fzf.fish. The colors applied:

Background:   #1E1E2E (base)    #313244 (surface0)
 Foreground:   #CDD6F4 (text)
 Highlights:   #F38BA8 (red)     #CBA6F7 (mauve)    #B4BEFE (lavender)

To customize, override FZF_DEFAULT_OPTS in local.fish.

-

Catppuccin Mocha Syntax Highlighting

The Catppuccin Mocha theme ships with this config in themes/ and is diff --git a/docs/html/index.html b/docs/html/index.html index 2c7577b..5e64ffb 100644 --- a/docs/html/index.html +++ b/docs/html/index.html @@ -834,6 +834,8 @@ id="toc-prompt-and-theme">Prompt and Theme