chore(docs): regenerate man page, HTML docs, and wiki

This commit is contained in:
Gitea Actions
2026-06-10 15:43:37 +00:00
parent 6d15701ad4
commit f9ba0e20ea
7 changed files with 196 additions and 5 deletions
+56 -4
View File
@@ -515,8 +515,60 @@ Variables</h2>
<p>Some settings (fzf colors, theme) are stored in fish_variables via
<code>set -U</code>. These are machine-local and git-ignored. Do not
commit fish_variables.</p>
<h2 data-number="11.5" id="prompt-and-theme">Prompt and Theme</h2>
<h3 data-number="11.5.1" id="starship">Starship</h3>
<h2 data-number="11.5"
id="opinionated-components-minimal-mode">Opinionated Components (Minimal
Mode)</h2>
<p>Every opinionated piece of this config is active by default but can
be switched off through four category opt-out variables, each evaluated
via __fish_variable_check. Set a variable to any falsy value (0, false,
no, off, n) to disable its category; erase it or set a truthy value (1,
true, yes, on, y) to re-enable. Unset means enabled.</p>
<pre><code>Variable Disables
------------------------------ ------------------------------------
__fish_config_op_aliases Command shadows and flag injection:
ls-&gt;eza, cat-&gt;bat, cd-&gt;zoxide,
rm-&gt;trash, less-&gt;ov, top-&gt;btop,
ping-&gt;prettyping, ssh-&gt;kitten,
du-&gt;duf/dust, mkdir/bash wrappers,
history timestamps, grep/cp/mv/wget
flag injection, help intercept
__fish_config_op_autoexec Startup side-effects: Fisher
bootstrap, theme apply, paru/yay
wrapper generation, auto venv
activation, WakaTime hook
__fish_config_op_overrides Key and env overrides: Vi mode,
exit-&gt;smart_exit, PAGER/MANPAGER,
CDPATH, bang-bang system, autopair,
puffer, starship prompt, theme
colors, FZF_DEFAULT_OPTS, right
prompt
__fish_config_op_integrations Terminal/tool coupling: Kitty/
WezTerm window abbreviations, done
notifications, spwin/tab/split,
hist, logs, upgrade, WakaTime</code></pre>
<p>Examples:</p>
<pre><code># Disable command shadows only (rm becomes plain rm again):
set -U __fish_config_op_aliases off
# Full minimal mode — disable all four categories at once:
set -U __fish_config_opinionated 0
# Re-enable everything:
set -Ue __fish_config_opinionated</code></pre>
<p>Notes:</p>
<ul>
<li>Command shadows (rm, cat, ls, ...) react immediately; conf.d-level
components (bindings, prompt, abbreviations, hooks) take effect in new
shells.</li>
<li>With aliases disabled, rm falls back to bare <code>command rm</code>
— files are deleted permanently, not trashed.</li>
<li>Disabled integration commands (spwin, tab, split, hist, logs,
upgrade) print an error naming the variable that disabled them.</li>
<li>On CachyOS, the distro fish config's own aliases, history override,
and bang-bang bindings are stripped per category as well.</li>
</ul>
<h2 data-number="11.6" id="prompt-and-theme">Prompt and Theme</h2>
<h3 data-number="11.6.1" id="starship">Starship</h3>
<p>The primary prompt is Starship, initialized by conf.d/starship.fish.
Configure it via ~/.config/starship.toml.</p>
<p>conf.d/starship.fish defines a fish_prompt wrapper that only
@@ -526,14 +578,14 @@ 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.</p>
<h3 data-number="11.5.2" id="fzf">FZF</h3>
<h3 data-number="11.6.2" id="fzf">FZF</h3>
<p>FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in
integrations/fzf.fish. The colors applied:</p>
<pre><code>Background: #1E1E2E (base) #313244 (surface0)
Foreground: #CDD6F4 (text)
Highlights: #F38BA8 (red) #CBA6F7 (mauve) #B4BEFE (lavender)</code></pre>
<p>To customize, override FZF_DEFAULT_OPTS in local.fish.</p>
<h3 data-number="11.5.3"
<h3 data-number="11.6.3"
id="catppuccin-mocha-syntax-highlighting">Catppuccin Mocha Syntax
Highlighting</h3>
<p>The Catppuccin Mocha theme ships with this config in themes/ and is