hermes-agent
changed title from Modernize static site generator stack to Modernize static site generator stack (Node 22, updated Metalsmith plugins)2026-11-16 10:40:29 +00:00
The .ignore(['css']) pattern was preventing all CSS files in src/css/
from being copied to the build directory. Only SCSS source files should
be ignored - pre-compiled CSS dependencies like pico.min.css and
zenburn.css need to be served by the static file server.
- Use front-matter title for post slug (not filename)
- Remove /posts/ prefix from URLs to match production
- Remove /pages/ prefix from page URLs to match production
- Fix OG URL on index page (no longer shows .html extension)
- Remove dots from slugs (fixes T.I.L. posts being files not dirs)
- Collapse consecutive dashes in slugs
- Remove / from slug character class (prevents URL paths in slugs)
- Skip index.html in permalink plugin (already has correct path from pagination)
Production URL format: /YYYY-MM-DD-full-title-slug/
- Add <guid> elements to RSS feed (matching <link> URLs)
- Preserve dots in slugs (t.i.l. instead of til) to match production
- URLs now match production format: /YYYY-MM-DD-title-slug/
No /posts/ prefix, with dots preserved for T.I.L. posts
- This ensures feed readers won't mark posts as new
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Changes
Node.js
.nvmrcandDockerfileSass
node-sasswith Dart Sass (sass@^1.108.2).ignore(["css"])to prevent source SCSS files being copied to buildMetalsmith Plugins
Migrated to modern scoped packages:
@metalsmith/markdown(v1.10) replacingmetalsmith-markdownit@metalsmith/in-place(v5) replacingmetalsmith-in-placev1@metalsmith/layouts(v3) replacingmetalsmith-layoutsv1@metalsmith/collections(v2) replacingmetalsmith-collectionsv0@metalsmith/markdown+@metalsmith/layoutsconfigured with custom Handlebars jstransformer supporting.htmltemplatesmetalsmith-paginationfor index page paginationgray-matterfor YAML front matter extractionMarkdown Rendering
markedv18 with GFM supportrole="grid"for accessibilityjstransformer-handlebarsfor template transformsCustom Plugins
plugins/permalinks.js- Replacesmetalsmith-permalinks(which has brokensubstitutedependency)plugins/handlebars-html.js- Custom jstransformer wrapper that supports.htmlfile extensions for Handlebars templatesFeed
metalsmith-feedfeed.xmlwith all 56 postsRouting
filterRoutes.js- Updated regex patterns for Express 4.x compatibilityTemplates
markdown="1"frompicture.htmlandtweet.htmlDocker
node:22-alpineBuild Verification
All build output is in the
build/directory.0f021e9672to7a5c031b1dModernize static site generator stackto Modernize static site generator stack (Node 22, updated Metalsmith plugins)