nibula 2.2.0 → 2.2.2

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to Nibula are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.2] - 2026-08-19
+
+### Fixed
+- The commented `renderFile` example in the page template now passes `"md"` as
+  the format argument. Without it Eleventy also ran the file through Nunjucks, so
+  a `.md` containing template syntax — a code sample with `{{ }}` or `{% %}` in
+  it — broke the build instead of rendering as text.
+
+## [2.2.1] - 2026-08-18
+
+### Fixed
+- Renaming a page left the old `title` in the route's front matter. Only
+  `permalink` was rewritten, so a page renamed from `about` to `company` kept
+  `title: "about"` while its stylesheet, script and `pages.json` record had all
+  moved to `company`. The title is what the layout uses to load a page's CSS and
+  JS and to look up its SEO record, so the renamed page silently lost its styles,
+  its scripts and everything set under its `pages.json` entry.
+
+### Notes
+- Pages renamed with an earlier version keep the stale title. Open the route in
+  `src/frontend/routes/` and set `title` to the camelCase form of the new page
+  name — `company-profile` becomes `companyProfile`.
+
 ## [2.2.0] - 2026-08-18
 
 ### Added

package/docs/Components.md

@@ -13,8 +13,6 @@ src/frontend/components/
 ├── global/
 │   ├── header.njk
 │   └── footer.njk
-├── modals/
-│   └── privacyModal.njk
 ├── not-found.njk
 ├── welcome.njk
 ```
@@ -88,7 +86,7 @@ Open the page's file in `src/frontend/routes/` and add this line to its body:
 
 ```html
 <article class="markdown-body">
-    {% renderFile "article.md" | markdownPath, { site: site } %}
+    {% renderFile "article.md" | markdownPath, { site: site }, "md" %}
 </article>
 ```
 
@@ -100,6 +98,7 @@ Four parts to it:
 | `renderFile` | turns the Markdown into HTML and puts it in the page |
 | `markdownPath` | fills in the `src/frontend/components/` part of the path for you |
 | `{ site: site }` | hands the file your site settings — see below |
+| `"md"` | specifies that the rendering should be done as Markdown, ignoring the njk engine associated by default with the file extension |
 
 Subfolders work the same way as with components:
 `"legal/privacy.md" | markdownPath`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nibula",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "A beginner-friendly static site generator built on Eleventy that stays close to vanilla HTML, CSS and JS — with a page-management CLI, an optional PHP backend, and SEO files generated for you.",
   "keywords": [
     "11ty",

package/src/frontend/routes/404.njk

@@ -10,6 +10,6 @@ layout: base.njk
 {# Markdown files live in components/ too. Pass the data the file needs #}
 {#
 <article class="markdown-body">
-    {% renderFile "your-file.md" | markdownPath, { site: site } %}
+    {% renderFile "your-file.md" | markdownPath, { site: site }, "md" %}
 </article>
 #}

package/src/frontend/routes/index.njk

@@ -10,6 +10,6 @@ layout: base.njk
 {# Markdown files live in components/ too. Pass the data the file needs #}
 {#
 <article class="markdown-body">
-    {% renderFile "your-file.md" | markdownPath, { site: site } %}
+    {% renderFile "your-file.md" | markdownPath, { site: site }, "md" %}
 </article>
 #}

package/tools/lib/pageActions.js

@@ -15,7 +15,7 @@ const FRONT_MATTER_PATTERNS = Object.freeze({
 });
 
 const ROUTE_FRONT_MATTER_KEYS = ['title', 'permalink'];
-const RENAME_FRONT_MATTER_KEYS = ['permalink'];
+const RENAME_FRONT_MATTER_KEYS = ['title', 'permalink'];
 const LAYOUT_KEY = 'layout';
 
 function templatePath(name) {

package/tools/res/templates/template.njk

@@ -10,6 +10,6 @@ layout: base.njk
 {# Markdown files live in components/ too. Pass the data the file needs #}
 {# 
 <article class="markdown-body">
-    {% renderFile "your-file.md" | markdownPath, { site: site } %}
+    {% renderFile "your-file.md" | markdownPath, { site: site }, "md" %}
 </article>
 #}