@janga/norna 0.7.0

package/starters/basic/.github/workflows/deploy.yml

@@ -0,0 +1,65 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: github-pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24.18.0
+          cache: npm
+
+      - name: Install image tools
+        run: sudo apt-get update && sudo apt-get install -y imagemagick
+
+      - name: Restore generated images
+        uses: actions/cache@v4
+        with:
+          path: site/.cli-gallery/public/images/generated
+          key: cli-gallery-images-${{ hashFiles('site/.cli-gallery/generated-images.json') }}
+          restore-keys: |
+            cli-gallery-images-
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/starters/basic/README.md

@@ -0,0 +1,55 @@
+# norna Starter
+
+This is a minimal site repository starter for `@janga/norna`.
+
+## Setup
+
+```sh
+npm install
+npm run norna:dev
+```
+
+Edit site-wide theme defaults in `site/theme.md`, homepage content and section
+overrides in `site/content.md`, technical settings such as URL, layout, font,
+and locale labels in `site/config.mjs`, source images under
+`site/images/<section-id>/`, and static public files under `site/public/`.
+
+The page width is configured with `layout.pageWidth`; gallery width is
+configured with `gallery.width`. Side margins are configured with
+`layout.gutter`; image height is limited with
+`gallery.maxAvailableHeightPercent`.
+
+The site font is configured with `typography.fontFamily` in `site/config.mjs`.
+Site-wide text presentation is configured with typography presets and overrides
+in `site/theme.md`; page and section overrides live in `site/content.md`.
+
+Commit `package-lock.json` after the first install so GitHub Actions can use
+`npm ci`.
+
+Use `norna:*` scripts for norna-specific work:
+
+```sh
+npm run norna:content:check
+npm run norna:sync
+npm run norna:typography:presets
+npm run norna:typography:show
+npm run norna:build
+```
+
+This keeps gallery commands separate from repository-specific build or
+publishing commands in projects that embed a gallery inside a larger GitHub
+project. This pure starter also keeps `npm run build` as an alias for
+`npm run norna:build`.
+
+Use `npm run norna:engine:version` to inspect the installed engine and
+`npm run norna:engine:update` to update it.
+
+Generic documentation lives in the `norna` repository:
+
+- `docs/getting-started.md`
+- `docs/site-structure.md`
+- `docs/content.md`
+- `docs/configuration.md`
+- `docs/commands.md`
+- `docs/images-and-metadata.md`
+- `docs/publishing.md`

package/starters/basic/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "norna-site",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npm run norna:dev",
+    "norna:dev": "norna dev:local",
+    "norna:dev:lan": "norna dev:lan",
+    "norna:dev:restart": "norna dev:restart",
+    "norna:dev:status": "norna dev:status",
+    "norna:dev:logs": "norna dev:logs",
+    "norna:dev:stop": "norna dev:stop",
+    "norna:check": "npm run norna:config:check && npm run norna:content:check",
+    "norna:config:check": "norna config:check",
+    "norna:content:check": "norna content:check",
+    "norna:sync": "norna content:sync",
+    "norna:typography:presets": "norna typography:presets",
+    "norna:typography:show": "norna typography:show",
+    "norna:public": "norna site:public",
+    "norna:images": "norna images",
+    "norna:build": "norna build",
+    "norna:build:local": "norna build:local",
+    "norna:deploy": "norna deploy",
+    "norna:deploy:commit": "norna deploy:commit",
+    "norna:deploy:watch": "norna deploy:watch",
+    "norna:doctor": "norna doctor",
+    "norna:preview": "norna preview",
+    "norna:engine:update": "norna engine:update",
+    "norna:engine:version": "norna engine:version",
+    "build": "npm run norna:build"
+  },
+  "dependencies": {
+    "@janga/norna": "0.1.16"
+  }
+}

package/starters/basic/site/config.mjs

@@ -0,0 +1,60 @@
+export default {
+	site: {
+		url: 'https://example.com/',
+	},
+	layout: {
+		pageWidth: '1180px',
+		gutter: {
+			desktop: 'clamp(1.25rem, 4vw, 3rem)',
+			mobile: '1rem',
+		},
+	},
+	gallery: {
+		width: '900px',
+		maxAvailableWidthPercent: {
+			desktop: 100,
+			mobile: 100,
+		},
+		maxAvailableHeightPercent: {
+			desktop: 74,
+			mobile: 68,
+		},
+	},
+	typography: {
+		fontFamily: "Arial, 'Helvetica Neue', Helvetica, sans-serif",
+	},
+	navigation: {
+		smoothScroll: {
+			enabled: true,
+			minimumDurationMs: 600,
+			maximumDurationMs: 1_200,
+			durationPerPixelMs: 0.2,
+		},
+	},
+	locale: {
+		lang: 'en',
+		labels: {
+			skipToContent: 'Skip to content',
+			sectionNavigation: 'Sections',
+			gallery: 'Gallery',
+		},
+	},
+	footer: {
+		copyrightMessage: '(c) Example Artist.',
+		buildInfo: {
+			enabled: true,
+			text: 'Built',
+			dateTimeFormat: {
+				locale: 'en-GB',
+				timeZone: 'UTC',
+				dateStyle: 'short',
+				timeStyle: 'short',
+			},
+		},
+	},
+	github: {
+		repo: 'owner/example-gallery',
+		branch: 'main',
+		pagesWorkflow: 'Deploy to GitHub Pages',
+	},
+};

package/starters/basic/site/content.md

@@ -0,0 +1,21 @@
+---
+title: Example Gallery
+description: Minimal norna starter site.
+sections:
+  - id: intro
+    presentation:
+      typography:
+        preset: statement
+    gallery: []
+  - id: work
+    gallery: []
+
+---
+## Intro {#intro}
+
+This is a minimal starter site for norna. Use
+[highlighted inline text]{.highlight} when a short phrase needs emphasis.
+
+## Work {#work}
+
+Add gallery rows in frontmatter and matching source images under images/work/.

package/starters/basic/site/images/work/.gitkeep

@@ -0,0 +1 @@
+

package/starters/basic/site/public/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Allow: /

package/starters/basic/site/theme.md

@@ -0,0 +1,53 @@
+---
+# norna:start theme-help
+# Site-wide visual defaults. Remove a value to use the engine default.
+# Active values below are ordinary YAML; this marked comment block is only help text.
+#
+# Available structure:
+# presentation:
+#   backgroundColor: quoted hex color, e.g. "#000000"
+#   textColor: quoted hex color, e.g. "#f7f4ee"
+#   inlineStyles:
+#     style-name:
+#       color: quoted hex color
+#   typography:
+#     preset: quiet-gallery | compact-gallery | text-forward | statement
+#     overrides:
+#       heading:
+#         align:
+#           desktop: left | center | right
+#           mobile: left | center | right
+#         size: small | medium | large | xlarge
+#         lineHeight: number from 1 through 3
+#         spacing: CSS length, e.g. 0.65em
+#       body:
+#         align:
+#           desktop: left | center | right
+#           mobile: left | center | right
+#         size: small | medium | large | xlarge
+#         lineHeight: number from 1 through 3
+#         paragraphSpacing: CSS length, e.g. 0.85em
+#       caption:
+#         align:
+#           desktop: left | center | right
+#           mobile: left | center | right
+#         size: small | medium | large | xlarge
+#         lineHeight: number from 1 through 3
+#         spacing: CSS length, e.g. 0.5em
+# frame:
+#   colors: presentation | theme
+#   colors:
+#     backgroundColor: quoted hex color
+#     textColor: quoted hex color
+# norna:end theme-help
+presentation:
+  backgroundColor: "#000000"
+  textColor: "#f7f4ee"
+  inlineStyles:
+    highlight:
+      color: "#ffd84d"
+  typography:
+    preset: quiet-gallery
+frame:
+  colors: presentation
+---

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}