@pagenary/publisher 2026.6.5 → 2026.6.6

package/README.md

@@ -361,6 +361,7 @@ The full documentation site is published at **[docs.pagenary.com](https://docs.p
 
 - [Getting Started](docs/GETTING-STARTED.md) — **start here**: zero to a published site with the npm package
 - [Quick Start Guide](docs/QUICKSTART.md) — step-by-step tenant creation
+- [Publish with GitHub/Gitea Actions](docs/PUBLISHING.md) — make any docs repo Pagenary-ready: copy-paste CI workflows + auto-discovery
 - [Tenant Configuration](docs/TENANT-CONFIG.md) — all config options (branding, theme, SEO)
 - [Architecture](docs/ARCHITECTURE.md) — system design
 - [API Reference](docs/API.md) — module documentation

package/examples/README.md

@@ -0,0 +1,14 @@
+# Pagenary publishing examples
+
+Copy-paste starting points for making any docs repo "Pagenary ready". See
+[`../docs/PUBLISHING.md`](../docs/PUBLISHING.md) for the full walkthrough.
+
+- `tenants.json` — the minimal registry: point Pagenary at your `docs/` folder.
+  No `manifest.json` needed; navigation and titles are auto-discovered.
+- `github-pages.yml` — drop into `.github/workflows/` to build + deploy to
+  GitHub Pages.
+- `gitea-pages.yml` — drop into `.gitea/workflows/` to build + publish to a
+  `pages` branch.
+
+`@pagenary/publisher` is published to the Gitea registry; the workflows install
+with `--registry=https://git.integrolabs.net/api/packages/pagenary/npm/`.

package/examples/gitea-pages.yml

@@ -0,0 +1,33 @@
+# Pagenary → Gitea Pages
+# Copy to .gitea/workflows/docs.yml in your docs repo. Gitea Pages serves a
+# branch (commonly "pages"); this builds the site and force-pushes it there.
+# Set a PAGES_TOKEN secret (a token with repo write). See ../docs/PUBLISHING.md.
+name: Publish docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Build the docs site
+        run: |
+          npm install --no-save @pagenary/publisher \
+            --registry=https://git.integrolabs.net/api/packages/pagenary/npm/
+          npx pagenary build:tenants mydocs --target ./_site
+      - name: Publish to the pages branch
+        env:
+          GIT_TOKEN: ${{ secrets.PAGES_TOKEN }}
+        run: |
+          cd ./_site/mydocs
+          touch .nojekyll
+          git init -q && git add -A
+          git -c user.name=ci -c user.email=ci@local commit -qm "docs build"
+          git push -f "https://oauth2:${GIT_TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY}.git" HEAD:pages

package/examples/github-pages.yml

@@ -0,0 +1,46 @@
+# Pagenary → GitHub Pages
+# Copy to .github/workflows/docs.yml in your docs repo, then enable Pages
+# (Settings → Pages → Source: GitHub Actions). Adjust the tenant id ("mydocs")
+# and the source path in tenants.json. See ../docs/PUBLISHING.md.
+name: Publish docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Build the docs site
+        run: |
+          npm install --no-save @pagenary/publisher \
+            --registry=https://git.integrolabs.net/api/packages/pagenary/npm/
+          npx pagenary build:tenants mydocs --target ./_site
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./_site/mydocs
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

package/examples/tenants.json

@@ -0,0 +1,9 @@
+{
+  "tenants": [
+    {
+      "id": "mydocs",
+      "source": { "type": "local", "path": "./docs" },
+      "config": { "title": "My Project Docs", "brandMark": "My", "brandSub": "Docs" }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagenary/publisher",
-  "version": "2026.6.5",
+  "version": "2026.6.6",
   "type": "module",
   "description": "Multi-tenant static publishing component for Pagenary platform.",
   "license": "AGPL-3.0-or-later",
@@ -20,6 +20,7 @@
     "src/",
     "scripts/",
     "site/",
+    "examples/",
     "build.config.json",
     "tenants.schema.json",
     "tenants.json.example",

package/site/index.html

@@ -21,7 +21,7 @@
     </script>
     <link rel="icon" type="image/png" href="./favicon.png" />
     <link rel="stylesheet" href="./styles.css" />
-    <meta name="x-build" content="2026-06-15T21:46:01.346Z" />
+    <meta name="x-build" content="2026-06-15T22:00:56.723Z" />
   </head>
   <body>
     <a class="skip-link" href="#app">Skip to content</a>

package/site/robots.txt

@@ -1,5 +1,5 @@
 # Pagenary Docs
-# Generated: 2026-06-15T21:46:01.946Z
+# Generated: 2026-06-15T22:00:57.294Z
 
 User-agent: *
 Allow: /