Minerva Publish

Easy, minimalist approach to publishing markdown as static site content for magazine and blog sites.

⚠️ Documentation TODO

This README is badly out of date — Minerva gained a lot of capability (≈ v0.20.x) that is not documented anywhere yet. Before publishing/sharing, write real docs covering:

• Folder-scoped lists / feeds — folder: now filters the source set (only pages under content/<folder>/), not just the output directory. Backward-compatible: omit folder to include everything. (selectPages in file.ts is the single source of truth for folder + property/key category + order + skip/limit.)
• collections: config — named, Eleventy-style collections exposed to every template as collections.<name> (collection.ts).
• Per-file permalink frontmatter + the includeFoldersInURL / includeExtension URL options, all unified in structure.ts (getOutputPath / getOutputLink); the view's on-disk path and the template link always agree.
• output.trailingSlash — emit pretty name/index.html so URLs end in a slash; the template link (and every canonical/OG/sitemap/RSS URL derived from it) carries it. Defaults off.
• output.linkifyBareUrls — opt-in markdown-it "fuzzy" auto-linking of bare domains in prose (example.com → <a>). Defaults off, so a domain typed in body text stays plain text; explicit [text](url) links and full http(s):// URLs always linkify.
• sections: data cascade — per-folder frontmatter defaults merged beneath each file's own frontmatter (globals < section < frontmatter).
• Per-section view layouts — view.templates can hold multiple templates; a page's layout (frontmatter or section default) selects which one renders it.
• link in static/list contexts — static pages and list/index pages now receive their own link, so layouts can emit canonical/OG tags for them (added v0.20.2).
• --watch / -w — rebuild-on-change dev mode (watches source, the layout dir, and every configured assets dir; debounced). Pipeline is now fully async/awaited, and copy() awaits all asset copies (no clean()-vs-copy race under watch).
• Page store keyed by relative path (not datePublished) so two posts sharing a timestamp can't silently collide.
• Correctness fixes to document/note: get/getOne helpers, feed maxItems applied after filtering, RFC-822 RSS dates.
• Test suite exists now (npm test → mocha + nyc; fixtures under test/fixtures/).
• Depends on @kung-fu/moneta ^2.1.0 (its where operators / dot-path keys are used by the query layer).

Credits

slash() method retrieved from https://github.com/sindresorhus/slash