@janga/norna 0.7.26 → 0.7.28

package/schemas/content-frontmatter.schema.json

@@ -6,14 +6,23 @@
       "type": "object",
       "properties": {
         "description": {
-          "description": "Optional page-specific meta description.",
+          "description": "Page description used in metadata, social previews and generated child-page lists.",
           "type": "string",
           "minLength": 1,
-          "markdownDescription": "```yaml\npage:\n  description: About this project.\n```\n\nAn optional page-specific description rendered as `<meta name=\"description\">`. It is not visible in page content.\n\n[Page title and frontmatter reference](https://github.com/janga/norna/blob/v0.7.26/docs/content.md#page-title-and-frontmatter)",
+          "markdownDescription": "```yaml\npage:\n  description: About this project.\n```\n\nA page-specific description used in metadata and social previews. Generated child-page lists can show it beside the page title; it is not inserted into the page body.\n\n[Page title and frontmatter reference (current)](https://janga.github.io/norna/reference/site/metadata/)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/010-site/pages/040-metadata/content.md)",
           "examples": [
             "About this project."
           ]
         },
+        "listChildren": {
+          "description": "Append links to every listed direct child page after this page's authored content.",
+          "type": "boolean",
+          "markdownDescription": "```yaml\npage:\n  listChildren: true\n```\n\nAppend links to every listed direct child page after this page's authored content.\n\n[Read the relevant reference (current)](https://janga.github.io/norna/reference/site/pages/)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/010-site/pages/020-pages/content.md)",
+          "examples": [
+            true,
+            false
+          ]
+        },
         "aliases": {
           "description": "Previous site-relative URLs that permanently identify this page. The current page is always the target.",
           "minItems": 1,
@@ -22,12 +31,12 @@
             "type": "string",
             "pattern": "^\\/(?:[a-z0-9]+(?:-[a-z0-9]+)*\\/)+$",
             "description": "Previous site-relative URL that permanently identifies this page.",
-            "markdownDescription": "```yaml\npage:\n  aliases:\n    - /old-about/\n```\n\nUse a previous Norna page URL. Start and end with `/`; use lowercase ASCII letters, numbers, and single hyphens; do not include the configured base path, a query string, or a fragment.\n\n[Alias path rules](https://github.com/janga/norna/blob/v0.7.26/docs/pages.md#preserve-old-page-urls)",
+            "markdownDescription": "```yaml\npage:\n  aliases:\n    - /old-about/\n```\n\nUse a previous Norna page URL. Start and end with `/`; use lowercase ASCII letters, numbers, and single hyphens; do not include the configured base path, a query string, or a fragment.\n\n[Alias path rules (current)](https://janga.github.io/norna/reference/site/urls/#keep-an-old-url)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/010-site/pages/030-urls/content.md#keep-an-old-url)",
             "examples": [
               "/old-about/"
             ]
           },
-          "markdownDescription": "```yaml\npage:\n  aliases:\n    - /old-about/\n```\n\nLists previous site-relative URLs that permanently identify this page. The page containing the list is always the target. Paths omit the configured base path and are excluded from the sitemap.\n\n[Preserve old page URLs](https://github.com/janga/norna/blob/v0.7.26/docs/pages.md#preserve-old-page-urls)",
+          "markdownDescription": "```yaml\npage:\n  aliases:\n    - /old-about/\n```\n\nLists previous site-relative URLs that permanently identify this page. The page containing the list is always the target. Paths omit the configured base path and are excluded from the sitemap.\n\n[Preserve old page URLs (current)](https://janga.github.io/norna/reference/site/urls/#keep-an-old-url)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/010-site/pages/030-urls/content.md#keep-an-old-url)",
           "examples": [
             [
               "/old-about/"
@@ -37,7 +46,7 @@
       },
       "additionalProperties": false,
       "description": "Optional metadata for this homepage or additional page. The Markdown H1 supplies the page title.",
-      "markdownDescription": "```yaml\npage:\n  description: About this project.\n  aliases:\n    - /old-about/\n```\n\nContains optional metadata for the current homepage or additional page. The Markdown H1 supplies its title. An alias records an old URL for this same page.\n\n[Page title and frontmatter reference](https://github.com/janga/norna/blob/v0.7.26/docs/content.md#page-title-and-frontmatter)"
+      "markdownDescription": "```yaml\npage:\n  description: About this project.\n  aliases:\n    - /old-about/\n```\n\nContains optional metadata for the current homepage or additional page. The Markdown H1 supplies its title. An alias records an old URL for this same page.\n\n[Page title and frontmatter reference (current)](https://janga.github.io/norna/reference/site/metadata/)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/010-site/pages/040-metadata/content.md)"
     },
     "navigation": {
       "description": "Optional navigation metadata for this page.",
@@ -47,7 +56,7 @@
           "default": true,
           "description": "List this page in site navigation. The page remains public when false.",
           "type": "boolean",
-          "markdownDescription": "```yaml\nnavigation:\n  listed: false\n```\n\nList this page in site navigation. The page remains public when false.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.26/docs/pages.md#navigation)",
+          "markdownDescription": "```yaml\nnavigation:\n  listed: false\n```\n\nList this page in site navigation. The page remains public when false.\n\n[Read the relevant reference (current)](https://janga.github.io/norna/reference/configuration/navigation/)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/020-configuration/pages/030-navigation/content.md)",
           "examples": [
             true,
             false
@@ -55,12 +64,12 @@
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "```yaml\nnavigation:\n  listed: false\n```\n\nOptionally excludes an additional page from site navigation without removing its public URL.\n\n[Site navigation reference](https://github.com/janga/norna/blob/v0.7.26/docs/pages.md#navigation)"
+      "markdownDescription": "```yaml\nnavigation:\n  listed: false\n```\n\nOptionally excludes an additional page from site navigation without removing its public URL.\n\n[Site navigation reference (current)](https://janga.github.io/norna/reference/configuration/navigation/)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/020-configuration/pages/030-navigation/content.md)"
     }
   },
   "additionalProperties": false,
   "description": "Frontmatter for a homepage or additional page content.md file.",
   "$id": "https://janga.github.io/norna/schemas/content-frontmatter.schema.json",
   "title": "Norna page frontmatter",
-  "markdownDescription": "```yaml\n---\npage:\n  description: About this project.\n---\n```\n\nContent frontmatter is optional. Write the page title as the single Markdown H1; use frontmatter only for optional metadata or navigation settings.\n\n[Page title and frontmatter reference](https://github.com/janga/norna/blob/v0.7.26/docs/content.md#page-title-and-frontmatter)"
+  "markdownDescription": "```yaml\n---\npage:\n  description: About this project.\n---\n```\n\nContent frontmatter is optional. Write the page title as the single Markdown H1; use frontmatter only for optional metadata or navigation settings.\n\n[Page title and frontmatter reference (current)](https://janga.github.io/norna/reference/site/metadata/)\n\n[Norna 0.7.28 source reference](https://github.com/janga/norna/blob/v0.7.28/site/root/pages/032-reference/pages/010-site/pages/040-metadata/content.md)"
 }

package/schemas/manifest.json

@@ -1,17 +1,63 @@
 {
-  "editorApiVersion": 2,
-  "schemaVersion": 3,
+  "editorApiVersion": 3,
+  "schemaVersion": 6,
+  "sourceFiles": [
+    {
+      "name": "settings.yaml",
+      "location": "site-config",
+      "schemaKind": "config",
+      "required": true,
+      "input": "url",
+      "description": "Required public URL and technical site settings."
+    },
+    {
+      "name": "shared-content.yaml",
+      "location": "site-config",
+      "schemaKind": "sitewideContent",
+      "text": "banners: []\n",
+      "description": "Shared notices and footer content for the complete site.",
+      "removalEffect": "Shared notices, authored footer content and logo display settings in this file will be removed from the whole site."
+    },
+    {
+      "name": "content.md",
+      "location": "page",
+      "schemaKind": "contentFrontmatter",
+      "required": true,
+      "input": "title",
+      "description": "Required page content."
+    },
+    {
+      "name": "tree-theme.yaml",
+      "location": "page",
+      "schemaKind": "theme",
+      "rootSchemaKind": "rootTheme",
+      "required": "root",
+      "rootText": "preset: documentation\n",
+      "text": "# Modify inherited settings. Add preset only to replace the complete base.\n{}\n",
+      "description": "Visual settings for this page and its descendants. Without preset, modifies inherited values; preset selects a new base. Required on the root page.",
+      "removalEffect": "This branch resumes the ancestor tree theme. Overrides on descendants remain; a descendant preset starts an independent base."
+    },
+    {
+      "name": "page-theme.yaml",
+      "location": "page",
+      "schemaKind": "pageTheme",
+      "text": "# Modify this page only. Add preset only to replace the complete base.\n{}\n",
+      "description": "Visual settings for this page only. Without preset, modifies its tree theme; preset selects a new base. Descendants keep their tree theme.",
+      "removalEffect": "This page will use its selected tree theme again. Other pages are unchanged."
+    }
+  ],
+  "pageDirectoryPattern": "^(?!000-)(\\d{3})-([a-z0-9]+(?:-[a-z0-9]+)*)$",
   "blockSchemas": {
     "image-stack": "image-stack.schema.json",
     "image-carousel": "image-carousel.schema.json",
     "card-list": "card-list.schema.json"
   },
   "files": {
-    "category": "category.schema.json",
     "config": "config.schema.json",
     "contentFrontmatter": "content-frontmatter.schema.json",
     "sitewideContent": "sitewide-content.schema.json",
     "theme": "theme.schema.json",
+    "rootTheme": "root-theme.schema.json",
     "pageTheme": "page-theme.schema.json"
   }
 }