create-ginko 0.4.0 → 0.5.0

package/templates/starter/app/components/ui/sheet/SheetOverlay.vue

@@ -0,0 +1,22 @@
+<!-- Synced from templates/_features/ui/app/components/ui/sheet/SheetOverlay.vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+import type { DialogOverlayProps } from 'reka-ui'
+import type { HTMLAttributes } from 'vue'
+import { reactiveOmit } from '@vueuse/core'
+import { DialogOverlay } from 'reka-ui'
+import { cn } from '@/lib/utils'
+
+const props = defineProps<DialogOverlayProps & { class?: HTMLAttributes['class'] }>()
+
+const delegatedProps = reactiveOmit(props, 'class')
+</script>
+
+<template>
+  <DialogOverlay
+    data-slot="sheet-overlay"
+    v-bind="delegatedProps"
+    :class="cn('fixed inset-0 z-50 bg-scrim data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:animate-in data-[state=open]:fade-in-0', props.class)"
+  >
+    <slot />
+  </DialogOverlay>
+</template>

package/templates/starter/app/components/ui/sheet/SheetTitle.vue

@@ -0,0 +1,23 @@
+<!-- Synced from templates/_features/ui/app/components/ui/sheet/SheetTitle.vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+import type { DialogTitleProps } from 'reka-ui'
+import type { HTMLAttributes } from 'vue'
+import { reactiveOmit } from '@vueuse/core'
+import { DialogTitle, useForwardProps } from 'reka-ui'
+import { cn } from '@/lib/utils'
+
+const props = defineProps<DialogTitleProps & { class?: HTMLAttributes['class'] }>()
+
+const delegatedProps = reactiveOmit(props, 'class')
+const forwardedProps = useForwardProps(delegatedProps)
+</script>
+
+<template>
+  <DialogTitle
+    data-slot="sheet-title"
+    v-bind="forwardedProps"
+    :class="cn('font-semibold', props.class)"
+  >
+    <slot />
+  </DialogTitle>
+</template>

package/templates/starter/app/components/ui/sheet/SheetTrigger.vue

@@ -0,0 +1,13 @@
+<!-- Synced from templates/_features/ui/app/components/ui/sheet/SheetTrigger.vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+import type { DialogTriggerProps } from 'reka-ui'
+import { DialogTrigger } from 'reka-ui'
+
+const props = defineProps<DialogTriggerProps>()
+</script>
+
+<template>
+  <DialogTrigger data-slot="sheet-trigger" v-bind="props">
+    <slot />
+  </DialogTrigger>
+</template>

package/templates/starter/app/components/ui/sheet/index.ts

@@ -0,0 +1,7 @@
+// Synced from templates/_features/ui/app/components/ui/sheet/index.ts by `pnpm templates sync`. Edit the source, not this copy.
+export { default as Sheet } from './Sheet.vue'
+export { default as SheetClose } from './SheetClose.vue'
+export { default as SheetContent } from './SheetContent.vue'
+export { default as SheetDescription } from './SheetDescription.vue'
+export { default as SheetTitle } from './SheetTitle.vue'
+export { default as SheetTrigger } from './SheetTrigger.vue'

package/templates/starter/app/composables/usePageSeo.ts

@@ -0,0 +1,50 @@
+// Synced from templates/_features/site/app/composables/usePageSeo.ts by `pnpm templates sync`. Edit the source, not this copy.
+import { breadcrumbJsonLd } from '@lupinum/ginko'
+import { siteJsonLd } from '@lupinum/ginko/basics'
+
+export interface PageSeoInput {
+  title?: string
+  description?: string
+  image?: GinkoSeoInput['image']
+  /** The home page: the organisation from the `site` brick instead of WebPage and BreadcrumbList. */
+  home?: boolean
+  /** Home page: more properties of the organisation, which win over those from content/site.md (a subtype such as
+   *  `Restaurant`, opening hours, a menu). */
+  organization?: Record<string, unknown>
+  /** Keeps the page out of search engines (a print version). */
+  noindex?: boolean
+  /** More JSON-LD for this page, for example a FAQPage. */
+  jsonLd?: Record<string, unknown>[]
+}
+
+/**
+ * Title, description, share card and JSON-LD of a page (useGinkoSeo). The home page describes the organisation
+ * (Organization, LocalBusiness or NGO from app.config.ts, with address and contact from content/site.md and the
+ * country from ginko.config.ts); every other page is a WebPage with a BreadcrumbList from home to itself.
+ */
+export function usePageSeo(input: () => PageSeoInput) {
+  const site = useGinko('site')
+  const config = useSiteAppConfig()
+  const { name, url } = useGinkoSite()
+  const route = useRoute()
+  const path = useGinkoPath()
+  const { t, language } = useI18n('site')
+  const absolute = (p: string) => new URL(p, url).href
+  useGinkoSeo(() => {
+    const page = input()
+    const own = page.jsonLd ?? []
+    if (page.home) {
+      const organization = siteJsonLd(site.value.data, {
+        name,
+        url,
+        type: config.organization,
+        logo: config.logo ? absolute(config.logo.src) : undefined,
+        sameAs: config.socials.map((social) => social.url),
+      })
+      return { title: page.title, description: page.description, image: page.image, noindex: page.noindex, jsonLd: [{ ...organization, ...page.organization }, ...own] }
+    }
+    const webPage = { '@context': 'https://schema.org', '@type': 'WebPage', name: page.title, url: absolute(route.path), description: page.description, inLanguage: language.value }
+    const breadcrumbs = breadcrumbJsonLd([{ title: t('home'), path: path('home') }, { title: page.title ?? name, path: route.path }], url)
+    return { title: page.title, description: page.description, image: page.image, noindex: page.noindex, jsonLd: [webPage, breadcrumbs, ...own] }
+  })
+}

package/templates/starter/app/composables/useSiteAppConfig.ts

@@ -0,0 +1,79 @@
+// Synced from templates/_features/site/app/composables/useSiteAppConfig.ts by `pnpm templates sync`. Edit the source, not this copy.
+/** A navigation item: a collection entry by id (`pages/about`, title and address from the content), a page of
+ *  `pages` in ginko.config.ts with its label per language, or an address on another site (`url`, for example the
+ *  sign-in of an app) with its label per language. */
+export type SiteNavItem = { entry: string } | { page: string, label: Record<string, string> } | { url: string, label: Record<string, string> }
+
+/** `site` in app/app.config.ts: the brand and navigation of the template. Name, address and contact come from
+ *  ginko.config.ts (`name`) and the `site` brick (content/site.md). */
+export interface SiteAppConfig {
+  /** Shown instead of the name in the header on phones. Default: the name from ginko.config.ts. */
+  shortName?: string
+  /** A logo file in public/ with its size in pixels. Without it, the header shows the name. */
+  logo?: { src: string, width: number, height: number }
+  /** One line under the name in the footer, per language code: `{ en: '…', de: '…' }`. A language without one shows none. */
+  tagline?: Record<string, string>
+  /** The schema.org type of the organisation on the home page. */
+  organization: 'Organization' | 'LocalBusiness' | 'NGO'
+  /** The header navigation: at most 6 items. The footer repeats it. */
+  nav: SiteNavItem[]
+  /** More links in the footer, for example a newsletter page. */
+  footer: SiteNavItem[]
+  /** Profiles elsewhere, as text links in the footer (no third-party icons or scripts). */
+  socials: { label: string, url: string }[]
+  /** Whether the site's prices include VAT: `excluded` for net prices to businesses ("Price (plus VAT)"), `included`
+   *  for prices to consumers. Price labels and the price's JSON-LD say so. Default: no VAT note. */
+  vat?: 'included' | 'excluded'
+}
+
+/** The collection keys useGinkoNav takes. */
+type NavBricks = Extract<Parameters<typeof useGinkoNav>[0], readonly unknown[]>
+
+/** The `site` part of app.config.ts. */
+export function useSiteAppConfig(): SiteAppConfig {
+  return useAppConfig().site
+}
+
+/** Entries already reported as missing, so the log names each one once. */
+const reported = new Set<string>()
+const overLimit = '\0over-limit'
+
+/** The items of a navigation list with their label and path in the current language. An entry that does not exist
+ *  in this language (untranslated or removed) is left out; one missing in the main language is also reported in the
+ *  dev server and build log, because it is a typo or a deleted file. With `limit`, a longer list is reported once
+ *  too (the header holds 6 links; the rest stay in the menu). */
+export function useSiteLinks(items: () => SiteNavItem[], limit?: number) {
+  const path = useGinkoPath()
+  const locale = useGinkoLocale()
+  const { mainLocale } = useGinkoSite()
+  // useGinkoNav takes the site's collection keys; the ids in app.config.ts are plain strings (`pages/about`), and a
+  // key that is no collection of this site is skipped by it.
+  const tree = useGinkoNav(() => [...new Set(items().flatMap((item) => ('entry' in item ? [item.entry.split('/')[0]!] : [])))] as NavBricks)
+  return computed(() => {
+    if (import.meta.server && limit && !reported.has(overLimit) && items().length > limit) {
+      reported.add(overLimit)
+      console.warn(`[site] app/app.config.ts has ${items().length} navigation entries; the header holds ${limit}, so the menu stays in the sheet.`)
+    }
+    const byId = new Map<string, { title: string, path: string }>()
+    const walk = (nodes: typeof tree.value) => nodes.forEach((node) => {
+      if (node.id) byId.set(node.id, node)
+      walk(node.children)
+    })
+    walk(tree.value)
+    return items().flatMap((item) => {
+      if ('entry' in item) {
+        const node = byId.get(item.entry)
+        if (node) return [{ key: item.entry, label: node.title, to: node.path }]
+        // An empty tree is content not loaded yet, not a missing entry.
+        if (import.meta.server && locale.value === mainLocale && tree.value.length > 0 && !reported.has(item.entry)) {
+          reported.add(item.entry)
+          console.warn(`[site] The navigation entry “${item.entry}” in app/app.config.ts matches no file in content/, so it is left out. An id is the folder and the file name without number: content/pages/1.about.md is pages/about.`)
+        }
+        return []
+      }
+      const label = item.label[locale.value] ?? item.label[mainLocale]
+      if (!label) return []
+      return 'url' in item ? [{ key: item.url, label, to: item.url }] : [{ key: item.page, label, to: path(item.page as GinkoPageKey) }]
+    })
+  })
+}

package/templates/starter/app/error.vue

@@ -0,0 +1,35 @@
+<!-- Synced from templates/_features/site/app/error.vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+import type { NuxtError } from '#app'
+
+// 404 and other errors, in the site's layout and language, never indexed. The way out is the home page.
+const props = defineProps<{ error: NuxtError }>()
+const { t } = useI18n('site')
+const path = useGinkoPath()
+const notFound = computed(() => props.error.statusCode === 404)
+const title = computed(() => (notFound.value ? t('error.notFound') : t('error.failed')))
+// The title through seo.titleTemplate of ginko.config.ts, like every other page.
+useGinkoSeo(() => ({ title: title.value, noindex: true }))
+
+/** Leaves the error state, so the next page renders normally. */
+function home() {
+  clearError({ redirect: path('home') })
+}
+</script>
+
+<template>
+  <NuxtLayout>
+    <div class="mx-auto max-w-page px-gutter pt-12 md:pt-20">
+      <div class="flex max-w-3xl flex-col gap-5">
+        <p class="text-small font-medium text-muted-foreground tabular-nums">{{ t('error.code', { code: String(error.statusCode) }) }}</p>
+        <h1 class="text-h1">{{ title }}</h1>
+        <p class="text-lead text-muted-foreground">{{ notFound ? t('error.notFoundText') : t('error.failedText') }}</p>
+        <div class="mt-2">
+          <Button as-child size="lg">
+            <a :href="path('home')" @click.prevent="home">{{ t('error.home') }}</a>
+          </Button>
+        </div>
+      </div>
+    </div>
+  </NuxtLayout>
+</template>

package/templates/starter/app/layouts/default.vue

@@ -0,0 +1,23 @@
+<!-- Synced from templates/_features/site/app/layouts/default.vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+import { ConfigProvider } from 'reka-ui'
+
+// Every page: skip link, notices, header, content, footer. Reka's ConfigProvider gives its parts (sheet, menus,
+// accordion) the text direction of the language, so arrows and the sheet's side follow right-to-left languages.
+const { locale, locales } = useI18n()
+const dir = computed(() => locales.find((l) => l.code === locale.value)?.dir ?? 'ltr')
+</script>
+
+<template>
+  <ConfigProvider :dir="dir">
+    <div class="flex min-h-dvh flex-col">
+      <SiteSkipLink />
+      <SiteNotice />
+      <SiteHeader />
+      <main id="main" tabindex="-1" class="flex-1 focus-visible:outline-none">
+        <slot />
+      </main>
+      <SiteFooter />
+    </div>
+  </ConfigProvider>
+</template>

package/templates/starter/app/lib/utils.ts

@@ -0,0 +1,26 @@
+// Synced from templates/_features/ui/app/lib/utils.ts by `pnpm templates sync`. Edit the source, not this copy.
+import type { ClassValue } from 'clsx'
+import { clsx } from 'clsx'
+import { extendTailwindMerge } from 'tailwind-merge'
+
+/**
+ * tailwind-merge, told about the theme of tokens.css. Without it, `text-small` reads as a colour and `p-gutter` or
+ * `max-w-page` as unknown, so a conflicting class would not replace the component's own.
+ */
+const twMerge = extendTailwindMerge({
+  extend: {
+    theme: {
+      text: ['h1', 'h2', 'h3', 'lead', 'body', 'small', 'xs'],
+      font: ['display'],
+      radius: ['block'],
+      shadow: ['overlay'],
+      spacing: ['section', 'gutter'],
+      container: ['page', 'prose'],
+    },
+  },
+})
+
+/** Joins class names (strings, arrays, `{ class: condition }`); a later class wins over a conflicting earlier one. */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/templates/starter/app/pages/[...slug].vue

@@ -0,0 +1,36 @@
+<!-- Synced from templates/_features/pages/app/pages/[...slug].vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+import type { Component } from 'vue'
+import { safeHref } from '@lupinum/ginko'
+
+// A page of content/pages/ at /<slug> (in other languages /<code>/<slug>). An unknown address is a real 404.
+// A template can show more at the top of its pages with app/components/pages/Top.vue (prop `id`: the entry id, such
+// as `pages/get-involved`); without that file, nothing is added.
+const route = useRoute()
+const page = useGinkoEntry('pages', () => route.params.slug)
+const PagesTop = Object.values(import.meta.glob<Component>('~/components/pages/Top.vue', { eager: true, import: 'default' }))[0]
+const action = computed(() => {
+  const href = safeHref(page.value.data.actionUrl)
+  return href && page.value.data.actionLabel ? { label: page.value.data.actionLabel, href } : undefined
+})
+usePageSeo(() => ({
+  title: page.value.data.title,
+  description: page.value.data.summary,
+  image: page.value.data.image,
+}))
+</script>
+
+<template>
+  <article>
+    <BlockPageHeader :title="page.data.title" :lead="page.data.summary">
+      <Button v-if="action" as-child size="lg" class="self-start max-sm:self-stretch">
+        <a :href="action.href">{{ action.label }}</a>
+      </Button>
+    </BlockPageHeader>
+    <component :is="PagesTop" v-if="PagesTop" :id="page.id" />
+    <div v-if="page.data.image" class="mx-auto max-w-page px-gutter pb-10">
+      <GinkoImage :image="page.data.image" eager sizes="(min-width: 1216px) 1152px, 100vw" class="aspect-video w-full rounded-block bg-muted object-cover" />
+    </div>
+    <ProseBody :value="page.data.body" />
+  </article>
+</template>

package/templates/starter/app/pages/index.vue

@@ -0,0 +1,24 @@
+<script setup lang="ts">
+// The home page: the hero from content/home.md, its text, and the pages of content/pages/ as cards.
+const home = useGinko('home')
+const pages = useGinko('pages')
+const locale = useGinkoLocale()
+const { t } = useI18n()
+const links = useSiteLinks(() => [{ entry: 'pages/contact' }, { entry: 'pages/about' }])
+const link = (key: string) => links.value.find((l) => l.key === key)
+const cards = computed(() => pages.value.items.map((page) => ({ key: page.id, title: page.data.title, text: page.data.summary, to: page.urls?.[locale.value] ?? '' })))
+usePageSeo(() => ({ home: true, description: home.value.data.lead }))
+</script>
+
+<template>
+  <div>
+    <BlockHero :title="home.data.title" :lead="home.data.lead" :primary="link('pages/contact')" :secondary="link('pages/about')" />
+    <div v-if="home.data.body" class="pt-section">
+      <ProseBody :value="home.data.body" />
+    </div>
+    <BlockSection :title="t('home.more')" :side="false">
+      <BlockCards v-if="cards.length" :items="cards" :columns="2" />
+      <BlockEmpty v-else :title="t('home.empty')" path="content/pages/" />
+    </BlockSection>
+  </div>
+</template>

package/templates/starter/app/pages/legal/[slug].vue

@@ -0,0 +1,46 @@
+<!-- Synced from templates/_features/site/app/pages/legal/[slug].vue by `pnpm templates sync`. Edit the source, not this copy. -->
+<script setup lang="ts">
+// One legal text (content/legal/): privacy policy, terms, imprint. Address: /legal/<slug> in every language.
+// The imprint starts with the details of content/site.md (name, address, register, VAT number, email, phone), so the
+// owner writes them once; the text below adds what site.md cannot hold. A detail site.md does not have is left out.
+// Email and phone are links (mailto:, tel:), like on the contact page.
+const route = useRoute()
+const entry = useGinkoEntry('legal', () => route.params.slug)
+const site = useGinko('site')
+const { t, format } = useI18n('site')
+const details = computed(() => {
+  const d = site.value.data
+  if (entry.value.data.legalType !== 'imprint') return []
+  const rows: { label: string, value?: string, href?: string }[] = [
+    { label: t('imprint.address'), value: [d.legalName, d.street, d.city ? `${d.postalCode ?? ''} ${d.city}` : undefined].filter(Boolean).join('\n') },
+    { label: t('imprint.registry'), value: [d.registryCourt, d.registryNumber].filter(Boolean).join(', ') },
+    { label: t('imprint.vat'), value: d.vatId },
+    { label: t('imprint.email'), value: d.email, href: d.email ? `mailto:${d.email}` : undefined },
+    { label: t('imprint.phone'), value: d.phone, href: d.phone ? telHref(d.phone) : undefined },
+  ]
+  return rows.filter((row) => row.value)
+})
+usePageSeo(() => ({ title: entry.value.data.title, description: entry.value.data.description }))
+</script>
+
+<template>
+  <div>
+    <BlockPageHeader
+      :title="entry.data.title"
+      :lead="entry.data.description"
+      :meta="t('updated', { date: format.date(entry.data.updatedAt) })"
+    />
+    <!-- Each value keeps the direction of its own text (bdi), as in the footer. A link gets its 44 px tap height from
+         padding with a negative margin, so it stays on its label's line. -->
+    <dl v-if="details.length" class="mx-auto grid max-w-page gap-x-8 gap-y-1 px-gutter pb-10 sm:grid-cols-[auto_1fr] sm:gap-y-3">
+      <template v-for="row in details" :key="row.label">
+        <dt class="text-small text-muted-foreground max-sm:not-first:mt-3">{{ row.label }}</dt>
+        <dd class="whitespace-pre-line">
+          <a v-if="row.href" :href="row.href" dir="ltr" class="-my-2.5 inline-block py-2.5 underline underline-offset-4">{{ row.value }}</a>
+          <bdi v-else>{{ row.value }}</bdi>
+        </dd>
+      </template>
+    </dl>
+    <ProseBody :value="entry.data.body" />
+  </div>
+</template>

package/templates/starter/app/routes.ts

@@ -0,0 +1,14 @@
+// The languages of this site and the web address of each page per language (TEMPLATES T8). The first language is
+// the main one: its addresses have no prefix, the others start with /<code>. `npm create ginko -- --locales` edits
+// the `locales` list; a map of slugs per language added here loses the entries of dropped languages too.
+export const locales = ['en', 'de'] as const
+export type SiteLocale = (typeof locales)[number]
+
+/** The path prefix of a language: none for the main language, `/de` for German as a second language. */
+export const prefix = (locale: SiteLocale) => (locale === locales[0] ? '' : `/${locale}`)
+
+/** One address per language from a path in the main language's form: `localized('/legal/[slug]')`. */
+export function localized<const P extends `/${string}`>(path: P): Record<SiteLocale, P | `/${string}${P}`> {
+  // Object.fromEntries loses the key and value types; the keys are exactly `locales`, the values `path` with a prefix.
+  return Object.fromEntries(locales.map((locale) => [locale, String(path) === '/' ? prefix(locale) || '/' : `${prefix(locale)}${path}`])) as Record<SiteLocale, P | `/${string}${P}`>
+}

package/templates/starter/app/utils/telHref.ts

@@ -0,0 +1,3 @@
+// Synced from templates/_features/site/app/utils/telHref.ts by `pnpm templates sync`. Edit the source, not this copy.
+/** The `tel:` link for a phone number written for people ("+49 30 1234"): only digits and "+" are kept. */
+export const telHref = (phone: string) => `tel:${phone.replace(/[^\d+]/g, '')}`

package/templates/starter/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://shadcn-vue.com/schema.json",
+  "style": "new-york",
+  "typescript": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/assets/css/main.css",
+    "baseColor": "zinc",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "composables": "@/composables",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib"
+  },
+  "registries": {}
+}

package/templates/starter/content/home.de.md

@@ -0,0 +1,16 @@
+---
+# This page is content/home.de.md, the German version of content/home.md. The README explains how to change texts.
+title: Übersetzungen, die sich lesen wie das Original
+lead: Ich übersetze zwischen Deutsch und Englisch für Museen, Forschungsinstitute und Verlage.
+---
+
+## Was ich übersetze
+
+- Ausstellungs- und Katalogtexte für Museen und Galerien
+- Fachartikel, Förderanträge und Projektberichte
+- Sachbücher und Essays
+
+## So läuft es ab
+
+Schicken Sie mir den Text und sagen Sie mir, wo er erscheinen wird. Innerhalb von zwei Werktagen bekommen Sie einen
+Festpreis und einen Liefertermin. Jede Übersetzung lese ich ein zweites Mal, bevor sie zu Ihnen geht.

package/templates/starter/content/home.md

@@ -0,0 +1,16 @@
+---
+# This page is content/home.md. The README explains how to change texts, name, menu and colours.
+title: Translations that read like the original
+lead: I translate between German and English for museums, research institutes and publishers.
+---
+
+## What I translate
+
+- Exhibition and catalogue texts for museums and galleries
+- Research papers, grant applications and project reports
+- Non-fiction books and essays
+
+## How it works
+
+Send me the text and tell me where it will appear. Within two working days you get a fixed price and a delivery
+date. Every translation is read a second time before it goes to you.

package/templates/starter/content/legal/1.privacy.de.md

@@ -0,0 +1,28 @@
+---
+# Ersetzen Sie den Text unten durch Ihre eigene Datenschutzerklärung. Welche Regeln gelten, hängt von Ihrem Land und
+# davon ab, was Ihre Website tut. Fragen Sie im Zweifel eine Anwältin, einen Anwalt oder eine Datenschutzberatung.
+title: Datenschutzerklärung
+description: Wie diese Website mit personenbezogenen Daten umgeht.
+slug: datenschutz
+---
+
+> **Platzhalter:** Text aus der Vorlage, keine Rechtsberatung. Ersetzen Sie ihn, bevor die Website online geht.
+
+## Was diese Website ohne Änderungen tut
+
+So wie sie aus der Vorlage kommt, gilt für diese Website:
+
+- Sie setzt nur dann ein Cookie, wenn Sie die Sprache wechseln (`ginko_locale`, es merkt sich Ihre Wahl ein Jahr lang), und speichert sonst nichts in Ihrem Browser außer Ihrer Wahl zwischen hellem und dunklem Design.
+- Sie misst keine Besuche und lädt nichts von anderen Unternehmen: Schriften und Bilder kommen von dieser Website selbst.
+- Sie hat kein Kontaktformular; E-Mail-Links öffnen Ihr eigenes E-Mail-Programm.
+
+Der Server, auf dem die Website läuft, speichert jede Anfrage (Adresse, Zeit, Seite, Browser) in seinen Protokollen.
+Nennen Sie Ihren Hoster und wie lange er diese Protokolle aufbewahrt.
+
+## Verantwortlich
+
+Name, Anschrift und Kontakt der Person oder Organisation, die für diese Website verantwortlich ist.
+
+## Ihre Rechte
+
+Erklären Sie, wie man erfährt, welche Daten Sie speichern, und wie man sie berichtigen oder löschen lässt.

package/templates/starter/content/legal/1.privacy.md

@@ -0,0 +1,29 @@
+---
+# Replace the text below with your own privacy policy before the site goes live. Which rules apply depends on
+# your country and on what your site does. If you are unsure, ask a lawyer or a data protection advisor.
+title: Privacy policy
+description: How this website handles personal data.
+legalType: privacy
+updatedAt: 2026-10-15
+---
+
+> **Placeholder:** template text, not legal advice. Replace it before the site goes live.
+
+## What this website does out of the box
+
+As it comes from the template, this website:
+
+- sets one cookie only when you switch the language (`ginko_locale`, which keeps your choice for a year), and otherwise stores nothing in your browser except your choice of light or dark mode;
+- runs no analytics and loads nothing from other companies: fonts and images come from this website itself;
+- has no contact form; email links open your own email program.
+
+The server that hosts the website records each request (address, time, page, browser) in its logs. Name your host
+and how long it keeps these logs.
+
+## Who is responsible
+
+Name, address and contact of the person or organisation responsible for this website.
+
+## Your rights
+
+Explain how people can ask what data you hold about them, and have it corrected or deleted.

package/templates/starter/content/legal/2.terms.de.md

@@ -0,0 +1,21 @@
+---
+# Ersetzen Sie den Text unten durch Ihre eigenen Bedingungen, oder löschen Sie content/legal/2.terms.de.md und
+# 2.terms.md, wenn Sie nichts verkaufen und keine brauchen.
+title: Allgemeine Geschäftsbedingungen
+description: Die Bedingungen, die gelten, wenn Sie diese Website nutzen oder bei uns kaufen.
+slug: agb
+---
+
+> **Platzhalter:** Text aus der Vorlage, keine Rechtsberatung. Ersetzen Sie ihn, bevor die Website online geht.
+
+## Geltungsbereich
+
+Sagen Sie, für wen und wofür diese Bedingungen gelten.
+
+## Vertrag und Zahlung
+
+Sagen Sie, wie ein Vertrag zustande kommt, wie und wann man bezahlt und wie man kündigt.
+
+## Haftung
+
+Sagen Sie, wofür Sie haften, in den Grenzen des Rechts Ihres Landes.

package/templates/starter/content/legal/2.terms.md

@@ -0,0 +1,22 @@
+---
+# Replace the text below with your own terms, or delete content/legal/2.terms.md and its translations if you sell
+# nothing and need none.
+title: Terms and conditions
+description: The terms that apply when you use this website or buy from us.
+legalType: terms
+updatedAt: 2026-10-15
+---
+
+> **Placeholder:** template text, not legal advice. Replace it before the site goes live.
+
+## Scope
+
+Say to whom and to what these terms apply.
+
+## Contract and payment
+
+Say how a contract comes about, how and when people pay, and how they can cancel.
+
+## Liability
+
+Say what you are liable for, within the limits of the law in your country.

package/templates/starter/content/legal/3.imprint.de.md

@@ -0,0 +1,16 @@
+---
+# In Deutschland und Österreich brauchen geschäftliche Websites ein Impressum. Die Angaben über dem Text kommen aus
+# content/site.md: Tragen Sie dort Name, Anschrift, Telefon, Register und Umsatzsteuer-ID ein (legalName, street,
+# postalCode, city, phone, registryCourt, registryNumber, vatId). Ersetzen Sie den Text unten durch das, was Ihr Land
+# sonst verlangt, oder löschen Sie content/legal/3.imprint.de.md und 3.imprint.md, wenn Ihr Land kein Impressum
+# verlangt.
+title: Impressum
+description: Wer diese Website betreibt.
+slug: impressum
+---
+
+> **Platzhalter:** Text aus der Vorlage, keine Rechtsberatung. Ersetzen Sie ihn, bevor die Website online geht.
+
+## Weitere Angaben
+
+Nur das, was für Sie gilt, zum Beispiel die Aufsichtsbehörde oder die Berufskammer.

package/templates/starter/content/legal/3.imprint.md

@@ -0,0 +1,16 @@
+---
+# Many countries (for example Germany and Austria) require an imprint for business websites. The details above the text
+# come from content/site.md: add name, address, phone, register and VAT number there (legalName, street, postalCode,
+# city, phone, registryCourt, registryNumber, vatId). Replace the text below with what else your country requires, or
+# delete content/legal/3.imprint.md and its translations if your country does not require an imprint.
+title: Imprint
+description: Who runs this website.
+legalType: imprint
+updatedAt: 2026-10-15
+---
+
+> **Placeholder:** template text, not legal advice. Replace it before the site goes live.
+
+## More details
+
+Only what applies to you, for example the supervisory authority or the professional chamber.

package/templates/starter/content/notices/1.welcome.de.md

@@ -0,0 +1,4 @@
+---
+# The German version of the notice; only `text` is translated, `until` comes from the main-language file.
+text: "Neu: Ich übersetze jetzt auch aus dem Französischen."
+---

package/templates/starter/content/notices/1.welcome.md

@@ -0,0 +1,5 @@
+---
+# A notice: short news above the header, for example a closed day. It leaves the site after its end date (`until`).
+text: "New: I now also translate from French."
+until: 2027-01-29
+---