summaryrefslogtreecommitdiffstats
path: root/doc/build-aux/pandoc-filters
AgeCommit message (Collapse)Author
2023-01-10doc/filters: fix myst-reader role detectionpennae
matching on only `{...}` does not trigger if the role tag is preceded by something usually considered a semantic separator that isn't a separator as markdown knows it, e.g. punctuation characters.
2023-01-02doc: separate manpage URLs from the Pandoc filterNaïm Favier
Move the manpage-to-URL mapping to `doc/manpage-urls.json` so that we can reuse that file elsewhere, and generate the `link-manpages.lua` filter from that file. Also modify the Pandoc filter so that it doesn't wrap manpages that are already inside a link. Keeping a Lua filter is essential for speed: a Python filter would increase the runtime `md-to-db.sh` from ~20s to ~30s (but Python is not to blame; marshalling Pandoc types to and from JSON is a costly operation). Parsing in Lua seems tedious, so I went with the Nix way.
2022-12-22doc/link-unix-man-references: add a bunch of systemd pagesNaïm Favier
2022-10-26nixos/doc/manual/md-to-db.sh: Add support for <kbd> elementJan Tojnar
2022-08-31nixos/make-options-doc: add inline roles for varname/envarpennae
both of these render distinctly from plain literals in the manpage, and manpages even semantically distinguish between the two.
2022-06-12treewide: attempt at markdown option docspennae
2021-12-28doc: remove reference to unix-man-urls.luaNaïm Favier
2021-07-13doc: Linkify man page referencesJan Tojnar
2021-07-13doc: Add support for MyST rolesJan Tojnar
Officially, only the manpage role is supported at the moment. Unlike in rST, the syntax uses braces instead of colons: {manpage}`nix.conf(5)`
2021-07-12doc: comment lua scriptsJan Tojnar
2021-07-12doc: Move lua filters to subdirectoryJan Tojnar