docs: move Viewing This Manual to last position (§11)

Reorder sections so Installation (§9) and Personalization (§10) precede Viewing This Manual (§11). Update TABLE OF CONTENTS and regenerate wiki; old 9-viewing-this-manual.md replaced by 11-viewing-this-manual.md.
2026-06-08 16:48:37 -04:00
parent 345d0086a5
commit f444bfa464
13 changed files with 261 additions and 101 deletions
@@ -0,0 +1,68 @@
+# 11. VIEWING THIS MANUAL
+
+**Sections:** [Index](index.md) | [1. Configuration Variables](1-configuration-variables.md) | [2. Path Setup](2-path-setup.md) | [3. Key Bindings](3-key-bindings.md) | [4. Abbreviations](4-abbreviations.md) | [5. Functions Reference](5-functions-reference.md) | [6. Dependency Catalog](6-dependency-catalog.md) | [7. Customization](7-customization.md) | [8. Fisher Plugins](8-fisher-plugins.md) | [9. Installation](9-installation.md) | [10. Personalization](10-personalization.md) | **11. Viewing This Manual**
+
+---
+
+## With ov (recommended)
+
+    help config
+
+ov renders the Markdown with syntax highlighting and section-based
+navigation.
+
+    Space       next section
+    ^           previous section
+    Alt+u       toggle section list sidebar
+    /           search forward
+    n / N       next / previous search match
+    g           go to line number
+    j           interactive jump target (line, %, or 'section')
+    q           quit
+
+## With bat
+
+    bat --language=markdown --paging=always ~/.config/fish/docs/fish-config.md
+
+## As a man page
+
+    config-help --man
+
+Opens the compiled docs/fish-config.1 directly via man -l, bypassing
+the pager fallback chain. The symlink and MANPATH are also configured
+automatically on shell start for the standard invocation:
+
+    man fish-config
+
+NOTE: fish-config (hyphen) is this config's man page. fish_config
+(underscore) is fish's built-in browser-based configuration tool —
+a completely separate command. Do not mix them up.
+
+## In the browser (HTML)
+
+    config-help --html
+
+Opens docs/html/index.html in the default web browser. Browser detection
+queries the system's x-scheme-handler/https MIME entry (via xdg-mime) to
+find the real browser binary, then falls back through known browser
+binaries (firefox, chromium, vivaldi, etc.), and finally xdg-open as a
+last resort. Set $fish_help_browser or $BROWSER to override.
+
+## As a wiki
+
+The generated Markdown wiki lives in docs/wiki/. index.md provides the
+project overview and a full table of contents. Each section page has a
+navigation bar at the top linking to every other section.
+
+The wiki is auto-generated from this file by the CI pipeline on every
+push to main that changes docs/fish-config.md.
+
+## Jumping to a section
+
+    help config keybindings
+    help config abbreviations
+    help config pkg
+    help config logs
+    help config fish-deps
+
+The keyword is matched case-insensitively against section headings.