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.
26 lines
771 B
Markdown
26 lines
771 B
Markdown
---
|
|
title: Path Setup
|
|
manTitle: 2. PATH SETUP
|
|
sidebar:
|
|
order: 6
|
|
helpKeywords:
|
|
- 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.
|
|
|
|
---
|