@janga/norna 0.7.17 → 0.7.22

package/schemas/page-theme.schema.json

@@ -0,0 +1,192 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "layout": {
+      "type": "object",
+      "properties": {
+        "contentSpacing": {
+          "description": "Page content spacing. Descendant pages inherit this value.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "compact",
+              "title": "Compact",
+              "description": "Use restrained spacing between sections and structured blocks."
+            },
+            {
+              "const": "normal",
+              "title": "Normal",
+              "description": "Use balanced content spacing."
+            },
+            {
+              "const": "spacious",
+              "title": "Spacious",
+              "description": "Use more expansive spacing between sections and structured blocks."
+            }
+          ],
+          "markdownDescription": "```yaml\nlayout:\n  contentSpacing: compact\n```\n\nPage content spacing. Descendant pages inherit this value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#page-themes)",
+          "examples": [
+            "compact",
+            "normal",
+            "spacious"
+          ]
+        },
+        "textWidth": {
+          "description": "Body-text line length. Descendant pages inherit this value.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "narrow",
+              "title": "Narrow",
+              "description": "Use a shorter line length suited to reading-focused text."
+            },
+            {
+              "const": "normal",
+              "title": "Normal",
+              "description": "Use the balanced default line length."
+            },
+            {
+              "const": "wide",
+              "title": "Wide",
+              "description": "Allow body text to use more horizontal space."
+            }
+          ],
+          "markdownDescription": "```yaml\nlayout:\n  textWidth: narrow\n```\n\nBody-text line length. Descendant pages inherit this value.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#page-themes)",
+          "examples": [
+            "narrow",
+            "normal",
+            "wide"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Page-local layout settings inherited by descendant pages.",
+      "markdownDescription": "```yaml\nlayout:\n  textWidth: narrow\n  contentSpacing: compact\n```\n\nAdjusts body-text line length and vertical content spacing for pages below this directory.\n\n[Page theme reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#page-themes)"
+    },
+    "images": {
+      "type": "object",
+      "properties": {
+        "width": {
+          "description": "Maximum managed-image width. Omit this to keep the selected preset.",
+          "type": "string",
+          "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)|clamp\\(\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*\\))$",
+          "markdownDescription": "```yaml\nimages:\n  width: 900px\n```\n\nMaximum managed-image width. Omit this to keep the selected preset.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+        },
+        "maxAvailableWidthPercent": {
+          "description": "Maximum percentage of available horizontal space used by managed images.",
+          "anyOf": [
+            {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 100
+            },
+            {
+              "type": "object",
+              "properties": {
+                "desktop": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on wider screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableWidthPercent:\n    desktop: 100\n```\n\nPercentage used on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+                },
+                "mobile": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on narrow screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableWidthPercent:\n    mobile: 100\n```\n\nPercentage used on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+                }
+              },
+              "required": [
+                "desktop",
+                "mobile"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "markdownDescription": "```yaml\nimages:\n  maxAvailableWidthPercent:\n    desktop: 100\n    mobile: 100\n```\n\nMaximum percentage of available horizontal space used by managed images.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+        },
+        "maxAvailableHeightPercent": {
+          "description": "Maximum percentage of viewport height used by managed images.",
+          "anyOf": [
+            {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "maximum": 100
+            },
+            {
+              "type": "object",
+              "properties": {
+                "desktop": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on wider screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableHeightPercent:\n    desktop: 74\n```\n\nPercentage used on wider screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+                },
+                "mobile": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "maximum": 100,
+                  "description": "Percentage used on narrow screens.",
+                  "markdownDescription": "```yaml\nimages:\n  maxAvailableHeightPercent:\n    mobile: 68\n```\n\nPercentage used on narrow screens.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+                }
+              },
+              "required": [
+                "desktop",
+                "mobile"
+              ],
+              "additionalProperties": false
+            }
+          ],
+          "markdownDescription": "```yaml\nimages:\n  maxAvailableHeightPercent:\n    desktop: 74\n    mobile: 68\n```\n\nMaximum percentage of viewport height used by managed images.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Optional defaults for managed image presentation.",
+      "markdownDescription": "```yaml\nimages:\n  width: 900px\n```\n\nAdjusts managed-image sizing for pages below this directory.\n\n[Image sizing reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#image-sizing)"
+    },
+    "sections": {
+      "type": "object",
+      "properties": {
+        "backgroundPattern": {
+          "description": "Section background sequence inherited by descendant pages. Non-uniform patterns are invalid with tree navigation.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "uniform",
+              "title": "Uniform",
+              "description": "Use the normal page background for every H2 section. Tree navigation requires this pattern."
+            },
+            {
+              "const": "alternating",
+              "title": "Alternating",
+              "description": "Alternate normal and subtly contrasting full-width section backgrounds. Available with sections and top navigation."
+            },
+            {
+              "const": "accented",
+              "title": "Accented",
+              "description": "Move through base, soft, emphasis and soft full-width section backgrounds before repeating. Available with sections and top navigation."
+            }
+          ],
+          "markdownDescription": "```yaml\nsections:\n  backgroundPattern: alternating\n```\n\nSection background sequence inherited by descendant pages. Non-uniform patterns are invalid with tree navigation.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#page-themes)",
+          "examples": [
+            "uniform",
+            "alternating",
+            "accented"
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Page-local section presentation inherited by descendant pages.",
+      "markdownDescription": "```yaml\nsections:\n  backgroundPattern: alternating\n```\n\nAdjusts the H2 section background pattern for pages below this directory. Alternating and accented create full-width bands but are invalid when navigation resolves to tree.\n\n[Page theme reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#page-themes)"
+    }
+  },
+  "additionalProperties": false,
+  "description": "Limited page presentation overrides inherited by descendant pages. Site colors, corners, typography, content-block defaults and navigation remain global.",
+  "$id": "https://janga.github.io/norna/schemas/page-theme.schema.json",
+  "title": "Norna page theme",
+  "markdownDescription": "```yaml\nlayout:\n  textWidth: narrow\n  contentSpacing: compact\n```\n\nA limited theme in a page or category directory may adjust only page layout, managed-image sizing and the section background pattern. Descendant pages inherit these values. Tree navigation requires a uniform section background. Site colors, corners, typography, content-block defaults and navigation stay consistent.\n\n[Page theme reference](https://github.com/janga/norna/blob/v0.7.22/docs/theme.md#page-themes)"
+}

package/schemas/sitewide-content.schema.json

@@ -6,18 +6,18 @@
       "type": "object",
       "properties": {
         "height": {
-          "description": "Displayed logo height. Width follows the intrinsic aspect ratio.",
+          "description": "Displayed logo height on wider screens. Omit it to use 2.6rem; narrow screens cap the height at 2.15rem. Width follows the intrinsic aspect ratio.",
           "type": "string",
           "pattern": "^(?:0|(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)|clamp\\(\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*,\\s*(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:px|rem|em|vw|vh|vmin|vmax|ch|%)\\s*\\))$",
           "examples": [
             "2rem"
           ],
-          "markdownDescription": "```yaml\nlogo:\n  height: 2rem\n```\n\nDisplayed logo height. Width follows the intrinsic aspect ratio.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/public-files.md#navigation-logo)"
+          "markdownDescription": "```yaml\nlogo:\n  height: 2rem\n```\n\nDisplayed logo height on wider screens. Omit it to use 2.6rem; narrow screens cap the height at 2.15rem. Width follows the intrinsic aspect ratio.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/public-files.md#navigation-logo)"
         }
       },
       "additionalProperties": false,
       "description": "Optional display settings for a convention-based navigation logo.",
-      "markdownDescription": "```yaml\nlogo:\n  height: 2rem\n```\n\n`logo` optionally overrides the displayed height of the convention-based logo file. The logo links home, and its alternative text comes from the homepage Markdown H1. This setting does not enable or select the file.\n\n[Navigation logo filenames and placement](https://github.com/janga/norna/blob/v0.7.17/docs/public-files.md#navigation-logo)"
+      "markdownDescription": "```yaml\nlogo:\n  height: 2rem\n```\n\n`logo` optionally overrides the displayed height of the convention-based logo file. Without an override, Norna uses 2.6rem on wider screens and caps the logo at 2.15rem on narrow screens. The logo links home, and its alternative text comes from the homepage Markdown H1. This setting does not enable or select the file.\n\n[Navigation logo filenames and placement](https://github.com/janga/norna/blob/v0.7.22/docs/public-files.md#navigation-logo)"
     },
     "banners": {
       "default": [],
@@ -30,7 +30,7 @@
             "type": "string",
             "pattern": "^[a-z0-9-]+$",
             "description": "Stable banner identifier used for dismissal state.",
-            "markdownDescription": "```yaml\nbanners:\n  - id: project-status\n```\n\nStable banner identifier used for dismissal state.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+            "markdownDescription": "```yaml\nbanners:\n  - id: project-status\n```\n\nStable banner identifier used for dismissal state.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
           },
           "tone": {
             "default": "warning",
@@ -43,7 +43,7 @@
                 "description": "Present the banner as an important warning notice."
               }
             ],
-            "markdownDescription": "```yaml\nbanners:\n  - tone: warning\n```\n\nSemantic banner tone.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+            "markdownDescription": "```yaml\nbanners:\n  - tone: warning\n```\n\nSemantic banner tone.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
           },
           "visible": {
             "description": "Optional date window for the banner.",
@@ -53,21 +53,21 @@
                 "description": "First date on which the content is visible.",
                 "type": "string",
                 "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                "markdownDescription": "```yaml\nbanners:\n  - visible:\n      from: \"2026-01-01\"\n```\n\nFirst date on which the content is visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+                "markdownDescription": "```yaml\nbanners:\n  - visible:\n      from: \"2026-01-01\"\n```\n\nFirst date on which the content is visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
               },
               "until": {
                 "description": "First date on which the content is no longer visible.",
                 "type": "string",
                 "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-                "markdownDescription": "```yaml\nbanners:\n  - visible:\n      until: \"2026-02-01\"\n```\n\nFirst date on which the content is no longer visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+                "markdownDescription": "```yaml\nbanners:\n  - visible:\n      until: \"2026-02-01\"\n```\n\nFirst date on which the content is no longer visible.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
               }
             },
             "additionalProperties": false,
-            "markdownDescription": "```yaml\nbanners:\n  - visible:\n      from: \"2026-01-01\"\n      until: \"2026-02-01\"\n```\n\nOptional date window for the banner.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)",
+            "markdownDescription": "```yaml\nbanners:\n  - visible:\n      from: \"2026-01-01\"\n      until: \"2026-02-01\"\n```\n\nOptional date window for the banner.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)",
             "defaultSnippets": [
               {
                 "label": "Visibility window",
-                "markdownDescription": "Show the banner from the first date up to, but not including, the second date.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)",
+                "markdownDescription": "Show the banner from the first date up to, but not including, the second date.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)",
                 "body": {
                   "from": "${1:2026-01-01}",
                   "until": "${2:2026-02-01}"
@@ -79,13 +79,13 @@
             "type": "string",
             "minLength": 1,
             "description": "Short banner heading.",
-            "markdownDescription": "```yaml\nbanners:\n  - title: Important notice\n```\n\nShort banner heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+            "markdownDescription": "```yaml\nbanners:\n  - title: Important notice\n```\n\nShort banner heading.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
           },
           "text": {
             "type": "string",
             "minLength": 1,
             "description": "Concise banner message.",
-            "markdownDescription": "```yaml\nbanners:\n  - text: Brief explanation.\n```\n\nConcise banner message.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+            "markdownDescription": "```yaml\nbanners:\n  - text: Brief explanation.\n```\n\nConcise banner message.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
           }
         },
         "required": [
@@ -96,11 +96,11 @@
         "additionalProperties": false,
         "description": "Dismissible site-wide warning shown above page content for important temporary information.",
         "title": "Warning banner",
-        "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)",
+        "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)",
         "defaultSnippets": [
           {
             "label": "Warning banner",
-            "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)",
+            "markdownDescription": "A `warning` is a dismissible site-wide notice shown above page content. Use it for important temporary information visitors should notice, rather than ordinary page content.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)",
             "body": {
               "id": "${1:project-status}",
               "tone": "warning",
@@ -110,7 +110,7 @@
           }
         ]
       },
-      "markdownDescription": "```yaml\nbanners:\n  - id: project-status\n    tone: warning\n    title: Experimental code\n    text: Not for production use.\n```\n\nAdds dismissible notices above page content. List order controls their presentation order; each `id` must be unique.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#banners)"
+      "markdownDescription": "```yaml\nbanners:\n  - id: project-status\n    tone: warning\n    title: Experimental code\n    text: Not for production use.\n```\n\nAdds dismissible notices above page content. List order controls their presentation order; each `id` must be unique.\n\n[Banner reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#banners)"
     },
     "footer": {
       "description": "Site-wide footer content.",
@@ -120,22 +120,22 @@
           "description": "Copyright or ownership text shown in the site footer.",
           "type": "string",
           "minLength": 1,
-          "markdownDescription": "```yaml\nfooter:\n  copyrightMessage: Copyright Example Owner.\n```\n\nCopyright or ownership text shown in the site footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#footer)"
+          "markdownDescription": "```yaml\nfooter:\n  copyrightMessage: Copyright Example Owner.\n```\n\nCopyright or ownership text shown in the site footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#footer)"
         },
         "buildInfo": {
           "default": false,
           "description": "Show a localized generated build timestamp in the footer.",
           "type": "boolean",
-          "markdownDescription": "```yaml\nfooter:\n  buildInfo: true\n```\n\nShow a localized generated build timestamp in the footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#footer)"
+          "markdownDescription": "```yaml\nfooter:\n  buildInfo: true\n```\n\nShow a localized generated build timestamp in the footer.\n\n[Read the relevant reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#footer)"
         }
       },
       "additionalProperties": false,
-      "markdownDescription": "```yaml\nfooter:\n  copyrightMessage: Copyright Example Owner.\n```\n\nAdds shared footer content. Generated build information is optional.\n\n[Footer reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md#footer)"
+      "markdownDescription": "```yaml\nfooter:\n  copyrightMessage: Copyright Example Owner.\n```\n\nAdds shared footer content. Generated build information is optional.\n\n[Footer reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md#footer)"
     }
   },
   "additionalProperties": false,
   "description": "Editorial content and optional navigation logo display settings shared by every page.",
   "$id": "https://janga.github.io/norna/schemas/sitewide-content.schema.json",
   "title": "Norna site-wide content",
-  "markdownDescription": "```yaml\nfooter:\n  copyrightMessage: Copyright Example Owner.\n```\n\n`sitewide-content.yaml` optionally defines banners, footer content, and logo display settings shared by every page.\n\n[Site-wide content reference](https://github.com/janga/norna/blob/v0.7.17/docs/sitewide-content.md)"
+  "markdownDescription": "```yaml\nfooter:\n  copyrightMessage: Copyright Example Owner.\n```\n\n`sitewide-content.yaml` optionally defines banners, footer content, and logo display settings shared by every page.\n\n[Site-wide content reference](https://github.com/janga/norna/blob/v0.7.22/docs/sitewide-content.md)"
 }