@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
|
@@ -1,158 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="en">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>Configuration | Hono Starter</title>
|
|
7
|
-
<script src="/preactpress-theme.js"></script>
|
|
8
|
-
<meta name="description" content="Site config, theme options, and common frontmatter fields">
|
|
9
|
-
<meta property="og:title" content="Configuration | Hono Starter">
|
|
10
|
-
<meta property="og:description" content="Site config, theme options, and common frontmatter fields">
|
|
11
|
-
<meta property="og:type" content="website">
|
|
12
|
-
<meta property="og:url" content="/guide/configuration/">
|
|
13
|
-
<meta name="twitter:card" content="summary">
|
|
14
|
-
<meta name="twitter:title" content="Configuration | Hono Starter">
|
|
15
|
-
<meta name="twitter:description" content="Site config, theme options, and common frontmatter fields">
|
|
16
|
-
<link rel="canonical" href="/guide/configuration/">
|
|
17
|
-
<script type="application/ld+json">{"@context":"https://schema.org","@type":"WebPage","headline":"Configuration | Hono Starter","name":"Configuration | Hono Starter","description":"Site config, theme options, and common frontmatter fields","url":"/guide/configuration/","dateModified":"2026-06-05T06:34:20.411Z"}</script>
|
|
18
|
-
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
|
|
19
|
-
<link rel="icon" href="/favicon-32.png" type="image/png" sizes="32x32">
|
|
20
|
-
<link rel="icon" href="/favicon.png" type="image/png" sizes="any">
|
|
21
|
-
<link rel="apple-touch-icon" href="/favicon.png">
|
|
22
|
-
<link rel="stylesheet" crossorigin href="/assets/main-DIIN7FO0.css">
|
|
23
|
-
</head>
|
|
24
|
-
<body>
|
|
25
|
-
<template id="__PREACTPRESS_PAGE_DATA__">{"kind":"markdown","meta":{"title":"Configuration","description":"Site config, theme options, and common frontmatter fields"},"html":"\u003cp>Configuration lives in \u003ccode>.preactpress/config.ts\u003c/code> at your site root.\u003c/p>\n\u003ch2 id=\"site-metadata\" class=\"pp-heading\">Site metadata\u003ca class=\"pp-heading-anchor\" href=\"#site-metadata\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h2>\n\u003cpre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\">\u003ccode>\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#F97583\">export\u003c/span>\u003cspan style=\"color:#D73A49;--shiki-dark:#F97583\"> default\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> site: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> title: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'My docs'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> description: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Short site summary for SEO'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> base: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> url: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'https://example.com'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> titleTemplate: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">':title | :siteTitle'\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">}\u003c/span>\u003c/span>\u003c/code>\u003c/pre>\u003cp>Set \u003ccode>site.url\u003c/code> before production so canonical URLs, \u003ccode>sitemap.xml\u003c/code>, Open Graph, and \u003ccode>hreflang\u003c/code> alternates resolve correctly.\u003c/p>\n\u003ch2 id=\"content-directory\" class=\"pp-heading\">Content directory\u003ca class=\"pp-heading-anchor\" href=\"#content-directory\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h2>\n\u003ctable>\n\u003cthead>\n\u003ctr>\n\u003cth>Option\u003c/th>\n\u003cth>Purpose\u003c/th>\n\u003c/tr>\n\u003c/thead>\n\u003ctbody>\n\u003ctr>\n\u003ctd>\u003ccode>srcDir\u003c/code>\u003c/td>\n\u003ctd>Folder with \u003ccode>.md\u003c/code> / \u003ccode>.mdx\u003c/code> pages (default \u003ccode>.\u003c/code>)\u003c/td>\n\u003c/tr>\n\u003ctr>\n\u003ctd>\u003ccode>srcExclude\u003c/code>\u003c/td>\n\u003ctd>Glob patterns for non-page Markdown, e.g. \u003ccode>['**/README.md']\u003c/code>\u003c/td>\n\u003c/tr>\n\u003ctr>\n\u003ctd>\u003ccode>lastUpdatedGit\u003c/code>\u003c/td>\n\u003ctd>Use git commit time for “last updated” (falls back to file mtime)\u003c/td>\n\u003c/tr>\n\u003c/tbody>\n\u003c/table>\n\u003ch2 id=\"theme-without-custom-code\" class=\"pp-heading\">Theme without custom code\u003ca class=\"pp-heading-anchor\" href=\"#theme-without-custom-code\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h2>\n\u003cp>\u003ccode>themeConfig\u003c/code> drives the default layout:\u003c/p>\n\u003cul>\n\u003cli>\u003ccode>nav\u003c/code> — top links; supports nested dropdowns via \u003ccode>items\u003c/code>\u003c/li>\n\u003cli>\u003ccode>sidebar\u003c/code> — flat array \u003cstrong>or\u003c/strong> path map: \u003ccode>{ '/guide/': [...], '/reference/': [...] }\u003c/code>; groups and items support \u003ccode>collapsed\u003c/code> and nested \u003ccode>items\u003c/code>\u003c/li>\n\u003cli>\u003ccode>outline\u003c/code>, \u003ccode>search\u003c/code>, \u003ccode>socialLinks\u003c/code>, \u003ccode>footer\u003c/code>, \u003ccode>lastUpdated\u003c/code>, \u003ccode>editLink\u003c/code>, \u003ccode>logo\u003c/code>, \u003ccode>labels\u003c/code>\u003c/li>\n\u003cli>\u003ccode>logo\u003c/code> — string URL or \u003ccode>{ light, dark }\u003c/code> for theme-aware images\u003c/li>\n\u003cli>\u003ccode>search\u003c/code> — \u003ccode>true\u003c/code> or \u003ccode>{ provider: 'local' }\u003c/code> for sidebar search; \u003ccode>{ provider: 'algolia', options }\u003c/code> for Algolia DocSearch in the nav bar\u003c/li>\n\u003cli>\u003ccode>socialLinks\u003c/code> — \u003ccode>{ icon, link, ariaLabel? }[]\u003c/code> with built-in icons (\u003ccode>github\u003c/code>, \u003ccode>discord\u003c/code>, \u003ccode>x\u003c/code>, …) or custom \u003ccode>{ svg }\u003c/code>\u003c/li>\n\u003c/ul>\n\u003cp>Per-locale overrides go under \u003ccode>locales.&lt;key&gt;.themeConfig\u003c/code>.\u003c/p>\n\u003cp>Example nested nav and sidebar:\u003c/p>\n\u003cpre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\">\u003ccode>\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">themeConfig\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> logo\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: { \u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">light\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/logo-light.svg'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, \u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">dark\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/logo-dark.svg'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> labels\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: { \u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">search\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Find pages'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> nav\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> { text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Guide'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, items: [{ text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Intro'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, link: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/guide/intro'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }] },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> { text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Blog'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, link: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/blog'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> sidebar\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Guide'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> collapsed: \u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#79B8FF\">false\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> items: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> { text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Intro'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, link: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/guide/intro'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Advanced'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> collapsed: \u003c/span>\u003cspan style=\"color:#005CC5;--shiki-dark:#79B8FF\">true\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> items: [{ text: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'API'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, link: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'/guide/api'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">}\u003c/span>\u003c/span>\u003c/code>\u003c/pre>\u003ch3 id=\"search-providers\" class=\"pp-heading\">Search providers\u003ca class=\"pp-heading-anchor\" href=\"#search-providers\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h3>\n\u003cp>Local search (default when \u003ccode>search: true\u003c/code>) filters the sidebar and loads \u003ccode>preactpress-search.json\u003c/code> at build time.\u003c/p>\n\u003cp>Algolia DocSearch mounts a search button in the nav bar:\u003c/p>\n\u003cpre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\">\u003ccode>\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">themeConfig\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> search\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> provider\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'algolia'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> options\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> appId\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'YOUR_APP_ID'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> apiKey\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'YOUR_SEARCH_API_KEY'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> indexName\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'YOUR_INDEX_NAME'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> locales\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> de\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: { \u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">indexName\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'YOUR_DE_INDEX'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">}\u003c/span>\u003c/span>\u003c/code>\u003c/pre>\u003ch3 id=\"social-links\" class=\"pp-heading\">Social links\u003ca class=\"pp-heading-anchor\" href=\"#social-links\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h3>\n\u003cpre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\">\u003ccode>\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">themeConfig\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\"> socialLinks\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> { icon: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'github'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, link: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'https://github.com/your-org/your-repo'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> { icon: { svg: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'&#x3C;svg ...>&#x3C;/svg>'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }, link: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'https://example.com'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, ariaLabel: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'Company site'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">}\u003c/span>\u003c/span>\u003c/code>\u003c/pre>\u003ch2 id=\"global-head-tags\" class=\"pp-heading\">Global head tags\u003ca class=\"pp-heading-anchor\" href=\"#global-head-tags\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h2>\n\u003cpre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\">\u003ccode>\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">head\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> [\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'meta'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, { name: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'theme-color'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, content: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'#0f766e'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> }]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">async \u003c/span>\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">transformHead\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">({ route, title, tags, site }) {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#D73A49;--shiki-dark:#F97583\"> return\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> [[\u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'meta'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, { name: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">'pp-route'\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">, content: route }]]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">}\u003c/span>\u003c/span>\u003c/code>\u003c/pre>\u003ch2 id=\"page-frontmatter\" class=\"pp-heading\">Page frontmatter\u003ca class=\"pp-heading-anchor\" href=\"#page-frontmatter\" aria-label=\"Link to this section\">#\u003c/a>\u003c/h2>\n\u003ctable>\n\u003cthead>\n\u003ctr>\n\u003cth>Field\u003c/th>\n\u003cth>Purpose\u003c/th>\n\u003c/tr>\n\u003c/thead>\n\u003ctbody>\n\u003ctr>\n\u003ctd>\u003ccode>title\u003c/code> / \u003ccode>description\u003c/code>\u003c/td>\n\u003ctd>Page title and SEO summary\u003c/td>\n\u003c/tr>\n\u003ctr>\n\u003ctd>\u003ccode>titleTemplate\u003c/code>\u003c/td>\n\u003ctd>Override site template; \u003ccode>false\u003c/code> uses the raw page title\u003c/td>\n\u003c/tr>\n\u003ctr>\n\u003ctd>\u003ccode>head\u003c/code>\u003c/td>\n\u003ctd>Extra \u003ccode>&lt;meta&gt;\u003c/code> / \u003ccode>&lt;link&gt;\u003c/code> / \u003ccode>&lt;script&gt;\u003c/code> tags for this page only\u003c/td>\n\u003c/tr>\n\u003ctr>\n\u003ctd>\u003ccode>draft: true\u003c/code>\u003c/td>\n\u003ctd>Excluded from routes, search, and sitemap\u003c/td>\n\u003c/tr>\n\u003c/tbody>\n\u003c/table>\n\u003cp>Example per-page head:\u003c/p>\n\u003cpre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8\" tabindex=\"0\">\u003ccode>\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">---\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#22863A;--shiki-dark:#85E89D\">title\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">About\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#22863A;--shiki-dark:#85E89D\">head\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> - - \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">meta\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\"> - \u003c/span>\u003cspan style=\"color:#22863A;--shiki-dark:#85E89D\">name\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">author\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#22863A;--shiki-dark:#85E89D\"> content\u003c/span>\u003cspan style=\"color:#24292E;--shiki-dark:#E1E4E8\">: \u003c/span>\u003cspan style=\"color:#032F62;--shiki-dark:#9ECBFF\">Your Name\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6F42C1;--shiki-dark:#B392F0\">---\u003c/span>\u003c/span>\u003c/code>\u003c/pre>\u003cdiv class=\"pp-container pp-container-warning\">\u003cp class=\"pp-container-title\">WARNING\u003c/p>\u003cdiv class=\"pp-container-body\">\u003cp>Enable \u003ccode>markdown.html\u003c/code> only for trusted authors — it allows raw HTML in Markdown.\u003c/p>\n\u003c/div>\u003c/div>","title":"Configuration","description":"Site config, theme options, and common frontmatter fields","tags":[],"pageType":"website","headings":[{"id":"site-metadata","text":"Site metadata","level":2},{"id":"content-directory","text":"Content directory","level":2},{"id":"theme-without-custom-code","text":"Theme without custom code","level":2},{"id":"search-providers","text":"Search providers","level":3},{"id":"social-links","text":"Social links","level":3},{"id":"global-head-tags","text":"Global head tags","level":2},{"id":"page-frontmatter","text":"Page frontmatter","level":2}],"relativePath":"guide/configuration.md","lastUpdated":"2026-06-05T06:34:20.411Z"}</template>
|
|
26
|
-
<div id="app"><div class="hn-site"><a class="hn-skip" href="#content">Skip to content</a><header class="hn-header"><div class="hn-header-inner"><a class="hn-brand" href="/" aria-label="Hono Starter"><span class="hn-logo" aria-label="Hono Starter"><svg aria-hidden="true" viewBox="0 0 36 36" width="36" height="36"><rect width="36" height="36" rx="11" fill="currentColor" opacity="0.12"></rect><path d="M19.8 5.5c.8 4-2.8 5.9-4.7 8.2-1.8 2.1-2.5 4.9-.3 7 0-2.8 1.7-4.6 4.2-6.7 3.2 3 5.3 5.8 5.3 9.2 0 4.4-3.3 7.3-7.6 7.3-4.8 0-8.3-3.6-8.3-8.4 0-6.1 6.3-9.2 11.4-16.6Z" fill="currentColor"></path><path d="M21.7 25.7c0 2.2-1.7 3.8-3.9 3.8s-4-1.6-4-3.8c0-1.7 1-3.1 3.4-5.2.1 1.7 1.4 2.6 2.4 3.4.8.6 2.1 1 2.1 1.8Z" fill="currentColor" opacity="0.38"></path></svg><span>Hono Starter</span></span></a><div class="hn-header-actions"><nav class="hn-nav" aria-label="Main navigation"><a class href="/guide/what-is-preactpress">Docs</a><a class href="/markdown-examples">Examples</a><a class href="/about">About</a></nav><div class="hn-social" aria-label="Social links"><a href="https://github.com/your-org/your-project" aria-label="GitHub"><span><svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path fill="currentColor" d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.404 1.02.005 2.04.137 3 .404 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg></span></a></div><details class="hn-locale-switcher"><summary>English</summary><div class="hn-locale-menu"><a href="/guide/configuration" aria-current="page" class="active">English</a><a href="/de/guide/configuration" class>Deutsch</a></div></details><button type="button" class="hn-theme-toggle" aria-label="Toggle theme"><span class="hn-theme-toggle-moon" aria-hidden="true"><svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor"><path d="M21 14.8A8.5 8.5 0 0 1 9.2 3a7 7 0 1 0 11.8 11.8Z" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.7"></path></svg></span><span class="hn-theme-toggle-sun" aria-hidden="true"><svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor"><circle cx="12" cy="12" r="3.5" stroke-width="1.7"></circle><path d="M12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4" stroke-linecap="round" stroke-width="1.7"></path></svg></span></button></div></div></header><div class="hn-doc-shell"><aside class="hn-sidebar" aria-label="Documentation navigation"><div class="hn-sidebar-panel"><label class="hn-search"><span>Search pages</span><input type="search" value placeholder="Filter documentation..."/></label><div class="hn-sidebar-group"><h2>Introduction</h2><ul><li><a class href="/">Welcome</a></li><li><a class href="/guide/what-is-preactpress">What is PreactPress?</a></li><li><a class href="/guide/getting-started">Getting Started</a></li><li><a class href="/guide/routing">Routing</a></li><li><a class href="/guide/deploy">Deploy</a></li><li><a class href="/guide/first-five-minutes">Your first 5 minutes</a></li><li><a class href="/guide/creating-pages">Creating pages</a></li><li><a class href="/guide/commands">Commands</a></li><li><a class="active" href="/guide/configuration" aria-current="page">Configuration</a></li></ul></div><div class="hn-sidebar-group"><h2>Reference</h2><ul><li><a class href="/markdown-examples">Markdown examples</a></li><li><a class href="/interactive">Interactive MDX</a></li></ul></div></div></aside><main id="content" class="hn-doc-main"><article class="hn-doc"><h1 class="hn-doc-title">Configuration</h1><p class="hn-doc-lead">Site config, theme options, and common frontmatter fields</p><div class="hn-doc-content"><p>Configuration lives in <code>.preactpress/config.ts</code> at your site root.</p>
|
|
27
|
-
<h2 id="site-metadata" class="pp-heading">Site metadata<a class="pp-heading-anchor" href="#site-metadata" aria-label="Link to this section">#</a></h2>
|
|
28
|
-
<pre class="shiki shiki-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8" tabindex="0"><code><span class="line"><span style="color:#D73A49;--shiki-dark:#F97583">export</span><span style="color:#D73A49;--shiki-dark:#F97583"> default</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> {</span></span>
|
|
29
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> site: {</span></span>
|
|
30
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> title: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'My docs'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
31
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> description: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Short site summary for SEO'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
32
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> base: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
33
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> url: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'https://example.com'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
34
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> titleTemplate: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">':title | :siteTitle'</span></span>
|
|
35
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
36
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre><p>Set <code>site.url</code> before production so canonical URLs, <code>sitemap.xml</code>, Open Graph, and <code>hreflang</code> alternates resolve correctly.</p>
|
|
37
|
-
<h2 id="content-directory" class="pp-heading">Content directory<a class="pp-heading-anchor" href="#content-directory" aria-label="Link to this section">#</a></h2>
|
|
38
|
-
<table>
|
|
39
|
-
<thead>
|
|
40
|
-
<tr>
|
|
41
|
-
<th>Option</th>
|
|
42
|
-
<th>Purpose</th>
|
|
43
|
-
</tr>
|
|
44
|
-
</thead>
|
|
45
|
-
<tbody>
|
|
46
|
-
<tr>
|
|
47
|
-
<td><code>srcDir</code></td>
|
|
48
|
-
<td>Folder with <code>.md</code> / <code>.mdx</code> pages (default <code>.</code>)</td>
|
|
49
|
-
</tr>
|
|
50
|
-
<tr>
|
|
51
|
-
<td><code>srcExclude</code></td>
|
|
52
|
-
<td>Glob patterns for non-page Markdown, e.g. <code>['**/README.md']</code></td>
|
|
53
|
-
</tr>
|
|
54
|
-
<tr>
|
|
55
|
-
<td><code>lastUpdatedGit</code></td>
|
|
56
|
-
<td>Use git commit time for “last updated” (falls back to file mtime)</td>
|
|
57
|
-
</tr>
|
|
58
|
-
</tbody>
|
|
59
|
-
</table>
|
|
60
|
-
<h2 id="theme-without-custom-code" class="pp-heading">Theme without custom code<a class="pp-heading-anchor" href="#theme-without-custom-code" aria-label="Link to this section">#</a></h2>
|
|
61
|
-
<p><code>themeConfig</code> drives the default layout:</p>
|
|
62
|
-
<ul>
|
|
63
|
-
<li><code>nav</code> — top links; supports nested dropdowns via <code>items</code></li>
|
|
64
|
-
<li><code>sidebar</code> — flat array <strong>or</strong> path map: <code>{ '/guide/': [...], '/reference/': [...] }</code>; groups and items support <code>collapsed</code> and nested <code>items</code></li>
|
|
65
|
-
<li><code>outline</code>, <code>search</code>, <code>socialLinks</code>, <code>footer</code>, <code>lastUpdated</code>, <code>editLink</code>, <code>logo</code>, <code>labels</code></li>
|
|
66
|
-
<li><code>logo</code> — string URL or <code>{ light, dark }</code> for theme-aware images</li>
|
|
67
|
-
<li><code>search</code> — <code>true</code> or <code>{ provider: 'local' }</code> for sidebar search; <code>{ provider: 'algolia', options }</code> for Algolia DocSearch in the nav bar</li>
|
|
68
|
-
<li><code>socialLinks</code> — <code>{ icon, link, ariaLabel? }[]</code> with built-in icons (<code>github</code>, <code>discord</code>, <code>x</code>, …) or custom <code>{ svg }</code></li>
|
|
69
|
-
</ul>
|
|
70
|
-
<p>Per-locale overrides go under <code>locales.<key>.themeConfig</code>.</p>
|
|
71
|
-
<p>Example nested nav and sidebar:</p>
|
|
72
|
-
<pre class="shiki shiki-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8" tabindex="0"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">themeConfig</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
|
|
73
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> logo</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: { </span><span style="color:#6F42C1;--shiki-dark:#B392F0">light</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/logo-light.svg'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, </span><span style="color:#6F42C1;--shiki-dark:#B392F0">dark</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/logo-dark.svg'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> },</span></span>
|
|
74
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> labels</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: { </span><span style="color:#6F42C1;--shiki-dark:#B392F0">search</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Find pages'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> },</span></span>
|
|
75
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> nav</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: [</span></span>
|
|
76
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> { text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Guide'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, items: [{ text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Intro'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, link: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/guide/intro'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }] },</span></span>
|
|
77
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> { text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Blog'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, link: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/blog'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
78
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> ],</span></span>
|
|
79
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> sidebar</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: [</span></span>
|
|
80
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> {</span></span>
|
|
81
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Guide'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
82
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> collapsed: </span><span style="color:#005CC5;--shiki-dark:#79B8FF">false</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
83
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> items: [</span></span>
|
|
84
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> { text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Intro'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, link: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/guide/intro'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> },</span></span>
|
|
85
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> {</span></span>
|
|
86
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Advanced'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
87
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> collapsed: </span><span style="color:#005CC5;--shiki-dark:#79B8FF">true</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
88
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> items: [{ text: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'API'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, link: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'/guide/api'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }]</span></span>
|
|
89
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
90
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> ]</span></span>
|
|
91
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
92
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> ]</span></span>
|
|
93
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre><h3 id="search-providers" class="pp-heading">Search providers<a class="pp-heading-anchor" href="#search-providers" aria-label="Link to this section">#</a></h3>
|
|
94
|
-
<p>Local search (default when <code>search: true</code>) filters the sidebar and loads <code>preactpress-search.json</code> at build time.</p>
|
|
95
|
-
<p>Algolia DocSearch mounts a search button in the nav bar:</p>
|
|
96
|
-
<pre class="shiki shiki-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8" tabindex="0"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">themeConfig</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
|
|
97
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> search</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
|
|
98
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> provider</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'algolia'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
99
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> options</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
|
|
100
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> appId</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'YOUR_APP_ID'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
101
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> apiKey</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'YOUR_SEARCH_API_KEY'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
102
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> indexName</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'YOUR_INDEX_NAME'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">,</span></span>
|
|
103
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> locales</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
|
|
104
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> de</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: { </span><span style="color:#6F42C1;--shiki-dark:#B392F0">indexName</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'YOUR_DE_INDEX'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
105
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
106
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
107
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
108
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre><h3 id="social-links" class="pp-heading">Social links<a class="pp-heading-anchor" href="#social-links" aria-label="Link to this section">#</a></h3>
|
|
109
|
-
<pre class="shiki shiki-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8" tabindex="0"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">themeConfig</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: {</span></span>
|
|
110
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0"> socialLinks</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: [</span></span>
|
|
111
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> { icon: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'github'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, link: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'https://github.com/your-org/your-repo'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> },</span></span>
|
|
112
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> { icon: { svg: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'<svg ...></svg>'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }, link: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'https://example.com'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, ariaLabel: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'Company site'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }</span></span>
|
|
113
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> ]</span></span>
|
|
114
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre><h2 id="global-head-tags" class="pp-heading">Global head tags<a class="pp-heading-anchor" href="#global-head-tags" aria-label="Link to this section">#</a></h2>
|
|
115
|
-
<pre class="shiki shiki-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8" tabindex="0"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">head</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: [</span></span>
|
|
116
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> [</span><span style="color:#032F62;--shiki-dark:#9ECBFF">'meta'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, { name: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'theme-color'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, content: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'#0f766e'</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> }]</span></span>
|
|
117
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">],</span></span>
|
|
118
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">async </span><span style="color:#6F42C1;--shiki-dark:#B392F0">transformHead</span><span style="color:#24292E;--shiki-dark:#E1E4E8">({ route, title, tags, site }) {</span></span>
|
|
119
|
-
<span class="line"><span style="color:#D73A49;--shiki-dark:#F97583"> return</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> [[</span><span style="color:#032F62;--shiki-dark:#9ECBFF">'meta'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, { name: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">'pp-route'</span><span style="color:#24292E;--shiki-dark:#E1E4E8">, content: route }]]</span></span>
|
|
120
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8">}</span></span></code></pre><h2 id="page-frontmatter" class="pp-heading">Page frontmatter<a class="pp-heading-anchor" href="#page-frontmatter" aria-label="Link to this section">#</a></h2>
|
|
121
|
-
<table>
|
|
122
|
-
<thead>
|
|
123
|
-
<tr>
|
|
124
|
-
<th>Field</th>
|
|
125
|
-
<th>Purpose</th>
|
|
126
|
-
</tr>
|
|
127
|
-
</thead>
|
|
128
|
-
<tbody>
|
|
129
|
-
<tr>
|
|
130
|
-
<td><code>title</code> / <code>description</code></td>
|
|
131
|
-
<td>Page title and SEO summary</td>
|
|
132
|
-
</tr>
|
|
133
|
-
<tr>
|
|
134
|
-
<td><code>titleTemplate</code></td>
|
|
135
|
-
<td>Override site template; <code>false</code> uses the raw page title</td>
|
|
136
|
-
</tr>
|
|
137
|
-
<tr>
|
|
138
|
-
<td><code>head</code></td>
|
|
139
|
-
<td>Extra <code><meta></code> / <code><link></code> / <code><script></code> tags for this page only</td>
|
|
140
|
-
</tr>
|
|
141
|
-
<tr>
|
|
142
|
-
<td><code>draft: true</code></td>
|
|
143
|
-
<td>Excluded from routes, search, and sitemap</td>
|
|
144
|
-
</tr>
|
|
145
|
-
</tbody>
|
|
146
|
-
</table>
|
|
147
|
-
<p>Example per-page head:</p>
|
|
148
|
-
<pre class="shiki shiki-themes github-light github-dark" style="background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8" tabindex="0"><code><span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">---</span></span>
|
|
149
|
-
<span class="line"><span style="color:#22863A;--shiki-dark:#85E89D">title</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">About</span></span>
|
|
150
|
-
<span class="line"><span style="color:#22863A;--shiki-dark:#85E89D">head</span><span style="color:#24292E;--shiki-dark:#E1E4E8">:</span></span>
|
|
151
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> - - </span><span style="color:#032F62;--shiki-dark:#9ECBFF">meta</span></span>
|
|
152
|
-
<span class="line"><span style="color:#24292E;--shiki-dark:#E1E4E8"> - </span><span style="color:#22863A;--shiki-dark:#85E89D">name</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">author</span></span>
|
|
153
|
-
<span class="line"><span style="color:#22863A;--shiki-dark:#85E89D"> content</span><span style="color:#24292E;--shiki-dark:#E1E4E8">: </span><span style="color:#032F62;--shiki-dark:#9ECBFF">Your Name</span></span>
|
|
154
|
-
<span class="line"><span style="color:#6F42C1;--shiki-dark:#B392F0">---</span></span></code></pre><div class="pp-container pp-container-warning"><p class="pp-container-title">WARNING</p><div class="pp-container-body"><p>Enable <code>markdown.html</code> only for trusted authors — it allows raw HTML in Markdown.</p>
|
|
155
|
-
</div></div></div><nav class="hn-pager" aria-label="Page navigation"><a class="previous" href="/guide/commands"><span>Previous</span>Commands</a><a class="next" href="/markdown-examples"><span>Next</span>Markdown examples</a></nav><footer class="hn-doc-meta"><span>Updated Jun 5, 2026</span></footer></article></main><aside class="hn-outline" aria-label="On this page"><div class="hn-outline-panel"><h2>On this page</h2><ul><li class="level-2"><a href="#site-metadata">Site metadata</a></li><li class="level-2"><a href="#content-directory">Content directory</a></li><li class="level-2"><a href="#theme-without-custom-code">Theme without custom code</a></li><li class="level-3"><a href="#search-providers">Search providers</a></li><li class="level-3"><a href="#social-links">Social links</a></li><li class="level-2"><a href="#global-head-tags">Global head tags</a></li><li class="level-2"><a href="#page-frontmatter">Page frontmatter</a></li></ul></div></aside></div><footer class="hn-footer">Built with PreactPress.</footer></div></div>
|
|
156
|
-
<script type="module" crossorigin src="/assets/main-Bqi-VFEk.js"></script>
|
|
157
|
-
</body>
|
|
158
|
-
</html>
|