docs(okf): 53 Obsidian wikilinks become OKF links

`[[page|Label]]` is Obsidian syntax, not OKF. `kb-lint` resolves it Obsidian-style — by
filename, anywhere in the bundle — so it has never tripped the link gate, while every other
consumer of the bundle (an OKF renderer, a Gitea wiki export, `grep` for reachability) sees
bracketed text where a link should be. That is how two generated pages ended up with no
inbound link at all and nobody noticed: the my-first link census of the bundle reported them
as orphans because their only inbound edges were wikilinks.

Mechanical conversion, 52 links across 17 pages, each resolved against the same page set
`kb-lint` uses: an explicit `|Label` is kept verbatim, an unlabelled link takes the target's
frontmatter `title`. Targets are emitted bundle-absolute (`/tools/niri/tips.md`), the form
the spec recommends and the form 99 existing links in this bundle already use.

Two links were `[[index]]`, which resolves by filename to 21 pages — the ambiguity that
filename-resolution invites. Both meant their own directory's index, so both are now written
out in full: `/tools/gitea/index.md`, `/tools/niri/index.md`.

The linter still tolerates wikilinks; whether it should reject them outright is an open
question on #64, because that would replace the two tests pinning today's tolerance.

Refs #64
This commit is contained in:
Frank committed 2026-10-21 02:11:56 -07:00
1 parent 4735702965
commit 62a70caebb
17 files changed
+55 -55

No files matched your search

+6 -6
View File
@@ -178,17 +178,17 @@ The `environment { render-node "/dev/dri/renderD129" }` pin found in the
hybrid; pin kept the iGPU as display owner and sidesteps the suspend/resume
deadlock documented in the sleep-wake investigation). Deploying that base
file on blankpad pins a render node that does not exist — this is why
blankpad runs the `zz-blankpad` override layer (see [[index|the per-host
symlink matrix]]).
blankpad runs the `zz-blankpad` override layer (see [the per-host symlink
matrix](/tools/niri/index.md)).
## Reload
`niri msg action load-config-file` reloads live. Never `SIGHUP` the process
— see [[tips]].
— see [Niri Tips and Gotchas](/tools/niri/tips.md).
## See Also
- [Niri](/tools/niri/index.md) — compositor overview and config layout
- [[tips|tips]] — reload path, `niri msg layers/casts`, includes
- [[noctalia-shell|noctalia-shell]] — notification shown on desk switch
- [[cachyos|cachyos]] — operating system
- [tips](/tools/niri/tips.md) — reload path, `niri msg layers/casts`, includes
- [noctalia-shell](/tools/noctalia-shell.md) — notification shown on desk switch
- [cachyos](/tools/cachyos.md) — operating system
+10 -10
View File
@@ -85,18 +85,18 @@ Column-based scrollable tiling. Columns are cycled with Mod+Left/Right (or Mod+H
| File | Type | Description |
|------|------|-------------|
| [[action-reference|action-reference.md]] | reference | Curated reference of niri actions |
| [[default-bindings|default-bindings.md]] | reference | Default key bindings organized by category |
| [[key-bindings-syntax|key-bindings-syntax.md]] | reference | KDL configuration syntax for key bindings |
| [[tips|tips.md]] | howto | Practical tips for working with niri |
| [[displays|displays.md]] | reference | Desk-profile system: EDID-keyed outputs, hotplug auto-switch, portrait transforms, GPU notes |
| [[keybindings|keybindings.md]] | reference | GENERATED keybinding cheat sheet (scripts/gen-keybinds.sh) |
| [[screenshots|screenshots.md]] | reference | Screenshot bind matrix: flameshot vs niri-native, 2+ output limits, all-monitor capture |
| [action-reference.md](/tools/niri/action-reference.md) | reference | Curated reference of niri actions |
| [default-bindings.md](/tools/niri/default-bindings.md) | reference | Default key bindings organized by category |
| [key-bindings-syntax.md](/tools/niri/key-bindings-syntax.md) | reference | KDL configuration syntax for key bindings |
| [tips.md](/tools/niri/tips.md) | howto | Practical tips for working with niri |
| [displays.md](/tools/niri/displays.md) | reference | Desk-profile system: EDID-keyed outputs, hotplug auto-switch, portrait transforms, GPU notes |
| [keybindings.md](/tools/niri/keybindings.md) | reference | GENERATED keybinding cheat sheet (scripts/gen-keybinds.sh) |
| [screenshots.md](/tools/niri/screenshots.md) | reference | Screenshot bind matrix: flameshot vs niri-native, 2+ output limits, all-monitor capture |
---
## See Also
- [[noctalia-shell|noctalia-shell]] — Desktop shell integration
- [[displays|displays]] — Multi-monitor desk rig configuration
- [[cachyos|cachyos]] — Operating system
- [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell integration
- [displays](/tools/niri/displays.md) — Multi-monitor desk rig configuration
- [cachyos](/tools/cachyos.md) — Operating system
+3 -3
View File
@@ -75,6 +75,6 @@ tr '\0' '\n' < /proc/$(pgrep -x niri | head -1)/environ | grep ^PATH # spawn-s
## See Also
- [[displays|displays.md]] — desk profiles: 1 output portable vs 2 docked
- [[keybindings|keybindings.md]] — generated cheat sheet (source of the binds)
- [[noctalia-shell|noctalia-shell]] — shell settings on Mod+Shift+O
- [displays.md](/tools/niri/displays.md) — desk profiles: 1 output portable vs 2 docked
- [keybindings.md](/tools/niri/keybindings.md) — generated cheat sheet (source of the binds)
- [noctalia-shell](/tools/noctalia-shell.md) — shell settings on Mod+Shift+O