@janga/norna 0.7.26 → 0.7.27

package/README.md

@@ -73,7 +73,7 @@ site/
   presentation settings and nested entries under its own `pages/` directory.
 - Category ids remain in child URLs. Opening a category URL leads to its first
   listed direct page or a generated child list; see
-  [Category destinations](docs/pages.md#opening-a-category-url).
+  [Category destinations](https://janga.github.io/norna/reference/site/pages/#opening-a-category-url).
 - `theme.yaml` normally selects one complete visual preset.
 - `sitewide-content.yaml` holds shared logo display settings, banners, and
   footer content.
@@ -134,24 +134,31 @@ components, and rendering logic.
 
 GitHub CLI and Playwright are needed only for specific deploy helpers and
 engine diagnostics, not for ordinary editing and local preview. See
-[Requirements and limitations](docs/requirements.md) for the exact boundaries.
+[Requirements and limitations](https://janga.github.io/norna/reference/site/requirements/) for the exact boundaries.
 
 ## Documentation
 
 - [Getting Started](https://janga.github.io/norna/getting-started/install-norna/)
-- [Site files](docs/site-files.md)
-- [Upgrading an existing site](docs/upgrading.md)
-- [Task-oriented documentation map](docs/README.md)
-- [Common workflows](docs/README.md#common-workflows)
-- [Explanation and JavaScript boundaries](docs/README.md#explanation)
-- [Command and platform reference](docs/README.md#command-and-platform-reference)
-- [Troubleshooting](docs/README.md#troubleshooting)
+- [Site files](https://janga.github.io/norna/reference/site/files/)
+- [Upgrading an existing site](https://janga.github.io/norna/reference/workflows/upgrading/)
+- [Complete reference](https://janga.github.io/norna/reference/)
+- [Working on a site](https://janga.github.io/norna/reference/workflows/)
+- [JavaScript and accessibility](https://janga.github.io/norna/reference/reader/accessibility/)
+- [Commands](https://janga.github.io/norna/reference/commands/invocation/)
+- [Troubleshooting](https://janga.github.io/norna/faq/installation/)
 - [AI-readable documentation index](https://janga.github.io/norna/llms.txt)
 
 Engine contributors should start with
 [Engine Development](docs/engine-development.md). Planning and future work are
 tracked in [BACKLOG.md](BACKLOG.md).
 
+The user reference is authored once under `site/pages/032-reference/` and
+rendered on the documentation site. It describes current development; use the
+installed release's Git tag when checking older behavior. Tags through 0.7.26
+keep their reference under `docs/`; later tags use the documentation page tree.
+The [contributor documentation](docs/README.md) explains maintenance and version
+selection.
+
 ## Support And License
 
 Use the [issue tracker](https://github.com/janga/norna/issues) for reproducible

package/bin/norna-cli.mjs

@@ -23,14 +23,14 @@ Commands:
   theme:export           Export a commented theme preset reference
   typography profiles    Show built-in typography profile values
   typography show        Show resolved typography for the selected site
-  site:public            Sync site/public/ to public/
+  site:public            Sync static files to the selected site's .norna/public/
   images                 Generate optimized image variants
   engine:update          Update @janga/norna in a site repository
   engine:version         Show installed engine and Astro versions
   init                   Create a new site project from the starter
   page:add               Add a page to the site page tree
   page:move              Move a page subtree and update internal links
-  category:add           Add a non-routable category to the site page tree
+  category:add           Add a navigation group without an authored page body
   migrate:check          Audit a Docusaurus project without modifying it
   build                  Build the selected site
   build:local            Build and restart local dev server

package/package.json

@@ -2,7 +2,7 @@
   "name": "@janga/norna",
   "description": "An opinionated CLI for building responsive websites from Markdown, images, and theme presets.",
   "type": "module",
-  "version": "0.7.26",
+  "version": "0.7.27",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",

package/schemas/category.schema.json

@@ -5,16 +5,16 @@
     "label": {
       "type": "string",
       "minLength": 1,
-      "description": "Navigation label for this non-routable page category.",
-      "markdownDescription": "```yaml\nlabel: Guides\n```\n\nThe category label shown in global navigation, tree navigation, mobile navigation, and breadcrumbs.\n\n[Navigation category reference](https://github.com/janga/norna/blob/v0.7.26/docs/pages.md#navigation-categories)"
+      "description": "Navigation label for a group of child pages without an authored page body.",
+      "markdownDescription": "```yaml\nlabel: Guides\n```\n\nThe category label shown in global navigation, tree navigation, mobile navigation, and breadcrumbs.\n\n[Navigation category reference (current)](https://janga.github.io/norna/reference/site/pages/#page-or-category)\n\n[Norna 0.7.27 source reference](https://github.com/janga/norna/blob/v0.7.27/site/pages/032-reference/pages/010-site/pages/020-pages/content.md#page-or-category)"
     }
   },
   "required": [
     "label"
   ],
   "additionalProperties": false,
-  "description": "A non-routable navigation category containing child pages.",
+  "description": "A navigation group without an authored page body. Opening its URL redirects when its first listed direct child is a page; otherwise it shows a generated child list.",
   "$id": "https://janga.github.io/norna/schemas/category.schema.json",
   "title": "Norna page category",
-  "markdownDescription": "```yaml\nlabel: Guides\n```\n\n`category.yaml` groups child pages without editorial content. Its URL opens the first listed direct page, or a generated child list when the first child is a category.\n\n[Navigation category reference](https://github.com/janga/norna/blob/v0.7.26/docs/pages.md#navigation-categories)"
+  "markdownDescription": "```yaml\nlabel: Guides\n```\n\n`category.yaml` groups child pages without editorial content. Its URL opens the first listed direct page, or a generated child list when the first child is a category.\n\n[Navigation category reference (current)](https://janga.github.io/norna/reference/site/pages/#page-or-category)\n\n[Norna 0.7.27 source reference](https://github.com/janga/norna/blob/v0.7.27/site/pages/032-reference/pages/010-site/pages/020-pages/content.md#page-or-category)"
 }