fish-config/docs/manual/02-path-setup.md at fe59a7c22c0894663d0e7bb8e03666c82d069254

Files

T

feat(docs): generate fish-config.md from the manual tree

Adds docs/build-manual.py (--concat) and a round-trip test in
verify-manual.py that reproduces the pre-migration fish-config.md
exactly from docs/manual/.

Fixes found by the round-trip check, applied in split-manual.py and
re-run to regenerate docs/manual/:
- NAME/SYNOPSIS/TABLE OF CONTENTS had no sidebar.order, so they sorted
  after every numbered section instead of interleaving with DESCRIPTION
  in original document order. All manual pages now get sidebar.order
  from a single position counter matching source order.
- split_h1/split_h2 used .strip() on section bodies, which also ate
  leading indentation on the first body line, corrupting the 4-space
  indented code blocks that open SYNOPSIS and TABLE OF CONTENTS.
- The source's leading pandoc metadata block (title/section/header/
  date/author) was discarded entirely by the splitter. It's now parsed
  off via manualtools.parse and stashed on index.md under a "pandoc"
  key; build-manual.py re-emits it verbatim ahead of the first heading.

2026-07-25 21:39:48 -04:00

771 B

Raw Blame History

title, manTitle, sidebar, helpKeywords

title

manTitle

sidebar

helpKeywords

Path Setup

2. PATH SETUP

order
6

path

Directories prepended to PATH in this order (first wins):

~/.local/bin              Standard user-local executables
~/Applications            User-installed standalone apps
~/scripts                 Personal shell scripts
~/bin                     Cargo binaries (appended — lowest priority)
$BUN_INSTALL/bin          Bun runtime and global packages
$NPM_CONFIG_PREFIX/bin    Global npm packages
~/.lmstudio/bin           LM Studio CLI
~/.resend/bin             Resend CLI
~/.fzf/bin                fzf binary (git-installed)

Cargo binaries are intentionally appended (lowest priority) to avoid shadowing system-installed Rust tools.

771 B Raw Blame History

771 B

Raw Blame History