@kamod-ch/preactpress 1.0.0 → 1.0.2
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.
- package/README.md +87 -49
- package/bin/preactpress.mjs +5 -5
- package/dist/client/app.d.ts +1 -1
- package/dist/client/app.d.ts.map +1 -1
- package/dist/client/app.js +34 -38
- package/dist/client/app.js.map +1 -1
- package/dist/client/entry-client.js +11 -12
- package/dist/client/entry-client.js.map +1 -1
- package/dist/client/entry-ssr.d.ts +2 -2
- package/dist/client/entry-ssr.d.ts.map +1 -1
- package/dist/client/entry-ssr.js +16 -16
- package/dist/client/entry-ssr.js.map +1 -1
- package/dist/client/index.d.ts +3 -2
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +2 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/loadPage.d.ts +1 -1
- package/dist/client/loadPage.d.ts.map +1 -1
- package/dist/client/loadPage.js +12 -12
- package/dist/client/loadPage.js.map +1 -1
- package/dist/client/prefetchLinks.js +4 -4
- package/dist/client/prefetchLinks.js.map +1 -1
- package/dist/client/theme-default/AlgoliaSearch.d.ts +3 -3
- package/dist/client/theme-default/AlgoliaSearch.d.ts.map +1 -1
- package/dist/client/theme-default/AlgoliaSearch.js +15 -15
- package/dist/client/theme-default/AlgoliaSearch.js.map +1 -1
- package/dist/client/theme-default/Features.d.ts +2 -2
- package/dist/client/theme-default/Features.d.ts.map +1 -1
- package/dist/client/theme-default/Features.js +10 -8
- package/dist/client/theme-default/Features.js.map +1 -1
- package/dist/client/theme-default/Hero.d.ts +2 -2
- package/dist/client/theme-default/Hero.d.ts.map +1 -1
- package/dist/client/theme-default/Hero.js +9 -7
- package/dist/client/theme-default/Hero.js.map +1 -1
- package/dist/client/theme-default/Layout.d.ts +3 -3
- package/dist/client/theme-default/Layout.d.ts.map +1 -1
- package/dist/client/theme-default/Layout.js +56 -99
- package/dist/client/theme-default/Layout.js.map +1 -1
- package/dist/client/theme-default/Logo.d.ts +2 -2
- package/dist/client/theme-default/Logo.d.ts.map +1 -1
- package/dist/client/theme-default/Logo.js +8 -8
- package/dist/client/theme-default/Logo.js.map +1 -1
- package/dist/client/theme-default/NavLinks.d.ts +2 -2
- package/dist/client/theme-default/NavLinks.d.ts.map +1 -1
- package/dist/client/theme-default/NavLinks.js +3 -3
- package/dist/client/theme-default/NavLinks.js.map +1 -1
- package/dist/client/theme-default/SidebarNav.d.ts +2 -2
- package/dist/client/theme-default/SidebarNav.d.ts.map +1 -1
- package/dist/client/theme-default/SidebarNav.js +3 -3
- package/dist/client/theme-default/SidebarNav.js.map +1 -1
- package/dist/client/theme-default/SocialLinks.d.ts +2 -2
- package/dist/client/theme-default/SocialLinks.d.ts.map +1 -1
- package/dist/client/theme-default/SocialLinks.js +1 -1
- package/dist/client/theme-default/SocialLinks.js.map +1 -1
- package/dist/client/theme-default/ThemeToggle.d.ts +2 -3
- package/dist/client/theme-default/ThemeToggle.d.ts.map +1 -1
- package/dist/client/theme-default/ThemeToggle.js +2 -30
- package/dist/client/theme-default/ThemeToggle.js.map +1 -1
- package/dist/client/theme-default/index.d.ts +1 -1
- package/dist/client/theme-default/index.d.ts.map +1 -1
- package/dist/client/theme-default/index.js +1 -1
- package/dist/client/theme-default/index.js.map +1 -1
- package/dist/client/theme-utils.d.ts +24 -0
- package/dist/client/theme-utils.d.ts.map +1 -0
- package/dist/client/theme-utils.js +107 -0
- package/dist/client/theme-utils.js.map +1 -0
- package/dist/client/types.d.ts +5 -5
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/usePageHead.d.ts +2 -2
- package/dist/client/usePageHead.d.ts.map +1 -1
- package/dist/client/usePageHead.js +61 -56
- package/dist/client/usePageHead.js.map +1 -1
- package/dist/client/useSiteSearch.d.ts.map +1 -1
- package/dist/client/useSiteSearch.js +8 -8
- package/dist/client/useSiteSearch.js.map +1 -1
- package/dist/node/build.d.ts +1 -1
- package/dist/node/build.d.ts.map +1 -1
- package/dist/node/build.js +105 -96
- package/dist/node/build.js.map +1 -1
- package/dist/node/buildCache.d.ts.map +1 -1
- package/dist/node/buildCache.js +7 -7
- package/dist/node/buildCache.js.map +1 -1
- package/dist/node/check.d.ts +1 -1
- package/dist/node/check.d.ts.map +1 -1
- package/dist/node/check.js +52 -52
- package/dist/node/check.js.map +1 -1
- package/dist/node/cli.js +61 -64
- package/dist/node/cli.js.map +1 -1
- package/dist/node/config-helpers.d.ts +4 -4
- package/dist/node/config-helpers.d.ts.map +1 -1
- package/dist/node/config-helpers.js +1 -1
- package/dist/node/config-helpers.js.map +1 -1
- package/dist/node/config.d.ts +4 -4
- package/dist/node/config.d.ts.map +1 -1
- package/dist/node/config.js +37 -40
- package/dist/node/config.js.map +1 -1
- package/dist/node/content.d.ts +4 -4
- package/dist/node/content.d.ts.map +1 -1
- package/dist/node/content.js +28 -28
- package/dist/node/content.js.map +1 -1
- package/dist/node/createContentLoader.d.ts +1 -1
- package/dist/node/createContentLoader.d.ts.map +1 -1
- package/dist/node/createContentLoader.js +3 -3
- package/dist/node/createContentLoader.js.map +1 -1
- package/dist/node/devCss.d.ts +1 -1
- package/dist/node/devCss.d.ts.map +1 -1
- package/dist/node/devCss.js +5 -6
- package/dist/node/devCss.js.map +1 -1
- package/dist/node/devSsr.d.ts +3 -3
- package/dist/node/devSsr.d.ts.map +1 -1
- package/dist/node/devSsr.js +32 -32
- package/dist/node/devSsr.js.map +1 -1
- package/dist/node/dynamicRoutes.d.ts +2 -2
- package/dist/node/dynamicRoutes.d.ts.map +1 -1
- package/dist/node/dynamicRoutes.js +24 -24
- package/dist/node/dynamicRoutes.js.map +1 -1
- package/dist/node/favicon.d.ts +2 -2
- package/dist/node/favicon.d.ts.map +1 -1
- package/dist/node/favicon.js +26 -24
- package/dist/node/favicon.js.map +1 -1
- package/dist/node/feed.d.ts +2 -2
- package/dist/node/feed.d.ts.map +1 -1
- package/dist/node/feed.js +18 -16
- package/dist/node/feed.js.map +1 -1
- package/dist/node/hooks.d.ts +2 -2
- package/dist/node/hooks.d.ts.map +1 -1
- package/dist/node/hooks.js +1 -1
- package/dist/node/hooks.js.map +1 -1
- package/dist/node/html.d.ts +8 -8
- package/dist/node/html.d.ts.map +1 -1
- package/dist/node/html.js +75 -64
- package/dist/node/html.js.map +1 -1
- package/dist/node/index.d.ts +11 -11
- package/dist/node/index.d.ts.map +1 -1
- package/dist/node/index.js +8 -8
- package/dist/node/index.js.map +1 -1
- package/dist/node/init.d.ts +2 -0
- package/dist/node/init.d.ts.map +1 -1
- package/dist/node/init.js +59 -27
- package/dist/node/init.js.map +1 -1
- package/dist/node/lastUpdated.d.ts +2 -2
- package/dist/node/lastUpdated.d.ts.map +1 -1
- package/dist/node/lastUpdated.js +7 -4
- package/dist/node/lastUpdated.js.map +1 -1
- package/dist/node/loadSiteModule.js +2 -2
- package/dist/node/loadSiteModule.js.map +1 -1
- package/dist/node/markdown.d.ts +2 -2
- package/dist/node/markdown.d.ts.map +1 -1
- package/dist/node/markdown.js +110 -110
- package/dist/node/markdown.js.map +1 -1
- package/dist/node/markdownHeadings.d.ts +1 -1
- package/dist/node/markdownHeadings.d.ts.map +1 -1
- package/dist/node/markdownHeadings.js +11 -11
- package/dist/node/markdownHeadings.js.map +1 -1
- package/dist/node/markdownInclude.d.ts.map +1 -1
- package/dist/node/markdownInclude.js +11 -11
- package/dist/node/markdownInclude.js.map +1 -1
- package/dist/node/markdownSnippets.d.ts.map +1 -1
- package/dist/node/markdownSnippets.js +34 -34
- package/dist/node/markdownSnippets.js.map +1 -1
- package/dist/node/mdx.d.ts +1 -1
- package/dist/node/mdx.d.ts.map +1 -1
- package/dist/node/mdx.js +4 -4
- package/dist/node/mdx.js.map +1 -1
- package/dist/node/packageRoot.d.ts.map +1 -1
- package/dist/node/packageRoot.js +4 -4
- package/dist/node/packageRoot.js.map +1 -1
- package/dist/node/pageDataLoaders.d.ts +2 -2
- package/dist/node/pageDataLoaders.d.ts.map +1 -1
- package/dist/node/pageDataLoaders.js +24 -20
- package/dist/node/pageDataLoaders.js.map +1 -1
- package/dist/node/paths.d.ts.map +1 -1
- package/dist/node/paths.js +4 -4
- package/dist/node/paths.js.map +1 -1
- package/dist/node/plugin.d.ts +3 -3
- package/dist/node/plugin.d.ts.map +1 -1
- package/dist/node/plugin.js +66 -66
- package/dist/node/plugin.js.map +1 -1
- package/dist/node/resolveDeps.js +10 -10
- package/dist/node/resolveDeps.js.map +1 -1
- package/dist/node/serve.d.ts.map +1 -1
- package/dist/node/serve.js +13 -15
- package/dist/node/serve.js.map +1 -1
- package/dist/node/server.d.ts +3 -3
- package/dist/node/server.d.ts.map +1 -1
- package/dist/node/server.js +28 -25
- package/dist/node/server.js.map +1 -1
- package/dist/node/siteConfig.d.ts +12 -12
- package/dist/node/siteConfig.d.ts.map +1 -1
- package/dist/node/tagIndex.d.ts +5 -5
- package/dist/node/tagIndex.d.ts.map +1 -1
- package/dist/node/tagIndex.js +10 -10
- package/dist/node/tagIndex.js.map +1 -1
- package/dist/shared/contentChunk.d.ts.map +1 -1
- package/dist/shared/contentChunk.js +6 -6
- package/dist/shared/contentChunk.js.map +1 -1
- package/dist/shared/contentSchema.d.ts.map +1 -1
- package/dist/shared/contentSchema.js +11 -11
- package/dist/shared/contentSchema.js.map +1 -1
- package/dist/shared/deadLinks.d.ts.map +1 -1
- package/dist/shared/deadLinks.js +6 -6
- package/dist/shared/deadLinks.js.map +1 -1
- package/dist/shared/escapeHtml.js +4 -4
- package/dist/shared/escapeHtml.js.map +1 -1
- package/dist/shared/index.d.ts +14 -14
- package/dist/shared/index.d.ts.map +1 -1
- package/dist/shared/index.js +14 -14
- package/dist/shared/index.js.map +1 -1
- package/dist/shared/locale.d.ts +1 -1
- package/dist/shared/locale.d.ts.map +1 -1
- package/dist/shared/locale.js +10 -10
- package/dist/shared/locale.js.map +1 -1
- package/dist/shared/pageChrome.d.ts +4 -4
- package/dist/shared/pageChrome.d.ts.map +1 -1
- package/dist/shared/pageChrome.js +21 -21
- package/dist/shared/pageChrome.js.map +1 -1
- package/dist/shared/pageHead.d.ts +1 -1
- package/dist/shared/pageHead.d.ts.map +1 -1
- package/dist/shared/pageHead.js +4 -4
- package/dist/shared/pageHead.js.map +1 -1
- package/dist/shared/pageMeta.d.ts +5 -5
- package/dist/shared/pageMeta.d.ts.map +1 -1
- package/dist/shared/pageMeta.js +15 -17
- package/dist/shared/pageMeta.js.map +1 -1
- package/dist/shared/rewrites.d.ts +1 -1
- package/dist/shared/rewrites.d.ts.map +1 -1
- package/dist/shared/rewrites.js +2 -2
- package/dist/shared/rewrites.js.map +1 -1
- package/dist/shared/route.js +5 -5
- package/dist/shared/route.js.map +1 -1
- package/dist/shared/search.d.ts +3 -3
- package/dist/shared/search.d.ts.map +1 -1
- package/dist/shared/search.js +14 -14
- package/dist/shared/search.js.map +1 -1
- package/dist/shared/sidebar.d.ts +1 -1
- package/dist/shared/sidebar.d.ts.map +1 -1
- package/dist/shared/sidebar.js +4 -4
- package/dist/shared/sidebar.js.map +1 -1
- package/dist/shared/slug.d.ts +1 -1
- package/dist/shared/slug.d.ts.map +1 -1
- package/dist/shared/slug.js +5 -5
- package/dist/shared/slug.js.map +1 -1
- package/dist/shared/socialIcons.d.ts.map +1 -1
- package/dist/shared/socialIcons.js +4 -4
- package/dist/shared/socialIcons.js.map +1 -1
- package/dist/shared/tags.js +8 -8
- package/dist/shared/tags.js.map +1 -1
- package/dist/shared/theme.d.ts +1 -1
- package/dist/shared/theme.d.ts.map +1 -1
- package/dist/shared/theme.js +16 -10
- package/dist/shared/theme.js.map +1 -1
- package/dist/shared/themeLabels.d.ts +1 -1
- package/dist/shared/themeLabels.d.ts.map +1 -1
- package/dist/shared/themeLabels.js +26 -26
- package/dist/shared/themeLabels.js.map +1 -1
- package/dist/shared/url.d.ts.map +1 -1
- package/dist/shared/url.js +3 -3
- package/dist/shared/url.js.map +1 -1
- package/package.json +33 -9
- package/src/client/app.tsx +89 -92
- package/src/client/entry-client.tsx +17 -19
- package/src/client/entry-ssr.tsx +33 -33
- package/src/client/index.ts +16 -2
- package/src/client/loadPage.ts +37 -38
- package/src/client/prefetchLinks.ts +30 -30
- package/src/client/theme-default/AlgoliaSearch.tsx +46 -46
- package/src/client/theme-default/Features.tsx +27 -21
- package/src/client/theme-default/Hero.tsx +22 -18
- package/src/client/theme-default/Layout.tsx +189 -244
- package/src/client/theme-default/Logo.tsx +30 -40
- package/src/client/theme-default/NavLinks.tsx +21 -21
- package/src/client/theme-default/SidebarNav.tsx +29 -29
- package/src/client/theme-default/SocialLinks.tsx +11 -11
- package/src/client/theme-default/ThemeToggle.tsx +2 -78
- package/src/client/theme-default/index.ts +1 -1
- package/src/client/theme-default/styles.css +30 -21
- package/src/client/theme-utils.tsx +184 -0
- package/src/client/types.ts +30 -24
- package/src/client/usePageHead.ts +128 -128
- package/src/client/useSiteSearch.ts +34 -34
- package/src/client/virtual.d.ts +76 -76
- package/src/shared/contentChunk.ts +6 -6
- package/src/shared/contentSchema.ts +52 -49
- package/src/shared/deadLinks.ts +16 -16
- package/src/shared/escapeHtml.ts +5 -5
- package/src/shared/index.ts +21 -25
- package/src/shared/locale.ts +46 -46
- package/src/shared/pageChrome.ts +123 -123
- package/src/shared/pageHead.ts +16 -16
- package/src/shared/pageMeta.ts +79 -79
- package/src/shared/rewrites.ts +14 -16
- package/src/shared/route.ts +7 -7
- package/src/shared/search.ts +52 -52
- package/src/shared/sidebar.ts +28 -28
- package/src/shared/slug.ts +13 -13
- package/src/shared/socialIcons.ts +12 -14
- package/src/shared/tags.ts +20 -20
- package/src/shared/theme.ts +22 -13
- package/src/shared/themeLabels.ts +45 -45
- package/src/shared/url.ts +6 -10
- package/templates/default/.preactpress/config.ts +17 -17
- package/templates/default/README.md +16 -16
- package/templates/default/guide/first-five-minutes.md +21 -21
- package/templates/default/index.html +1 -1
- package/templates/default/index.md +9 -9
- package/templates/default/package.json +1 -1
- package/templates/default/pnpm-lock.yaml +5 -5
- package/templates/docs/.preactpress/config.ts +76 -56
- package/templates/docs/README.md +6 -6
- package/templates/docs/components/BenefitsGrid.tsx +45 -0
- package/templates/docs/components/CliBlock.tsx +38 -0
- package/templates/docs/components/ComparisonTable.tsx +60 -0
- package/templates/docs/components/CopyableCommand.tsx +86 -0
- package/templates/docs/components/Counter.tsx +7 -5
- package/templates/docs/components/MarketingHero.tsx +63 -0
- package/templates/docs/components/MdxDemo.tsx +96 -0
- package/templates/docs/components/References.tsx +62 -0
- package/templates/docs/components/TemplateGallery.tsx +46 -0
- package/templates/docs/components/marketing.css +992 -0
- package/templates/docs/examples/algolia-docsearch.md +33 -0
- package/templates/docs/examples/content-loader.data.ts +11 -0
- package/templates/docs/examples/content-loader.md +29 -0
- package/templates/docs/examples/dynamic-routes.md +16 -0
- package/templates/docs/examples/static-assets.md +13 -0
- package/templates/docs/guide/advanced.md +4 -4
- package/templates/docs/guide/commands.md +10 -10
- package/templates/docs/guide/configuration.md +43 -43
- package/templates/docs/guide/creating-pages.md +60 -39
- package/templates/docs/guide/custom-themes.md +9 -9
- package/templates/docs/guide/deploy.md +29 -29
- package/templates/docs/guide/first-five-minutes.md +22 -22
- package/templates/docs/guide/getting-started.md +29 -31
- package/templates/docs/guide/markdown-and-mdx.md +1 -1
- package/templates/docs/guide/routing.md +40 -40
- package/templates/docs/guide/what-is-preactpress.md +18 -18
- package/templates/docs/index.html +1 -1
- package/templates/docs/index.mdx +25 -0
- package/templates/docs/interactive.mdx +1 -1
- package/templates/docs/markdown-examples.md +73 -21
- package/templates/docs/package.json +1 -1
- package/templates/docs/packages/[pkg].md +15 -0
- package/templates/docs/packages/[pkg].paths.ts +20 -0
- package/templates/docs/parts/include-body.md +1 -0
- package/templates/docs/pnpm-lock.yaml +5 -5
- package/templates/docs/public/preactpress-example.txt +1 -0
- package/templates/docs/snippets/greet.ts +1 -1
- package/templates/hono/.preactpress/config.ts +65 -65
- package/templates/hono/.preactpress/theme/CodeSnippet.tsx +15 -15
- package/templates/hono/.preactpress/theme/FeatureGrid.tsx +7 -7
- package/templates/hono/.preactpress/theme/Hero.tsx +13 -13
- package/templates/hono/.preactpress/theme/Layout.tsx +122 -164
- package/templates/hono/.preactpress/theme/Logo.tsx +6 -6
- package/templates/hono/.preactpress/theme/ThemeToggle.tsx +3 -70
- package/templates/hono/.preactpress/theme/hono.css +31 -14
- package/templates/hono/README.md +17 -15
- package/templates/hono/components/Counter.tsx +7 -5
- package/templates/hono/de/guide/configuration.md +18 -20
- package/templates/hono/de/guide/deploy.md +29 -29
- package/templates/hono/de/guide/first-five-minutes.md +21 -21
- package/templates/hono/de/guide/getting-started.md +29 -29
- package/templates/hono/de/guide/routing.md +26 -25
- package/templates/hono/de/guide/seiten-erstellen.md +39 -39
- package/templates/hono/de/guide/what-is-preactpress.md +18 -18
- package/templates/hono/de/index.mdx +20 -17
- package/templates/hono/de/interactive.mdx +1 -1
- package/templates/hono/de/markdown-examples.md +6 -6
- package/templates/hono/de/parts/include-body.md +1 -0
- package/templates/hono/de/snippets/greet.ts +1 -1
- package/templates/hono/guide/configuration.md +25 -25
- package/templates/hono/guide/creating-pages.md +39 -39
- package/templates/hono/guide/deploy.md +29 -29
- package/templates/hono/guide/first-five-minutes.md +21 -21
- package/templates/hono/guide/getting-started.md +29 -29
- package/templates/hono/guide/routing.md +40 -40
- package/templates/hono/guide/what-is-preactpress.md +18 -18
- package/templates/hono/index.html +1 -1
- package/templates/hono/index.mdx +21 -17
- package/templates/hono/interactive.mdx +1 -1
- package/templates/hono/markdown-examples.md +6 -6
- package/templates/hono/package.json +1 -1
- package/templates/hono/parts/include-body.md +1 -0
- package/templates/hono/pnpm-lock.yaml +5 -5
- package/templates/hono/snippets/greet.ts +1 -1
- package/templates/magazine/.preactpress/config.ts +19 -19
- package/templates/magazine/.preactpress/theme/Layout.tsx +69 -172
- package/templates/magazine/.preactpress/theme/TeaserGrid.tsx +14 -14
- package/templates/magazine/.preactpress/theme/ThemeToggle.tsx +4 -70
- package/templates/magazine/.preactpress/theme/magazine.css +13 -8
- package/templates/magazine/README.md +30 -0
- package/templates/magazine/article-markets.md +2 -2
- package/templates/magazine/article-tech.mdx +10 -10
- package/templates/magazine/index.data.ts +9 -9
- package/templates/magazine/index.html +5 -1
- package/templates/magazine/index.mdx +1 -1
- package/templates/magazine/package.json +1 -1
- package/templates/magazine/pnpm-lock.yaml +2917 -0
- package/templates/docs/about.md +0 -10
- package/templates/docs/dist/404.html +0 -29
- package/templates/docs/dist/about/index.html +0 -32
- package/templates/docs/dist/assets/esm-DzlBxN5p.js +0 -110
- package/templates/docs/dist/assets/interactive-64o6YwrR.js +0 -9
- package/templates/docs/dist/assets/interactive-BedCloEw.js +0 -9
- package/templates/docs/dist/assets/main-BVLeh8GO.js +0 -1
- package/templates/docs/dist/assets/main-CreUBb3N.js +0 -1
- package/templates/docs/dist/assets/main-oodK-zZy.css +0 -2
- package/templates/docs/dist/de/guide/getting-started/index.html +0 -36
- package/templates/docs/dist/de/guide/what-is-preactpress/index.html +0 -38
- package/templates/docs/dist/de/index.html +0 -29
- package/templates/docs/dist/favicon-32.png +0 -0
- package/templates/docs/dist/favicon.png +0 -0
- package/templates/docs/dist/favicon.svg +0 -28
- package/templates/docs/dist/guide/advanced/index.html +0 -53
- package/templates/docs/dist/guide/commands/index.html +0 -89
- package/templates/docs/dist/guide/configuration/index.html +0 -196
- package/templates/docs/dist/guide/creating-pages/index.html +0 -234
- package/templates/docs/dist/guide/custom-themes/index.html +0 -52
- package/templates/docs/dist/guide/default-theme/index.html +0 -53
- package/templates/docs/dist/guide/deploy/index.html +0 -195
- package/templates/docs/dist/guide/first-five-minutes/index.html +0 -99
- package/templates/docs/dist/guide/getting-started/index.html +0 -173
- package/templates/docs/dist/guide/markdown-and-mdx/index.html +0 -59
- package/templates/docs/dist/guide/routing/index.html +0 -192
- package/templates/docs/dist/guide/what-is-preactpress/index.html +0 -141
- package/templates/docs/dist/index.html +0 -30
- package/templates/docs/dist/interactive/index.html +0 -37
- package/templates/docs/dist/markdown-examples/index.html +0 -231
- package/templates/docs/dist/preactpress-content/404.json +0 -8
- package/templates/docs/dist/preactpress-content/_index.json +0 -50
- package/templates/docs/dist/preactpress-content/about.json +0 -15
- package/templates/docs/dist/preactpress-content/de.json +0 -45
- package/templates/docs/dist/preactpress-content/de__guide__getting-started.json +0 -26
- package/templates/docs/dist/preactpress-content/de__guide__what-is-preactpress.json +0 -21
- package/templates/docs/dist/preactpress-content/guide__advanced.json +0 -46
- package/templates/docs/dist/preactpress-content/guide__commands.json +0 -26
- package/templates/docs/dist/preactpress-content/guide__configuration.json +0 -51
- package/templates/docs/dist/preactpress-content/guide__creating-pages.json +0 -71
- package/templates/docs/dist/preactpress-content/guide__custom-themes.json +0 -15
- package/templates/docs/dist/preactpress-content/guide__default-theme.json +0 -36
- package/templates/docs/dist/preactpress-content/guide__deploy.json +0 -56
- package/templates/docs/dist/preactpress-content/guide__first-five-minutes.json +0 -36
- package/templates/docs/dist/preactpress-content/guide__getting-started.json +0 -51
- package/templates/docs/dist/preactpress-content/guide__markdown-and-mdx.json +0 -31
- package/templates/docs/dist/preactpress-content/guide__routing.json +0 -71
- package/templates/docs/dist/preactpress-content/guide__what-is-preactpress.json +0 -51
- package/templates/docs/dist/preactpress-content/markdown-examples.json +0 -71
- package/templates/docs/dist/preactpress-content/tags__markdown.json +0 -16
- package/templates/docs/dist/preactpress-search.json +0 -166
- package/templates/docs/dist/preactpress-theme.js +0 -1
- package/templates/docs/dist/tags/markdown/index.html +0 -32
- package/templates/docs/index.md +0 -28
- package/templates/hono/dist/404.html +0 -29
- package/templates/hono/dist/README/index.html +0 -104
- package/templates/hono/dist/about/index.html +0 -32
- package/templates/hono/dist/assets/Counter-CCEByS-J.js +0 -1
- package/templates/hono/dist/assets/Hero--o6WMNvm.js +0 -2
- package/templates/hono/dist/assets/de-D5r6Ye70.js +0 -10
- package/templates/hono/dist/assets/hono-BXWYYdyv.js +0 -10
- package/templates/hono/dist/assets/interactive-Bxo-WBpC.js +0 -9
- package/templates/hono/dist/assets/interactive-BznI4IQ3.js +0 -9
- package/templates/hono/dist/assets/main-Bqi-VFEk.js +0 -2
- package/templates/hono/dist/assets/main-DIIN7FO0.css +0 -1
- package/templates/hono/dist/de/about/index.html +0 -32
- package/templates/hono/dist/de/guide/commands/index.html +0 -41
- package/templates/hono/dist/de/guide/configuration/index.html +0 -105
- package/templates/hono/dist/de/guide/deploy/index.html +0 -195
- package/templates/hono/dist/de/guide/first-five-minutes/index.html +0 -99
- package/templates/hono/dist/de/guide/getting-started/index.html +0 -173
- package/templates/hono/dist/de/guide/routing/index.html +0 -165
- package/templates/hono/dist/de/guide/seiten-erstellen/index.html +0 -234
- package/templates/hono/dist/de/guide/what-is-preactpress/index.html +0 -141
- package/templates/hono/dist/de/index.html +0 -30
- package/templates/hono/dist/de/interactive/index.html +0 -37
- package/templates/hono/dist/de/markdown-examples/index.html +0 -97
- package/templates/hono/dist/de/parts/include-body/index.html +0 -36
- package/templates/hono/dist/de/tags/markdown/index.html +0 -32
- package/templates/hono/dist/favicon-32.png +0 -0
- package/templates/hono/dist/favicon.png +0 -0
- package/templates/hono/dist/favicon.svg +0 -28
- package/templates/hono/dist/guide/commands/index.html +0 -41
- package/templates/hono/dist/guide/configuration/index.html +0 -158
- package/templates/hono/dist/guide/creating-pages/index.html +0 -234
- package/templates/hono/dist/guide/deploy/index.html +0 -195
- package/templates/hono/dist/guide/first-five-minutes/index.html +0 -99
- package/templates/hono/dist/guide/getting-started/index.html +0 -173
- package/templates/hono/dist/guide/routing/index.html +0 -165
- package/templates/hono/dist/guide/what-is-preactpress/index.html +0 -141
- package/templates/hono/dist/index.html +0 -30
- package/templates/hono/dist/interactive/index.html +0 -37
- package/templates/hono/dist/markdown-examples/index.html +0 -105
- package/templates/hono/dist/partials/shared-note/index.html +0 -30
- package/templates/hono/dist/parts/include-body/index.html +0 -36
- package/templates/hono/dist/preactpress-content/404.json +0 -8
- package/templates/hono/dist/preactpress-content/README.json +0 -26
- package/templates/hono/dist/preactpress-content/about.json +0 -15
- package/templates/hono/dist/preactpress-content/de__about.json +0 -15
- package/templates/hono/dist/preactpress-content/de__guide__commands.json +0 -36
- package/templates/hono/dist/preactpress-content/de__guide__configuration.json +0 -41
- package/templates/hono/dist/preactpress-content/de__guide__deploy.json +0 -56
- package/templates/hono/dist/preactpress-content/de__guide__first-five-minutes.json +0 -36
- package/templates/hono/dist/preactpress-content/de__guide__getting-started.json +0 -51
- package/templates/hono/dist/preactpress-content/de__guide__routing.json +0 -61
- package/templates/hono/dist/preactpress-content/de__guide__seiten-erstellen.json +0 -71
- package/templates/hono/dist/preactpress-content/de__guide__what-is-preactpress.json +0 -51
- package/templates/hono/dist/preactpress-content/de__markdown-examples.json +0 -131
- package/templates/hono/dist/preactpress-content/de__parts__include-body.json +0 -16
- package/templates/hono/dist/preactpress-content/de__tags__markdown.json +0 -16
- package/templates/hono/dist/preactpress-content/guide__commands.json +0 -36
- package/templates/hono/dist/preactpress-content/guide__configuration.json +0 -51
- package/templates/hono/dist/preactpress-content/guide__creating-pages.json +0 -71
- package/templates/hono/dist/preactpress-content/guide__deploy.json +0 -56
- package/templates/hono/dist/preactpress-content/guide__first-five-minutes.json +0 -36
- package/templates/hono/dist/preactpress-content/guide__getting-started.json +0 -51
- package/templates/hono/dist/preactpress-content/guide__routing.json +0 -61
- package/templates/hono/dist/preactpress-content/guide__what-is-preactpress.json +0 -51
- package/templates/hono/dist/preactpress-content/markdown-examples.json +0 -141
- package/templates/hono/dist/preactpress-content/partials__shared-note.json +0 -10
- package/templates/hono/dist/preactpress-content/parts__include-body.json +0 -16
- package/templates/hono/dist/preactpress-content/tags__markdown.json +0 -16
- package/templates/hono/dist/preactpress-search.json +0 -242
- package/templates/hono/dist/preactpress-theme.js +0 -1
- package/templates/hono/dist/tags/markdown/index.html +0 -32
package/templates/hono/README.md
CHANGED
|
@@ -6,27 +6,29 @@ It combines a hono.dev-inspired landing page with a full documentation starter,
|
|
|
6
6
|
|
|
7
7
|
## Commands
|
|
8
8
|
|
|
9
|
-
| Script
|
|
10
|
-
|
|
|
11
|
-
| `pnpm run dev`
|
|
12
|
-
| `pnpm run check`
|
|
13
|
-
| `pnpm run build`
|
|
14
|
-
| `pnpm run preview` | Serve the production build locally
|
|
9
|
+
| Script | What it does |
|
|
10
|
+
| ------------------ | --------------------------------------------- |
|
|
11
|
+
| `pnpm run dev` | Start the dev server at http://localhost:5173 |
|
|
12
|
+
| `pnpm run check` | Validate config, routes, and links |
|
|
13
|
+
| `pnpm run build` | Write static HTML to `dist/` |
|
|
14
|
+
| `pnpm run preview` | Serve the production build locally |
|
|
15
15
|
|
|
16
16
|
## Where to edit
|
|
17
17
|
|
|
18
|
-
| Path
|
|
19
|
-
|
|
|
20
|
-
| `*.md`, `*.mdx`
|
|
21
|
-
| `index.mdx`, `de/index.mdx` | Landing pages with the hero and feature cards
|
|
22
|
-
| `de/*.md`, `de/*.mdx`
|
|
23
|
-
| `.preactpress/config.ts`
|
|
24
|
-
| `.preactpress/theme/`
|
|
25
|
-
| `components/`
|
|
26
|
-
| `index.html`
|
|
18
|
+
| Path | Purpose |
|
|
19
|
+
| --------------------------- | ------------------------------------------------ |
|
|
20
|
+
| `*.md`, `*.mdx` | Page content — file path becomes the URL |
|
|
21
|
+
| `index.mdx`, `de/index.mdx` | Landing pages with the hero and feature cards |
|
|
22
|
+
| `de/*.md`, `de/*.mdx` | German pages for the bundled i18n demo |
|
|
23
|
+
| `.preactpress/config.ts` | Site title, nav, sidebar, locales, build options |
|
|
24
|
+
| `.preactpress/theme/` | Custom Hono-style layout, components, and CSS |
|
|
25
|
+
| `components/` | Preact components for MDX pages |
|
|
26
|
+
| `index.html` | Vite entry (rarely edited) |
|
|
27
27
|
|
|
28
28
|
Start with [Your first 5 minutes](/guide/first-five-minutes) in the local site, or read the full PreactPress README in the npm package / repository.
|
|
29
29
|
|
|
30
|
+
The Hono-style starter intentionally keeps a focused guide subset so the custom theme stays easy to scan. Use the `docs` template as the canonical source for advanced PreactPress reference pages such as default theme options, dynamic routes, build hooks, and custom theme APIs.
|
|
31
|
+
|
|
30
32
|
This starter includes English pages at the root and German pages under `/de/`. Remove the `de/` folder and `locales` config if you want a single-language site.
|
|
31
33
|
|
|
32
34
|
## Deploy
|
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
import { useState } from
|
|
1
|
+
import { useState } from "preact/hooks";
|
|
2
2
|
|
|
3
|
-
export
|
|
4
|
-
const [count, setCount] = useState(initial)
|
|
3
|
+
export function Counter({ initial = 0 }: { initial?: number }) {
|
|
4
|
+
const [count, setCount] = useState(initial);
|
|
5
5
|
|
|
6
6
|
return (
|
|
7
|
-
<div style={{ display:
|
|
7
|
+
<div style={{ display: "inline-flex", alignItems: "center", gap: "0.5rem" }}>
|
|
8
8
|
<button
|
|
9
9
|
type="button"
|
|
10
10
|
onClick={() => setCount((value) => value - 1)}
|
|
@@ -21,5 +21,7 @@ export default function Counter({ initial = 0 }: { initial?: number }) {
|
|
|
21
21
|
+
|
|
22
22
|
</button>
|
|
23
23
|
</div>
|
|
24
|
-
)
|
|
24
|
+
);
|
|
25
25
|
}
|
|
26
|
+
|
|
27
|
+
export default Counter;
|
|
@@ -10,23 +10,23 @@ Die Konfiguration liegt in `.preactpress/config.ts` im Site-Root.
|
|
|
10
10
|
```ts
|
|
11
11
|
export default {
|
|
12
12
|
site: {
|
|
13
|
-
title:
|
|
14
|
-
description:
|
|
15
|
-
base:
|
|
16
|
-
url:
|
|
17
|
-
titleTemplate:
|
|
18
|
-
}
|
|
19
|
-
}
|
|
13
|
+
title: "Meine Docs",
|
|
14
|
+
description: "Kurzbeschreibung für SEO",
|
|
15
|
+
base: "/",
|
|
16
|
+
url: "https://example.com",
|
|
17
|
+
titleTemplate: ":title | :siteTitle",
|
|
18
|
+
},
|
|
19
|
+
};
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
`site.url` vor dem Go-Live setzen — für Canonical-URLs, `sitemap.xml`, Open Graph und `hreflang`.
|
|
23
23
|
|
|
24
24
|
## Inhaltsverzeichnis
|
|
25
25
|
|
|
26
|
-
| Option
|
|
27
|
-
|
|
|
28
|
-
| `srcDir`
|
|
29
|
-
| `srcExclude`
|
|
26
|
+
| Option | Zweck |
|
|
27
|
+
| ---------------- | ------------------------------------------------------------ |
|
|
28
|
+
| `srcDir` | Ordner mit `.md` / `.mdx` (Standard `.`) |
|
|
29
|
+
| `srcExclude` | Glob-Muster für Nicht-Seiten, z. B. `['**/README.md']` |
|
|
30
30
|
| `lastUpdatedGit` | Git-Commit-Zeit für „Zuletzt aktualisiert“ (Fallback: mtime) |
|
|
31
31
|
|
|
32
32
|
## Theme ohne eigenen Code
|
|
@@ -45,19 +45,17 @@ Locale-Overrides unter `locales.<key>.themeConfig`.
|
|
|
45
45
|
## Globale Head-Tags
|
|
46
46
|
|
|
47
47
|
```ts
|
|
48
|
-
head: [
|
|
49
|
-
['meta', { name: 'theme-color', content: '#0f766e' }]
|
|
50
|
-
]
|
|
48
|
+
head: [["meta", { name: "theme-color", content: "#0f766e" }]];
|
|
51
49
|
```
|
|
52
50
|
|
|
53
51
|
## Frontmatter pro Seite
|
|
54
52
|
|
|
55
|
-
| Feld
|
|
56
|
-
|
|
|
57
|
-
| `title` / `description` | Seitentitel und SEO-Text
|
|
58
|
-
| `titleTemplate`
|
|
59
|
-
| `head`
|
|
60
|
-
| `draft: true`
|
|
53
|
+
| Feld | Zweck |
|
|
54
|
+
| ----------------------- | ---------------------------------------------------------------- |
|
|
55
|
+
| `title` / `description` | Seitentitel und SEO-Text |
|
|
56
|
+
| `titleTemplate` | Site-Template überschreiben; `false` = nur Seitentitel |
|
|
57
|
+
| `head` | Zusätzliche `<meta>` / `<link>` / `<script>` nur für diese Seite |
|
|
58
|
+
| `draft: true` | Aus Routen, Suche und Sitemap ausgeschlossen |
|
|
61
59
|
|
|
62
60
|
::: warning
|
|
63
61
|
`markdown.html` nur für vertrauenswürdige Inhalte aktivieren — erlaubt rohes HTML in Markdown.
|
|
@@ -33,16 +33,16 @@ Setze `site.url` vor der Veröffentlichung. PreactPress nutzt diese URL für Can
|
|
|
33
33
|
```ts
|
|
34
34
|
export default {
|
|
35
35
|
site: {
|
|
36
|
-
title:
|
|
37
|
-
description:
|
|
38
|
-
url:
|
|
39
|
-
base:
|
|
36
|
+
title: "Meine Site",
|
|
37
|
+
description: "Kurze Beschreibung für Suche und Social Previews",
|
|
38
|
+
url: "https://example.com",
|
|
39
|
+
base: "/",
|
|
40
40
|
},
|
|
41
41
|
build: {
|
|
42
42
|
sitemap: true,
|
|
43
|
-
robots: true
|
|
44
|
-
}
|
|
45
|
-
}
|
|
43
|
+
robots: true,
|
|
44
|
+
},
|
|
45
|
+
};
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
## Public Base Path
|
|
@@ -58,10 +58,10 @@ Wenn die Site unter einem Unterpfad liegt, setze `site.base`:
|
|
|
58
58
|
```ts
|
|
59
59
|
export default {
|
|
60
60
|
site: {
|
|
61
|
-
url:
|
|
62
|
-
base:
|
|
63
|
-
}
|
|
64
|
-
}
|
|
61
|
+
url: "https://user.github.io",
|
|
62
|
+
base: "/my-repo/",
|
|
63
|
+
},
|
|
64
|
+
};
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
Du kannst den Base Path auch nur für einen einzelnen Build überschreiben:
|
|
@@ -74,15 +74,15 @@ pnpm exec preactpress build --base /my-repo/
|
|
|
74
74
|
|
|
75
75
|
Das Standard-Ausgabeverzeichnis ist `dist/`:
|
|
76
76
|
|
|
77
|
-
| Ausgabe
|
|
78
|
-
|
|
|
79
|
-
| `index.html`, `*/index.html` | Statisches HTML für jede Route
|
|
80
|
-
| `assets/*`
|
|
81
|
-
| `404.html`
|
|
82
|
-
| `preactpress-search.json`
|
|
77
|
+
| Ausgabe | Beschreibung |
|
|
78
|
+
| ---------------------------- | ----------------------------------------------------- |
|
|
79
|
+
| `index.html`, `*/index.html` | Statisches HTML für jede Route |
|
|
80
|
+
| `assets/*` | Gehashtes JavaScript und CSS von Vite |
|
|
81
|
+
| `404.html` | Fehlerseite |
|
|
82
|
+
| `preactpress-search.json` | Suchindex für das Standard-Theme |
|
|
83
83
|
| `preactpress-content/*.json` | Lazy geladene Markdown-Payloads für Client-Navigation |
|
|
84
|
-
| `sitemap.xml`, `robots.txt`
|
|
85
|
-
| `feed.xml`
|
|
84
|
+
| `sitemap.xml`, `robots.txt` | Erzeugt, wenn `site.url` und Build-Flags gesetzt sind |
|
|
85
|
+
| `feed.xml` | Erzeugt, wenn `build.feed` konfiguriert ist |
|
|
86
86
|
|
|
87
87
|
Deploye nur das Ausgabeverzeichnis. Deploye nicht `node_modules`, `.preactpress` oder den Build-Cache.
|
|
88
88
|
|
|
@@ -90,12 +90,12 @@ Deploye nur das Ausgabeverzeichnis. Deploye nicht `node_modules`, `.preactpress`
|
|
|
90
90
|
|
|
91
91
|
Für die meisten Static Hosts reichen diese Einstellungen:
|
|
92
92
|
|
|
93
|
-
| Host
|
|
94
|
-
|
|
|
95
|
-
| Netlify
|
|
96
|
-
| Vercel
|
|
97
|
-
| Cloudflare Pages
|
|
98
|
-
| Render Static Site | `pnpm run build` | `dist`
|
|
93
|
+
| Host | Build-Befehl | Output-Verzeichnis |
|
|
94
|
+
| ------------------ | ---------------- | ------------------ |
|
|
95
|
+
| Netlify | `pnpm run build` | `dist` |
|
|
96
|
+
| Vercel | `pnpm run build` | `dist` |
|
|
97
|
+
| Cloudflare Pages | `pnpm run build` | `dist` |
|
|
98
|
+
| Render Static Site | `pnpm run build` | `dist` |
|
|
99
99
|
|
|
100
100
|
Install-Befehl:
|
|
101
101
|
|
|
@@ -112,10 +112,10 @@ Für eine Projektseite unter `https://user.github.io/my-repo/` konfigurierst du:
|
|
|
112
112
|
```ts
|
|
113
113
|
export default {
|
|
114
114
|
site: {
|
|
115
|
-
url:
|
|
116
|
-
base:
|
|
117
|
-
}
|
|
118
|
-
}
|
|
115
|
+
url: "https://user.github.io",
|
|
116
|
+
base: "/my-repo/",
|
|
117
|
+
},
|
|
118
|
+
};
|
|
119
119
|
```
|
|
120
120
|
|
|
121
121
|
Danach deployest du das Verzeichnis `dist/`.
|
|
@@ -14,10 +14,10 @@ Bearbeite `.preactpress/config.ts`:
|
|
|
14
14
|
```ts
|
|
15
15
|
export default {
|
|
16
16
|
site: {
|
|
17
|
-
title:
|
|
18
|
-
description:
|
|
19
|
-
}
|
|
20
|
-
}
|
|
17
|
+
title: "Meine Doku",
|
|
18
|
+
description: "Kurze Beschreibung für Suche und Social Previews",
|
|
19
|
+
},
|
|
20
|
+
};
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Speichere die Datei. Der Dev-Server übernimmt Config-Änderungen beim nächsten Request.
|
|
@@ -49,34 +49,34 @@ In `.preactpress/config.ts`:
|
|
|
49
49
|
|
|
50
50
|
```ts
|
|
51
51
|
export default {
|
|
52
|
-
site: { title:
|
|
52
|
+
site: { title: "Meine Doku" },
|
|
53
53
|
themeConfig: {
|
|
54
54
|
nav: [
|
|
55
|
-
{ text:
|
|
56
|
-
{ text:
|
|
55
|
+
{ text: "Start", link: "/" },
|
|
56
|
+
{ text: "Über uns", link: "/about" },
|
|
57
57
|
],
|
|
58
58
|
sidebar: [
|
|
59
59
|
{
|
|
60
|
-
text:
|
|
60
|
+
text: "Anleitung",
|
|
61
61
|
items: [
|
|
62
|
-
{ text:
|
|
63
|
-
{ text:
|
|
64
|
-
]
|
|
65
|
-
}
|
|
66
|
-
]
|
|
67
|
-
}
|
|
68
|
-
}
|
|
62
|
+
{ text: "Start", link: "/" },
|
|
63
|
+
{ text: "Über uns", link: "/about" },
|
|
64
|
+
],
|
|
65
|
+
},
|
|
66
|
+
],
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
Speichern — der Dev-Server lädt die Änderung automatisch.
|
|
72
72
|
|
|
73
73
|
## Nächste Schritte
|
|
74
74
|
|
|
75
|
-
| Befehl
|
|
76
|
-
|
|
|
77
|
-
| `pnpm run dev`
|
|
78
|
-
| `pnpm run check`
|
|
79
|
-
| `pnpm run build`
|
|
80
|
-
| `pnpm run preview` | Lokale Vorschau des Builds
|
|
75
|
+
| Befehl | Zweck |
|
|
76
|
+
| ------------------ | ------------------------------------- |
|
|
77
|
+
| `pnpm run dev` | Dev-Server mit SSR und Hot Reload |
|
|
78
|
+
| `pnpm run check` | Config, Links und Routen prüfen |
|
|
79
|
+
| `pnpm run build` | Statischer Produktionsbuild → `dist/` |
|
|
80
|
+
| `pnpm run preview` | Lokale Vorschau des Builds |
|
|
81
81
|
|
|
82
82
|
Setze vor dem Deployment `site.url` in der Config, damit Canonical URLs, Open Graph Tags und `sitemap.xml` erzeugt werden. Lies danach [Routing](/de/guide/routing), um dateibasierte Routen zu verstehen, und [Deploy](/de/guide/deploy) für die Produktionsschritte.
|
|
@@ -11,11 +11,11 @@ Diese Anleitung zeigt, wie du eine PreactPress-Site erstellst, die generierten D
|
|
|
11
11
|
|
|
12
12
|
Du brauchst:
|
|
13
13
|
|
|
14
|
-
| Voraussetzung
|
|
15
|
-
|
|
|
16
|
-
| Node.js
|
|
14
|
+
| Voraussetzung | Version |
|
|
15
|
+
| --------------- | --------------------------------------------------------- |
|
|
16
|
+
| Node.js | 20 oder höher |
|
|
17
17
|
| Package Manager | pnpm empfohlen; npm, yarn und bun funktionieren ebenfalls |
|
|
18
|
-
| Editor
|
|
18
|
+
| Editor | Jeder Editor mit Markdown- und TypeScript-Unterstützung |
|
|
19
19
|
|
|
20
20
|
## Site erstellen
|
|
21
21
|
|
|
@@ -73,25 +73,25 @@ Die Starter-Config liegt unter `.preactpress/config.ts`:
|
|
|
73
73
|
```ts
|
|
74
74
|
export default {
|
|
75
75
|
site: {
|
|
76
|
-
title:
|
|
77
|
-
description:
|
|
76
|
+
title: "Meine Doku",
|
|
77
|
+
description: "Kurze Beschreibung für Suche und Social Previews",
|
|
78
78
|
},
|
|
79
79
|
themeConfig: {
|
|
80
80
|
nav: [
|
|
81
|
-
{ text:
|
|
82
|
-
{ text:
|
|
81
|
+
{ text: "Start", link: "/de" },
|
|
82
|
+
{ text: "Anleitung", link: "/de/guide/what-is-preactpress" },
|
|
83
83
|
],
|
|
84
84
|
sidebar: [
|
|
85
85
|
{
|
|
86
|
-
text:
|
|
86
|
+
text: "Einführung",
|
|
87
87
|
items: [
|
|
88
|
-
{ text:
|
|
89
|
-
{ text:
|
|
90
|
-
]
|
|
91
|
-
}
|
|
92
|
-
]
|
|
93
|
-
}
|
|
94
|
-
}
|
|
88
|
+
{ text: "Was ist PreactPress?", link: "/de/guide/what-is-preactpress" },
|
|
89
|
+
{ text: "Getting Started", link: "/de/guide/getting-started" },
|
|
90
|
+
],
|
|
91
|
+
},
|
|
92
|
+
],
|
|
93
|
+
},
|
|
94
|
+
};
|
|
95
95
|
```
|
|
96
96
|
|
|
97
97
|
Nutze `site` für globale Metadaten und `themeConfig` für Optionen des Standard-Themes wie Logo (`logo: '/logo.svg'`), Navigation, Sidebar, Suche, Outline, Footer und Edit-Links.
|
|
@@ -111,8 +111,8 @@ Mit `srcDir` kannst du das Quellverzeichnis ändern:
|
|
|
111
111
|
|
|
112
112
|
```ts
|
|
113
113
|
export default {
|
|
114
|
-
srcDir:
|
|
115
|
-
}
|
|
114
|
+
srcDir: "docs",
|
|
115
|
+
};
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
Mit dieser Config liest PreactPress Seiten aus `docs/`, während `.preactpress/config.ts` weiterhin zum Projektroot gehört.
|
|
@@ -121,12 +121,12 @@ Mit dieser Config liest PreactPress Seiten aus `docs/`, während `.preactpress/c
|
|
|
121
121
|
|
|
122
122
|
Der Starter enthält npm-Scripts:
|
|
123
123
|
|
|
124
|
-
| Befehl
|
|
125
|
-
|
|
|
126
|
-
| `pnpm run dev`
|
|
127
|
-
| `pnpm run check`
|
|
128
|
-
| `pnpm run build`
|
|
129
|
-
| `pnpm run preview` | Produktionsbuild lokal ansehen
|
|
124
|
+
| Befehl | Zweck |
|
|
125
|
+
| ------------------ | -------------------------------------------------- |
|
|
126
|
+
| `pnpm run dev` | Dev-Server mit SSR und Hot Reload starten |
|
|
127
|
+
| `pnpm run check` | Config, Routen und Links validieren |
|
|
128
|
+
| `pnpm run build` | Statischen Produktionsbuild nach `dist/` schreiben |
|
|
129
|
+
| `pnpm run preview` | Produktionsbuild lokal ansehen |
|
|
130
130
|
|
|
131
131
|
Du kannst die CLI auch direkt aufrufen:
|
|
132
132
|
|
|
@@ -139,8 +139,8 @@ pnpm exec preactpress preview
|
|
|
139
139
|
|
|
140
140
|
## Was kommt als Nächstes?
|
|
141
141
|
|
|
142
|
-
| Seite
|
|
143
|
-
|
|
|
144
|
-
| [Die ersten 5 Minuten](/de/guide/first-five-minutes) | Titel ändern, Seite anlegen und Navigation verdrahten
|
|
145
|
-
| [Routing](/de/guide/routing)
|
|
146
|
-
| [Deploy](/de/guide/deploy)
|
|
142
|
+
| Seite | Warum |
|
|
143
|
+
| ---------------------------------------------------- | ---------------------------------------------------------- |
|
|
144
|
+
| [Die ersten 5 Minuten](/de/guide/first-five-minutes) | Titel ändern, Seite anlegen und Navigation verdrahten |
|
|
145
|
+
| [Routing](/de/guide/routing) | Lernen, wie Markdown-Dateien zu URLs werden |
|
|
146
|
+
| [Deploy](/de/guide/deploy) | Das erzeugte `dist/`-Verzeichnis bauen und veröffentlichen |
|
|
@@ -60,8 +60,8 @@ Mit `srcDir` kannst du Inhalte in ein verschachteltes Quellverzeichnis legen:
|
|
|
60
60
|
|
|
61
61
|
```ts
|
|
62
62
|
export default {
|
|
63
|
-
srcDir:
|
|
64
|
-
}
|
|
63
|
+
srcDir: "docs",
|
|
64
|
+
};
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
Dann sieht die Struktur so aus:
|
|
@@ -97,6 +97,7 @@ Vermeide direkte Links auf generiertes HTML oder Markdown-Quelldateien:
|
|
|
97
97
|
|
|
98
98
|
```md
|
|
99
99
|
<!-- Vermeiden -->
|
|
100
|
+
|
|
100
101
|
[Getting Started](/de/guide/getting-started.md)
|
|
101
102
|
[Getting Started](/de/guide/getting-started.html)
|
|
102
103
|
```
|
|
@@ -120,16 +121,16 @@ Labels, Sprachcodes und lokale Navigation konfigurierst du in `.preactpress/conf
|
|
|
120
121
|
export default {
|
|
121
122
|
locales: {
|
|
122
123
|
root: {
|
|
123
|
-
label:
|
|
124
|
-
lang:
|
|
124
|
+
label: "English",
|
|
125
|
+
lang: "en",
|
|
125
126
|
},
|
|
126
127
|
de: {
|
|
127
|
-
label:
|
|
128
|
-
lang:
|
|
129
|
-
link:
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
}
|
|
128
|
+
label: "Deutsch",
|
|
129
|
+
lang: "de",
|
|
130
|
+
link: "/de/",
|
|
131
|
+
},
|
|
132
|
+
},
|
|
133
|
+
};
|
|
133
134
|
```
|
|
134
135
|
|
|
135
136
|
Das Standard-Theme zeigt einen Sprachumschalter, wenn mehrere Locales konfiguriert sind.
|
|
@@ -167,9 +168,9 @@ Nutze `site.base`, wenn die Site unter einem Unterpfad ausgeliefert wird, zum Be
|
|
|
167
168
|
```ts
|
|
168
169
|
export default {
|
|
169
170
|
site: {
|
|
170
|
-
base:
|
|
171
|
-
}
|
|
172
|
-
}
|
|
171
|
+
base: "/my-repo/",
|
|
172
|
+
},
|
|
173
|
+
};
|
|
173
174
|
```
|
|
174
175
|
|
|
175
176
|
Du kannst den Base Path auch für einen einzelnen Build überschreiben:
|
|
@@ -185,25 +186,25 @@ pnpm exec preactpress build --base /my-repo/
|
|
|
185
186
|
```ts
|
|
186
187
|
export default {
|
|
187
188
|
rewrites: {
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
}
|
|
191
|
-
}
|
|
189
|
+
"/docs": "/guide",
|
|
190
|
+
"/getting-started": "/guide/intro",
|
|
191
|
+
},
|
|
192
|
+
};
|
|
192
193
|
```
|
|
193
194
|
|
|
194
195
|
Keys sind die Routen für Besucher; Values müssen auf Routen zeigen, die bereits aus Markdown-Dateien existieren. `preactpress check` validiert Quellen und Kollisionen.
|
|
195
196
|
|
|
196
197
|
## Clean URLs und Hosting
|
|
197
198
|
|
|
198
|
-
| `cleanUrls`
|
|
199
|
-
|
|
|
199
|
+
| `cleanUrls` | Ausgabe für `/about` | Typischer Host |
|
|
200
|
+
| ----------------- | ----------------------- | ----------------------------------------------- |
|
|
200
201
|
| `true` (Standard) | `dist/about/index.html` | Netlify, Vercel, Cloudflare Pages, GitHub Pages |
|
|
201
|
-
| `false`
|
|
202
|
+
| `false` | `dist/about.html` | Statische Buckets ohne Directory-Index |
|
|
202
203
|
|
|
203
204
|
```ts
|
|
204
205
|
export default {
|
|
205
|
-
cleanUrls: false
|
|
206
|
-
}
|
|
206
|
+
cleanUrls: false,
|
|
207
|
+
};
|
|
207
208
|
```
|
|
208
209
|
|
|
209
210
|
Die meisten modernen Static Hosts funktionieren mit dem Standard. Setze `cleanUrls: false` nur, wenn dein Host `/about` nicht zu `about/index.html` auflösen kann.
|
|
@@ -212,9 +213,9 @@ Die meisten modernen Static Hosts funktionieren mit dem Standard. Setze `cleanUr
|
|
|
212
213
|
|
|
213
214
|
PreactPress hält Routing bewusst klein. Im Vergleich zu VitePress enthält es aktuell nicht:
|
|
214
215
|
|
|
215
|
-
| Feature
|
|
216
|
-
|
|
|
217
|
-
| Dynamische Routen wie `[pkg].paths.ts`
|
|
216
|
+
| Feature | Status |
|
|
217
|
+
| ---------------------------------------- | ----------------- |
|
|
218
|
+
| Dynamische Routen wie `[pkg].paths.ts` | Nicht unterstützt |
|
|
218
219
|
| Pattern-basierte Rewrites mit Parametern | Nicht unterstützt |
|
|
219
220
|
|
|
220
221
|
Wenn deine Site viele Seiten aus externen Daten erzeugen muss, generiere Markdown- oder MDX-Dateien vor `preactpress build`.
|
|
@@ -40,14 +40,14 @@ Speichern — unter `pnpm run dev` ist die Seite sofort unter **/kontakt** errei
|
|
|
40
40
|
|
|
41
41
|
PreactPress nutzt **dateibasiertes Routing**. Der Pfad relativ zu `srcDir` wird zur Route:
|
|
42
42
|
|
|
43
|
-
| Datei
|
|
44
|
-
|
|
|
45
|
-
| `index.md`
|
|
46
|
-
| `about.md`
|
|
43
|
+
| Datei | URL |
|
|
44
|
+
| ---------------------- | -------------------- |
|
|
45
|
+
| `index.md` | `/` |
|
|
46
|
+
| `about.md` | `/about` |
|
|
47
47
|
| `guide/einfuehrung.md` | `/guide/einfuehrung` |
|
|
48
|
-
| `guide/index.md`
|
|
49
|
-
| `news/2025/intro.md`
|
|
50
|
-
| `interactive.mdx`
|
|
48
|
+
| `guide/index.md` | `/guide` |
|
|
49
|
+
| `news/2025/intro.md` | `/news/2025/intro` |
|
|
50
|
+
| `interactive.mdx` | `/interactive` |
|
|
51
51
|
|
|
52
52
|
Produktionsbuilds schreiben Verzeichnis-Indexe (`dist/about/index.html`), damit URLs ohne `.html` funktionieren.
|
|
53
53
|
|
|
@@ -60,8 +60,8 @@ Standardmäßig liegen Markdown-Dateien im Projektroot neben `.preactpress/`. Du
|
|
|
60
60
|
```ts
|
|
61
61
|
// .preactpress/config.ts
|
|
62
62
|
export default {
|
|
63
|
-
srcDir:
|
|
64
|
-
}
|
|
63
|
+
srcDir: "docs",
|
|
64
|
+
};
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
Dann gehören alle Seiten nach `docs/` — z. B. `docs/index.md` → `/`, `docs/guide/foo.md` → `/guide/foo`. Die URLs bleiben gleich; nur der Speicherort der Dateien ändert sich.
|
|
@@ -78,14 +78,14 @@ layout: doc
|
|
|
78
78
|
---
|
|
79
79
|
```
|
|
80
80
|
|
|
81
|
-
| Feld
|
|
82
|
-
|
|
|
83
|
-
| `title`
|
|
84
|
-
| `description`
|
|
85
|
-
| `layout: doc`
|
|
86
|
-
| `layout: page` | Inhaltsseite ohne Sidebar und ohne Doku-Gliederung
|
|
87
|
-
| `layout: home` | Startseiten-Layout mit optional `hero` und `features`
|
|
88
|
-
| `draft: true`
|
|
81
|
+
| Feld | Zweck |
|
|
82
|
+
| -------------- | -------------------------------------------------------- |
|
|
83
|
+
| `title` | Seitentitel (Navigation, `<title>`, Suche) |
|
|
84
|
+
| `description` | Zusammenfassung für SEO und Suche |
|
|
85
|
+
| `layout: doc` | Doku-Layout mit Sidebar, Gliederung und Vor/Zurück-Links |
|
|
86
|
+
| `layout: page` | Inhaltsseite ohne Sidebar und ohne Doku-Gliederung |
|
|
87
|
+
| `layout: home` | Startseiten-Layout mit optional `hero` und `features` |
|
|
88
|
+
| `draft: true` | Seite wird aus Build, Sitemap und Suche ausgeschlossen |
|
|
89
89
|
|
|
90
90
|
Weitere Felder (`tags`, `sidebar: false`, `navbar: false`, …) stehen im README des npm-Pakets bzw. in der Referenz des Starters.
|
|
91
91
|
|
|
@@ -99,7 +99,7 @@ title: Demo
|
|
|
99
99
|
description: Interaktive Komponente
|
|
100
100
|
---
|
|
101
101
|
|
|
102
|
-
import Counter from
|
|
102
|
+
import Counter from "./components/Counter.tsx";
|
|
103
103
|
|
|
104
104
|
## Zähler
|
|
105
105
|
|
|
@@ -118,20 +118,20 @@ Neue Seiten erscheinen **nicht automatisch** in der Kopfzeile oder Sidebar. Trag
|
|
|
118
118
|
export default {
|
|
119
119
|
themeConfig: {
|
|
120
120
|
nav: [
|
|
121
|
-
{ text:
|
|
122
|
-
{ text:
|
|
121
|
+
{ text: "Start", link: "/" },
|
|
122
|
+
{ text: "Kontakt", link: "/kontakt" },
|
|
123
123
|
],
|
|
124
124
|
sidebar: [
|
|
125
125
|
{
|
|
126
|
-
text:
|
|
126
|
+
text: "Anleitung",
|
|
127
127
|
items: [
|
|
128
|
-
{ text:
|
|
129
|
-
{ text:
|
|
130
|
-
]
|
|
131
|
-
}
|
|
132
|
-
]
|
|
133
|
-
}
|
|
134
|
-
}
|
|
128
|
+
{ text: "Seiten erstellen", link: "/de/guide/seiten-erstellen" },
|
|
129
|
+
{ text: "Kontakt", link: "/kontakt" },
|
|
130
|
+
],
|
|
131
|
+
},
|
|
132
|
+
],
|
|
133
|
+
},
|
|
134
|
+
};
|
|
135
135
|
```
|
|
136
136
|
|
|
137
137
|
Bei mehrsprachigen Sites (`locales`) gehören `nav` und `sidebar` in die jeweilige Locale-Konfiguration — siehe [Getting Started](/de/guide/getting-started).
|
|
@@ -154,18 +154,18 @@ Die deutsche Version ist eine **eigene Datei**, kein Alias der englischen Seite.
|
|
|
154
154
|
|
|
155
155
|
## Typische Fehler
|
|
156
156
|
|
|
157
|
-
| Problem
|
|
158
|
-
|
|
|
159
|
-
| Seite 404
|
|
160
|
-
| Link in Markdown funktioniert nicht | Extension weglassen: `/guide/foo`, nicht `/guide/foo.md`
|
|
161
|
-
| Doppelte URL
|
|
162
|
-
| Seite fehlt in der Navigation
|
|
157
|
+
| Problem | Lösung |
|
|
158
|
+
| ----------------------------------- | ------------------------------------------------------------------------------------- |
|
|
159
|
+
| Seite 404 | Dateiendung `.md` / `.mdx`? Liegt die Datei unter `srcDir`? Dev-Server läuft? |
|
|
160
|
+
| Link in Markdown funktioniert nicht | Extension weglassen: `/guide/foo`, nicht `/guide/foo.md` |
|
|
161
|
+
| Doppelte URL | Zwei Dateien dürfen nicht dieselbe Route erzeugen (z. B. `foo.md` und `foo/index.md`) |
|
|
162
|
+
| Seite fehlt in der Navigation | `nav` / `sidebar` in der Config ergänzen |
|
|
163
163
|
|
|
164
164
|
## Nächste Schritte
|
|
165
165
|
|
|
166
|
-
| Thema
|
|
167
|
-
|
|
|
166
|
+
| Thema | Link |
|
|
167
|
+
| ----------------------------- | ---------------------------------------------------- |
|
|
168
168
|
| Erste Änderungen in 5 Minuten | [Die ersten 5 Minuten](/de/guide/first-five-minutes) |
|
|
169
|
-
| Routing, `srcDir`, Tags
|
|
170
|
-
| Markdown-Syntax
|
|
171
|
-
| Produktion bauen
|
|
169
|
+
| Routing, `srcDir`, Tags | [Routing](/de/guide/routing) |
|
|
170
|
+
| Markdown-Syntax | [Markdown-Beispiele](/de/markdown-examples) |
|
|
171
|
+
| Produktion bauen | [Deploy](/de/guide/deploy) |
|