@kamod-ch/preactpress 1.0.0 → 1.0.2

package/templates/hono/de/guide/what-is-preactpress.md

@@ -36,18 +36,18 @@ Im separaten Projekt `preactpress-examples` gibt es ein Custom-Theme-Beispiel mi
 
 PreactPress soll Content-Arbeit einfach halten:
 
-| Feature | Nutzen |
-| --- | --- |
-| Vite Dev-Server | Schneller Start und Hot Updates beim Bearbeiten |
+| Feature              | Nutzen                                                         |
+| -------------------- | -------------------------------------------------------------- |
+| Vite Dev-Server      | Schneller Start und Hot Updates beim Bearbeiten                |
 | Markdown-Frontmatter | Titel, Beschreibungen, Tags, Draft-Status und Social-Metadaten |
-| MDX | Preact-Komponenten direkt in Inhaltsseiten |
-| Standard-Theme | Nav, Sidebar, Outline, Suche, Footer, Sprachumschalter |
-| `preactpress check` | Validierung von Config, Routen und Links vor dem Release |
+| MDX                  | Preact-Komponenten direkt in Inhaltsseiten                     |
+| Standard-Theme       | Nav, Sidebar, Outline, Suche, Footer, Sprachumschalter         |
+| `preactpress check`  | Validierung von Config, Routen und Links vor dem Release       |
 
 Für normale Inhalte nimmst du `.md`. Wenn eine Seite Interaktivität braucht, nimmst du `.mdx` und importierst eine Preact-Komponente:
 
 ```mdx
-import Counter from './components/Counter.tsx'
+import Counter from "./components/Counter.tsx";
 
 ## Demo
 
@@ -62,13 +62,13 @@ Nach der Hydration übernimmt die Client-Navigation. Markdown-Seiten werden als
 
 Der Produktionsbuild besteht nur aus statischen Dateien:
 
-| Ausgabe | Zweck |
-| --- | --- |
-| `index.html`, `*/index.html` | Eine HTML-Datei pro Route |
-| `assets/*` | Gehashtes JavaScript und CSS von Vite |
-| `preactpress-search.json` | Suchdaten für das Standard-Theme |
-| `preactpress-content/*.json` | Lazy geladene Markdown-Payloads |
-| `404.html` | Fehlerseite |
+| Ausgabe                      | Zweck                                 |
+| ---------------------------- | ------------------------------------- |
+| `index.html`, `*/index.html` | Eine HTML-Datei pro Route             |
+| `assets/*`                   | Gehashtes JavaScript und CSS von Vite |
+| `preactpress-search.json`    | Suchdaten für das Standard-Theme      |
+| `preactpress-content/*.json` | Lazy geladene Markdown-Payloads       |
+| `404.html`                   | Fehlerseite                           |
 
 ## Was ist mit VitePress?
 
@@ -80,8 +80,8 @@ PreactPress ist in Produktion außerdem static-only. Du baust die Site einmal, l
 
 ## Nächste Schritte
 
-| Seite | Warum |
-| --- | --- |
+| Seite                                        | Warum                                                       |
+| -------------------------------------------- | ----------------------------------------------------------- |
 | [Getting Started](/de/guide/getting-started) | PreactPress installieren und die Starter-Struktur verstehen |
-| [Routing](/de/guide/routing) | Lernen, wie Dateien zu URLs werden |
-| [Deploy](/de/guide/deploy) | Eine statische Site bauen und veröffentlichen |
+| [Routing](/de/guide/routing)                 | Lernen, wie Dateien zu URLs werden                          |
+| [Deploy](/de/guide/deploy)                   | Eine statische Site bauen und veröffentlichen               |

package/templates/hono/de/index.mdx

@@ -3,8 +3,8 @@ title: Schnell, schlank, auf Web-Standards gebaut
 description: Ein von hono.dev inspiriertes Starter-Template für Dokumentation und Produktseiten mit PreactPress.
 ---
 
-import FeatureGrid from '../.preactpress/theme/FeatureGrid.tsx'
-import Hero from '../.preactpress/theme/Hero.tsx'
+import FeatureGrid from "../.preactpress/theme/FeatureGrid.tsx";
+import Hero from "../.preactpress/theme/Hero.tsx";
 
 <Hero
   eyebrow="Hono-inspirierter Starter"
@@ -12,14 +12,14 @@ import Hero from '../.preactpress/theme/Hero.tsx'
   subtitle="Nutze dieses Template für hochwertige Dokumentation, Beispiele und Produktseiten mit einem kompakten Preact-Theme."
   actions={[
     { text: 'Loslegen', link: '/de/guide/getting-started', theme: 'brand' },
-    { text: 'Auf GitHub ansehen', link: 'https://github.com/your-org/your-project', theme: 'alt' }
+    { text: 'Auf GitHub ansehen', link: 'https://github.com/kamod-ch/preactpress', theme: 'alt' }
   ]}
   code={`import { App } from 'your-framework'
 
 const app = new App()
 
 app.get('/', (c) => {
-  return c.text('Hallo Web-Standards!')
+return c.text('Hallo Web-Standards!')
 })
 
 export default app`}
@@ -28,24 +28,27 @@ export default app`}
 <FeatureGrid
   features={[
     {
-      icon: 'F',
-      title: 'Ultraschnell & leichtgewichtig',
-      details: 'Statisches HTML, wenig Client-Code und ein Theme, das deine Docs responsiv hält.'
+      icon: "F",
+      title: "Ultraschnell & leichtgewichtig",
+      details: "Statisches HTML, wenig Client-Code und ein Theme, das deine Docs responsiv hält.",
     },
     {
-      icon: 'R',
-      title: 'Für viele Runtimes gedacht',
-      details: 'Schreibe portable Beispiele für Node, Bun, Deno, Edge Workers und statisches Hosting.'
+      icon: "R",
+      title: "Für viele Runtimes gedacht",
+      details:
+        "Schreibe portable Beispiele für Node, Bun, Deno, Edge Workers und statisches Hosting.",
     },
     {
-      icon: 'B',
-      title: 'Batterien inklusive',
-      details: 'Navigation, Sidebar-Suche, MDX, Tags, i18n und statische Builds sind direkt startklar.'
+      icon: "B",
+      title: "Batterien inklusive",
+      details:
+        "Navigation, Sidebar-Suche, MDX, Tags, i18n und statische Builds sind direkt startklar.",
     },
     {
-      icon: 'D',
-      title: 'Angenehme DX',
-      details: 'Markdown-first Content, Vite-Geschwindigkeit und editierbare Preact-Komponenten für Custom Pages.'
-    }
+      icon: "D",
+      title: "Angenehme DX",
+      details:
+        "Markdown-first Content, Vite-Geschwindigkeit und editierbare Preact-Komponenten für Custom Pages.",
+    },
   ]}
 />

package/templates/hono/de/interactive.mdx

@@ -3,7 +3,7 @@ title: Interaktives MDX
 description: Markdown mit importierten Preact-Komponenten
 ---
 
-import Counter from '../components/Counter.tsx'
+import Counter from "../components/Counter.tsx";
 
 ## Preact-Komponente
 

package/templates/hono/de/markdown-examples.md

@@ -17,7 +17,7 @@ Einzelne Zeilen kannst du per Fence-Meta (`{2}`) oder Inline-Notation markieren:
 
 ```ts
 export function greet(name: string) {
-  return `Hallo, ${name}!` // [!code highlight]
+  return `Hallo, ${name}!`; // [!code highlight]
 }
 ```
 
@@ -37,9 +37,9 @@ Das `@/`-Präfix wird relativ zum Content-Root (`srcDir`) aufgelöst.
 
 ## Tabellen
 
-| Syntax | Ergebnis |
-| --- | --- |
-| `# Titel` | Überschrift |
+| Syntax            | Ergebnis        |
+| ----------------- | --------------- |
+| `# Titel`         | Überschrift     |
 | `---` Frontmatter | Seitenmetadaten |
 
 ## Zitate
@@ -128,11 +128,11 @@ Verschachtelte Überschrift für die Gliederung.
 ::: code-group
 
 ```js [config.js]
-export default { lang: 'js' }
+export default { lang: "js" };
 ```
 
 ```ts [config.ts]
-export default { lang: 'ts' }
+export default { lang: "ts" };
 ```
 
 :::

package/templates/hono/de/parts/include-body.md

@@ -2,6 +2,7 @@ Zeile eins — übersprungen.
 Zeile zwei — übersprungen.
 Zeile drei — übersprungen.
 Zeile vier — übersprungen.
+
 ## Eingebetteter Inhalt
 
 Dieser Absatz wird per `<!--@include: …{5,6}-->` eingebunden.

package/templates/hono/de/snippets/greet.ts

@@ -1,3 +1,3 @@
 export function greet(name: string) {
-  return `Hallo, ${name}!`
+  return `Hallo, ${name}!`;
 }

package/templates/hono/guide/configuration.md

@@ -10,23 +10,23 @@ Configuration lives in `.preactpress/config.ts` at your site root.
 ```ts
 export default {
   site: {
-    title: 'My docs',
-    description: 'Short site summary for SEO',
-    base: '/',
-    url: 'https://example.com',
-    titleTemplate: ':title | :siteTitle'
-  }
-}
+    title: "My docs",
+    description: "Short site summary for SEO",
+    base: "/",
+    url: "https://example.com",
+    titleTemplate: ":title | :siteTitle",
+  },
+};
 ```
 
 Set `site.url` before production so canonical URLs, `sitemap.xml`, Open Graph, and `hreflang` alternates resolve correctly.
 
 ## Content directory
 
-| Option | Purpose |
-| --- | --- |
-| `srcDir` | Folder with `.md` / `.mdx` pages (default `.`) |
-| `srcExclude` | Glob patterns for non-page Markdown, e.g. `['**/README.md']` |
+| Option           | Purpose                                                           |
+| ---------------- | ----------------------------------------------------------------- |
+| `srcDir`         | Folder with `.md` / `.mdx` pages (default `.`)                    |
+| `srcExclude`     | Glob patterns for non-page Markdown, e.g. `['**/README.md']`      |
 | `lastUpdatedGit` | Use git commit time for “last updated” (falls back to file mtime) |
 
 ## Theme without custom code
@@ -96,9 +96,9 @@ themeConfig: {
 ```ts
 themeConfig: {
   socialLinks: [
-    { icon: 'github', link: 'https://github.com/your-org/your-repo' },
-    { icon: { svg: '<svg ...></svg>' }, link: 'https://example.com', ariaLabel: 'Company site' }
-  ]
+    { icon: "github", link: "https://github.com/kamod-ch/preactpress" },
+    { icon: { svg: "<svg ...></svg>" }, link: "https://example.com", ariaLabel: "Company site" },
+  ];
 }
 ```
 
@@ -140,25 +140,25 @@ async buildEnd({ site, pages }) {
 Export a factory to load nav or sidebar from an API at config time:
 
 ```ts
-import { defineConfig } from '@kamod-ch/preactpress/config'
+import { defineConfig } from "@kamod-ch/preactpress/config";
 
 export default defineConfig(async () => ({
-  site: { title: 'My docs', description: 'Docs from CMS' },
+  site: { title: "My docs", description: "Docs from CMS" },
   themeConfig: {
     nav: await fetchNav(),
-    sidebar: await fetchSidebar()
-  }
-}))
+    sidebar: await fetchSidebar(),
+  },
+}));
 ```
 
 ## Page frontmatter
 
-| Field | Purpose |
-| --- | --- |
-| `title` / `description` | Page title and SEO summary |
-| `titleTemplate` | Override site template; `false` uses the raw page title |
-| `head` | Extra `<meta>` / `<link>` / `<script>` tags for this page only |
-| `draft: true` | Excluded from routes, search, and sitemap |
+| Field                   | Purpose                                                        |
+| ----------------------- | -------------------------------------------------------------- |
+| `title` / `description` | Page title and SEO summary                                     |
+| `titleTemplate`         | Override site template; `false` uses the raw page title        |
+| `head`                  | Extra `<meta>` / `<link>` / `<script>` tags for this page only |
+| `draft: true`           | Excluded from routes, search, and sitemap                      |
 
 Example per-page head:
 

package/templates/hono/guide/creating-pages.md

@@ -40,14 +40,14 @@ Save the file — with `pnpm run dev` running, the page is immediately available
 
 PreactPress uses **file-based routing**. The path relative to `srcDir` becomes the route:
 
-| File | URL |
-| --- | --- |
-| `index.md` | `/` |
-| `about.md` | `/about` |
-| `guide/intro.md` | `/guide/intro` |
-| `guide/index.md` | `/guide` |
+| File                 | URL                |
+| -------------------- | ------------------ |
+| `index.md`           | `/`                |
+| `about.md`           | `/about`           |
+| `guide/intro.md`     | `/guide/intro`     |
+| `guide/index.md`     | `/guide`           |
 | `news/2025/intro.md` | `/news/2025/intro` |
-| `interactive.mdx` | `/interactive` |
+| `interactive.mdx`    | `/interactive`     |
 
 Production builds write directory indexes (`dist/about/index.html`) so URLs work without `.html`.
 
@@ -60,8 +60,8 @@ By default, Markdown files live in the project root next to `.preactpress/`. You
 ```ts
 // .preactpress/config.ts
 export default {
-  srcDir: 'docs'
-}
+  srcDir: "docs",
+};
 ```
 
 Then all pages live under `docs/` — e.g. `docs/index.md` → `/`, `docs/guide/foo.md` → `/guide/foo`. URLs stay the same; only the file location changes.
@@ -78,14 +78,14 @@ layout: doc
 ---
 ```
 
-| Field | Purpose |
-| --- | --- |
-| `title` | Page title (nav, `<title>`, search) |
-| `description` | Summary for SEO and search |
-| `layout: doc` | Docs layout with sidebar, outline, and previous/next links |
-| `layout: page` | Content page without sidebar or doc outline |
-| `layout: home` | Home layout with optional `hero` and `features` |
-| `draft: true` | Excluded from build, sitemap, and search |
+| Field          | Purpose                                                    |
+| -------------- | ---------------------------------------------------------- |
+| `title`        | Page title (nav, `<title>`, search)                        |
+| `description`  | Summary for SEO and search                                 |
+| `layout: doc`  | Docs layout with sidebar, outline, and previous/next links |
+| `layout: page` | Content page without sidebar or doc outline                |
+| `layout: home` | Home layout with optional `hero` and `features`            |
+| `draft: true`  | Excluded from build, sitemap, and search                   |
 
 Additional fields (`tags`, `sidebar: false`, `navbar: false`, …) are documented in the package README and starter reference.
 
@@ -99,7 +99,7 @@ title: Demo
 description: Interactive component
 ---
 
-import Counter from './components/Counter.tsx'
+import Counter from "./components/Counter.tsx";
 
 ## Counter
 
@@ -118,20 +118,20 @@ New pages do **not** appear in the header or sidebar automatically. Register the
 export default {
   themeConfig: {
     nav: [
-      { text: 'Home', link: '/' },
-      { text: 'Contact', link: '/contact' }
+      { text: "Home", link: "/" },
+      { text: "Contact", link: "/contact" },
     ],
     sidebar: [
       {
-        text: 'Guide',
+        text: "Guide",
         items: [
-          { text: 'Creating pages', link: '/guide/creating-pages' },
-          { text: 'Contact', link: '/contact' }
-        ]
-      }
-    ]
-  }
-}
+          { text: "Creating pages", link: "/guide/creating-pages" },
+          { text: "Contact", link: "/contact" },
+        ],
+      },
+    ],
+  },
+};
 ```
 
 For multilingual sites (`locales`), put `nav` and `sidebar` in each locale block — see [Getting Started](/guide/getting-started).
@@ -154,18 +154,18 @@ Each locale is a **separate file**, not an alias of the default page.
 
 ## Common issues
 
-| Problem | Fix |
-| --- | --- |
-| Page returns 404 | `.md` / `.mdx` extension? File under `srcDir`? Dev server running? |
-| Markdown link broken | Omit extension: `/guide/foo`, not `/guide/foo.md` |
-| Duplicate URL | Two files must not map to the same route (e.g. `foo.md` and `foo/index.md`) |
-| Page missing from nav | Add to `nav` / `sidebar` in config |
+| Problem               | Fix                                                                         |
+| --------------------- | --------------------------------------------------------------------------- |
+| Page returns 404      | `.md` / `.mdx` extension? File under `srcDir`? Dev server running?          |
+| Markdown link broken  | Omit extension: `/guide/foo`, not `/guide/foo.md`                           |
+| Duplicate URL         | Two files must not map to the same route (e.g. `foo.md` and `foo/index.md`) |
+| Page missing from nav | Add to `nav` / `sidebar` in config                                          |
 
 ## Next steps
 
-| Topic | Link |
-| --- | --- |
+| Topic                      | Link                                              |
+| -------------------------- | ------------------------------------------------- |
 | First changes in 5 minutes | [Your first 5 minutes](/guide/first-five-minutes) |
-| Routing, `srcDir`, tags | [Routing](/guide/routing) |
-| Markdown syntax | [Markdown examples](/markdown-examples) |
-| Production build | [Deploy](/guide/deploy) |
+| Routing, `srcDir`, tags    | [Routing](/guide/routing)                         |
+| Markdown syntax            | [Markdown examples](/markdown-examples)           |
+| Production build           | [Deploy](/guide/deploy)                           |

package/templates/hono/guide/deploy.md

@@ -33,16 +33,16 @@ Set `site.url` before publishing. PreactPress uses it for canonical URLs, Open G
 ```ts
 export default {
   site: {
-    title: 'My site',
-    description: 'Short summary for search and social previews',
-    url: 'https://example.com',
-    base: '/'
+    title: "My site",
+    description: "Short summary for search and social previews",
+    url: "https://example.com",
+    base: "/",
   },
   build: {
     sitemap: true,
-    robots: true
-  }
-}
+    robots: true,
+  },
+};
 ```
 
 ## Public base path
@@ -58,10 +58,10 @@ If the site is served from a subpath, set `site.base`:
 ```ts
 export default {
   site: {
-    url: 'https://user.github.io',
-    base: '/my-repo/'
-  }
-}
+    url: "https://user.github.io",
+    base: "/my-repo/",
+  },
+};
 ```
 
 You can also override the base path for a single build:
@@ -74,15 +74,15 @@ pnpm exec preactpress build --base /my-repo/
 
 The default output directory is `dist/`:
 
-| Output | Description |
-| --- | --- |
-| `index.html`, `*/index.html` | Static HTML for each route |
-| `assets/*` | Hashed JavaScript and CSS from Vite |
-| `404.html` | Not-found page |
-| `preactpress-search.json` | Search index for the default theme |
+| Output                       | Description                                         |
+| ---------------------------- | --------------------------------------------------- |
+| `index.html`, `*/index.html` | Static HTML for each route                          |
+| `assets/*`                   | Hashed JavaScript and CSS from Vite                 |
+| `404.html`                   | Not-found page                                      |
+| `preactpress-search.json`    | Search index for the default theme                  |
 | `preactpress-content/*.json` | Lazy-loaded Markdown payloads for client navigation |
-| `sitemap.xml`, `robots.txt` | Generated when `site.url` and build flags are set |
-| `feed.xml` | Generated when `build.feed` is configured |
+| `sitemap.xml`, `robots.txt`  | Generated when `site.url` and build flags are set   |
+| `feed.xml`                   | Generated when `build.feed` is configured           |
 
 Deploy only the output directory. Do not deploy `node_modules`, `.preactpress`, or the build cache.
 
@@ -90,12 +90,12 @@ Deploy only the output directory. Do not deploy `node_modules`, `.preactpress`,
 
 For most static hosts, use these settings:
 
-| Host | Build command | Output directory |
-| --- | --- | --- |
-| Netlify | `pnpm run build` | `dist` |
-| Vercel | `pnpm run build` | `dist` |
-| Cloudflare Pages | `pnpm run build` | `dist` |
-| Render Static Site | `pnpm run build` | `dist` |
+| Host               | Build command    | Output directory |
+| ------------------ | ---------------- | ---------------- |
+| Netlify            | `pnpm run build` | `dist`           |
+| Vercel             | `pnpm run build` | `dist`           |
+| Cloudflare Pages   | `pnpm run build` | `dist`           |
+| Render Static Site | `pnpm run build` | `dist`           |
 
 Install command:
 
@@ -112,10 +112,10 @@ For a project site at `https://user.github.io/my-repo/`, configure:
 ```ts
 export default {
   site: {
-    url: 'https://user.github.io',
-    base: '/my-repo/'
-  }
-}
+    url: "https://user.github.io",
+    base: "/my-repo/",
+  },
+};
 ```
 
 Then deploy the `dist/` directory.

package/templates/hono/guide/first-five-minutes.md

@@ -14,10 +14,10 @@ Edit `.preactpress/config.ts`:
 ```ts
 export default {
   site: {
-    title: 'My Docs',
-    description: 'Short summary for search and social previews'
-  }
-}
+    title: "My Docs",
+    description: "Short summary for search and social previews",
+  },
+};
 ```
 
 Save the file. The dev server picks up config changes on the next request.
@@ -49,34 +49,34 @@ In `.preactpress/config.ts`:
 
 ```ts
 export default {
-  site: { title: 'My Docs' },
+  site: { title: "My Docs" },
   themeConfig: {
     nav: [
-      { text: 'Home', link: '/' },
-      { text: 'About', link: '/about' }
+      { text: "Home", link: "/" },
+      { text: "About", link: "/about" },
     ],
     sidebar: [
       {
-        text: 'Guide',
+        text: "Guide",
         items: [
-          { text: 'Home', link: '/' },
-          { text: 'About', link: '/about' }
-        ]
-      }
-    ]
-  }
-}
+          { text: "Home", link: "/" },
+          { text: "About", link: "/about" },
+        ],
+      },
+    ],
+  },
+};
 ```
 
 Save — the dev server hot-reloads your changes.
 
 ## Next steps
 
-| Command | Purpose |
-| --- | --- |
-| `pnpm run dev` | Dev server with SSR and hot reload |
-| `pnpm run check` | Validate config, links, and routes |
-| `pnpm run build` | Static production build → `dist/` |
-| `pnpm run preview` | Local preview of the build |
+| Command            | Purpose                            |
+| ------------------ | ---------------------------------- |
+| `pnpm run dev`     | Dev server with SSR and hot reload |
+| `pnpm run check`   | Validate config, links, and routes |
+| `pnpm run build`   | Static production build → `dist/`  |
+| `pnpm run preview` | Local preview of the build         |
 
 Before deploying, set `site.url` in config for canonical URLs, Open Graph tags, and `sitemap.xml`. Continue with [Routing](/guide/routing) to understand file-based routes, then [Deploy](/guide/deploy) for production build steps.