@janga/norna 0.7.29 → 0.7.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/README.md +1 -2
  2. package/package.json +5 -3
  3. package/schemas/config.schema.json +67 -67
  4. package/schemas/content-frontmatter.schema.json +9 -9
  5. package/schemas/page-theme.schema.json +237 -237
  6. package/schemas/root-theme.schema.json +237 -237
  7. package/schemas/sitewide-content.schema.json +18 -18
  8. package/schemas/theme.schema.json +237 -237
  9. package/scripts/generate-images.mjs +34 -82
  10. package/scripts/lib/editor-source-files.mjs +7 -1
  11. package/scripts/lib/image-dimensions.mjs +3 -72
  12. package/starters/basic/.github/workflows/deploy.yml +3 -6
  13. package/starters/basic/README.md +2 -0
  14. package/starters/basic/site/site-config/settings.yaml +2 -0
package/schemas/content-frontmatter.schema.json CHANGED
@@ -9,7 +9,7 @@
9
9
  "description": "Page description used in metadata, social previews and generated child-page lists.",
10
10
  "type": "string",
11
11
  "minLength": 1,
12
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/site/pages/metadata/content.md)",
12
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/site/pages/metadata/content.md)",
13
13
  "examples": [
14
14
  "About this project."
15
15
  ]
@@ -17,7 +17,7 @@
17
17
  "listChildren": {
18
18
  "description": "Append links to every listed direct child page after this page's authored content.",
19
19
  "type": "boolean",
20
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/site/pages/pages/content.md)",
20
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/site/pages/pages/content.md)",
21
21
  "examples": [
22
22
  true,
23
23
  false
@@ -31,12 +31,12 @@
31
31
  "type": "string",
32
32
  "pattern": "^\\/(?:[a-z0-9]+(?:-[a-z0-9]+)*\\/)+$",
33
33
  "description": "Previous site-relative URL that permanently identifies this page.",
34
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/site/pages/urls/content.md#keep-an-old-url)",
34
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/site/pages/urls/content.md#keep-an-old-url)",
35
35
  "examples": [
36
36
  "/old-about/"
37
37
  ]
38
38
  },
39
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/site/pages/urls/content.md#keep-an-old-url)",
39
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/site/pages/urls/content.md#keep-an-old-url)",
40
40
  "examples": [
41
41
  [
42
42
  "/old-about/"
@@ -46,7 +46,7 @@
46
46
  },
47
47
  "additionalProperties": false,
48
48
  "description": "Optional metadata for this homepage or additional page. The Markdown H1 supplies the page title.",
49
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/site/pages/metadata/content.md)"
49
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/site/pages/metadata/content.md)"
50
50
  },
51
51
  "navigation": {
52
52
  "description": "Optional navigation metadata for this page.",
@@ -57,13 +57,13 @@
57
57
  "type": "integer",
58
58
  "minimum": 1,
59
59
  "maximum": 9007199254740991,
60
- "markdownDescription": "```yaml\nnavigation:\n order: 1000\n```\n\nSibling presentation order. Positive integer; lower values appear first. Omit to follow ordered siblings, sorted by slug. Duplicate values warn and use slug to break ties.\n\n[Read the relevant reference (current)](https://janga.github.io/norna/reference/configuration/navigation/)\n\n[Norna 0.7.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/configuration/pages/navigation/content.md)"
60
+ "markdownDescription": "```yaml\nnavigation:\n order: 1000\n```\n\nSibling presentation order. Positive integer; lower values appear first. Omit to follow ordered siblings, sorted by slug. Duplicate values warn and use slug to break ties.\n\n[Read the relevant reference (current)](https://janga.github.io/norna/reference/configuration/navigation/)\n\n[Norna 0.7.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/configuration/pages/navigation/content.md)"
61
61
  },
62
62
  "listed": {
63
63
  "default": true,
64
64
  "description": "List this page in site navigation. The page remains public when false.",
65
65
  "type": "boolean",
66
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/configuration/pages/navigation/content.md)",
66
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/configuration/pages/navigation/content.md)",
67
67
  "examples": [
68
68
  true,
69
69
  false
@@ -71,12 +71,12 @@
71
71
  }
72
72
  },
73
73
  "additionalProperties": false,
74
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/configuration/pages/navigation/content.md)"
74
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/configuration/pages/navigation/content.md)"
75
75
  }
76
76
  },
77
77
  "additionalProperties": false,
78
78
  "description": "Frontmatter for a homepage or additional page content.md file.",
79
79
  "$id": "https://janga.github.io/norna/schemas/content-frontmatter.schema.json",
80
80
  "title": "Norna page frontmatter",
81
- "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.29 source reference](https://github.com/janga/norna/blob/v0.7.29/site/root/pages/reference/pages/site/pages/metadata/content.md)"
81
+ "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.30 source reference](https://github.com/janga/norna/blob/v0.7.30/site/root/pages/reference/pages/site/pages/metadata/content.md)"
82
82
  }