`,
- ``,
- [
- `**Type:** \`${typesFormatted}\``,
- cliFlag ? `**CLI:** \`${cliFlag.text}\`` : undefined,
- comment.defaultvalue ? `**Default:** ${comment.defaultvalue}` : undefined,
- comment.version ? `` : undefined,
- ]
- .filter((l) => l !== undefined)
- .join('
\n'),
- `
`,
- ``,
- comment.description && comment.description.trim(),
+ getCommentProperties(comment),
+ comment.description?.trim() || undefined,
comment.see
? `**See Also:**\n${comment.see.map((s) => `- ${s}`.trim()).join('\n')}`
: undefined,
- `\n\n`,
+ `\n`,
]
.filter((l) => l !== undefined)
.join('\n');
}
+ // Make any links to docs relative instead of absolute.
result = result.replace(/https:\/\/docs\.astro\.build\//g, '/');
- console.log(result);
+ console.timeEnd(task);
+ task = 'Update configuration-reference.mdx';
+ console.time(task);
+
fs.writeFileSync(
'src/content/docs/en/reference/configuration-reference.mdx',
HEADER + result + FOOTER,
'utf8'
);
+
+ console.timeEnd(task);
+}
+
+/**
+ * Create a string of ### to create a Markdown heading for the given level.
+ * @param {number} headingLevel
+ */
+function h(headingLevel) {
+ return Array.from({ length: headingLevel }).fill('#').join('');
}
+/**
+ * Get a Markdown heading of the correct level for this comment.
+ * @param {{ kind: string | undefined; longname: string }} comment
+ */
+function getHeading(comment) {
+ let headingLevel = 3;
+ const headingMatches = /^h(1|2|3|4|5|6)$/.exec(comment.kind || '');
+ if (headingMatches) {
+ headingLevel = parseInt(headingMatches[1]);
+ } else if (comment.kind === 'heading') {
+ headingLevel = 2;
+ }
+ return `${h(headingLevel)} ${comment.longname}\n`;
+}
+
+/**
+ * Get a `:::caution` block if the passed tag is deprecated.
+ * @param {string | undefined} tag
+ */
function getDeprecatedAside(tag) {
if (!tag) return undefined;
return [
@@ -133,4 +146,31 @@ function getDeprecatedAside(tag) {
].join('\n');
}
+/**
+ * Get block of type, CLI command, default value, and version added in for the current comment.
+ * @param {{ tags: { title: string; text: string }[]; kind: string; type?: { names: string [] }; defaultvalue?: string; version?: string }} comment
+ */
+function getCommentProperties(comment) {
+ const cliFlag = comment.tags.find((f) => f.title === 'cli');
+ const typerawFlag = comment.tags.find((f) => f.title === 'typeraw');
+
+ if (comment.kind !== 'heading' && !comment.type && !typerawFlag) {
+ throw new Error(`Missing @docs JSDoc tag: @type or @typeraw`);
+ }
+ const typesFormatted = typerawFlag
+ ? typerawFlag.text.replace(/\{(.*)\}/, '$1')
+ : comment.type?.names.join(' | ');
+
+ const properties = [
+ typesFormatted ? `**Type:** \`${typesFormatted}\`` : undefined,
+ cliFlag ? `**CLI:** \`${cliFlag.text}\`` : undefined,
+ comment.defaultvalue ? `**Default:** ${comment.defaultvalue}` : undefined,
+ comment.version ? `` oder `<>` eingebettet werden muss, im Gegensatz zu JavaScript oder JSX.
+
+```astro title="src/components/RootElements.astro"
+---
+// Vorlage mit mehreren Elementen
+---
+
Es ist nicht erforderlich, Elemente in einen einziges umschließendes Element einzubetten.
+
Astro unterstützt mehrere Root-Elemente in einer Vorlage.
+```
+
+#### Kommentare
+
+In Astro kannst du Standard-HTML-Kommentare oder Kommentare im JavaScript-Stil verwenden.
+
+```astro title="example.astro"
+---
+---
+
+{/* Die Syntax für JS-Kommentare ist ebenfalls gültig */}
+```
+
+:::caution
+HTML-Kommentare werden in dem DOM des Browsers enthalten sein, während JavaScript-Kommentare übersprungen werden. Um TODO-Nachrichten oder andere nur für die Entwicklung bestimmte Erläuterungen zu hinterlassen, empfiehlt es sich, Kommentare im JavaScript-Stil zu verwenden.
+:::
diff --git a/src/content/docs/de/core-concepts/endpoints.mdx b/src/content/docs/de/core-concepts/endpoints.mdx
index 608d54790e5ed..01dcf4feffc35 100644
--- a/src/content/docs/de/core-concepts/endpoints.mdx
+++ b/src/content/docs/de/core-concepts/endpoints.mdx
@@ -99,7 +99,7 @@ Im Gegensatz zum `static`-Modus werden die Endpunkte bei der Konfiguration des `
:::note
-Stelle sicher, dass du [SSR aktivierst](/de/guides/server-side-rendering/#ssr-in-deinem-projekt-aktivieren), bevor du diese Beispiele ausprobierst.
+Stelle sicher, dass du [SSR aktivierst](/de/guides/server-side-rendering/), bevor du diese Beispiele ausprobierst.
:::
Server-Endpunkte können auf `params` zugreifen, ohne `getStaticPaths` zu exportieren, und sie können ein [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)-Objekt zurückgeben, welches dir ermöglicht, Statuscodes und Header zu setzen:
diff --git a/src/content/docs/de/guides/deploy.mdx b/src/content/docs/de/guides/deploy.mdx
index e21dcc2c4663a..fe3866cbacc5b 100644
--- a/src/content/docs/de/guides/deploy.mdx
+++ b/src/content/docs/de/guides/deploy.mdx
@@ -77,6 +77,6 @@ Die Build-Ausgabe wird standardmäßig ins Verzeichnis `dist/` geschrieben. Dies
:::note
Bevor du deine Website mit aktiviertem [SSR (serverseitigem Rendern)](/de/guides/server-side-rendering/) veröffentlichst, stelle bitte Folgendes sicher:
- - Du hast den [geeigneten SSR-Adapter](/de/guides/server-side-rendering/#ssr-in-deinem-projekt-aktivieren) als Projektabhängigkeit installiert.
+ - Du hast den [geeigneten SSR-Adapter](/de/guides/server-side-rendering/) als Projektabhängigkeit installiert.
- Du hast die [Konfiguration angepasst](/de/reference/configuration-reference/#integrations) und den Adapter zu den Imports sowie dem Standard-Export deiner `astro.config.mjs`-Datei hinzugefügt.
:::
diff --git a/src/content/docs/de/guides/rss.mdx b/src/content/docs/de/guides/rss.mdx
index 0b66575d6ccbd..6d61b2e5e4b0c 100644
--- a/src/content/docs/de/guides/rss.mdx
+++ b/src/content/docs/de/guides/rss.mdx
@@ -11,7 +11,7 @@ Astro unterstützt die schnelle, automatische Generierung von RSS-Feeds für Blo
## Einrichten von `@astrojs/rss`
-Das `@astrojs/rss`-Paket bietet Hilfsfunktionen zur Erzeugung von RSS-Feeds mithilfe von [API-Endpunkten](/de/core-concepts/astro-pages/#nicht-html-seiten). Dies ermöglicht statische Feeds _und_ die On-Demand-Generierung bei Verwendung eines [SSR-Adapters](/de/guides/server-side-rendering/#ssr-in-deinem-projekt-aktivieren).
+Das `@astrojs/rss`-Paket bietet Hilfsfunktionen zur Erzeugung von RSS-Feeds mithilfe von [API-Endpunkten](/de/core-concepts/astro-pages/#nicht-html-seiten). Dies ermöglicht statische Feeds _und_ die On-Demand-Generierung bei Verwendung eines [SSR-Adapters](/de/guides/server-side-rendering/).
1. Installiere `@astrojs/rss` mit deinem bevorzugten Paketmanager:
diff --git a/src/content/docs/de/recipes.mdx b/src/content/docs/de/recipes.mdx
new file mode 100644
index 0000000000000..e315f664d12f1
--- /dev/null
+++ b/src/content/docs/de/recipes.mdx
@@ -0,0 +1,38 @@
+---
+title: Mehr Anleitungen
+description: Schau dir geführte Beispiele für die Erstellung von Features in Astro an.
+---
+
+import RecipesNav from '~/components/RecipesNav.astro';
+
+Schau dir geführte Beispiele für das Hinzufügen von Features zu deinem Astro-Projekt an.
+
+## Offizielle Anleitungen
+
+
+
+## Ressourcen aus der Community
+
+Füge hier deine eigene Anleitung hinzu! Weitere Informationen findest du in unserem [recipes contributing guide](https://github.com/withastro/docs/blob/main/contributor-guides/submitting-a-recipe.md).
+
+- [Use a dynamic filename when importing images](https://vaihe.com/blog/astro/astro-dynamic-image-prop/)
+- [Add animated page transitions with Swup](https://navillus.dev/blog/astro-plus-swup)
+- [Use UnoCSS in Astro](https://www.elian.codes/blog/23-02-11-implementing-unocss-in-astro/)
+- [Build a table of contents from Astro's Markdown headings](https://kld.dev/building-table-of-contents/)
+- [Create a Remark plugin to remove runts from your Markdown files](https://eatmon.co/blog/remove-runts-markdown/)
+- [Add searching to your site with Pagefind](https://blog.otterlord.dev/posts/astro-search/)
+- [Add searching to your site with Fuse.js](https://www.youtube.com/watch?v=XnV_2MWqAhQ)
+- [Get VSCode, ESLint & Prettier working with Astro](https://patheticgeek.dev/blog/astro-prettier-eslint-vscode)
+- [Enhance your Astro builds: modify HTML files post-build](https://straffesites.com/en/blog/optimize-astro-html-post-build)
+- [Add dark mode to Astro with Tailwind CSS](https://www.kevinzunigacuellar.com/blog/dark-mode-in-astro/)
+- [Generate localized sitemaps for your Astro and Storyblok project](https://straffesites.com/en/blog/localized-sitemap-astro-storyblok)
+- [Integrate Prettier with Astro and Tailwind CSS](https://straffesites.com/en/blog/integrate-prettier-astro-tailwindcss)
+- [Add an RSS feed to Astro using Storyblok's stories](https://straffesites.com/en/blog/rss-feed-astro-storyblok)
+- [Using tRPC in Astro](https://www.thomasledoux.be/blog/using-trpc-astro-islands-react)
+- [How to make your Astro website multilingual with Crowdin: Astro localization guide](https://crowdin.com/blog/2023/06/21/astro-localization-and-i18n)
+- [Add blog post images to your Astro RSS Feed](https://webreaper.dev/posts/astro-rss-feed-blog-post-images/)
+- [Setting up micro-frontends with Astro](https://medium.com/@sergio.a.soria/setting-up-micro-frontends-with-astro-and-ecma-script-modules-137340d2c520)
+- [Add username and password authentication with Lucia](https://lucia-auth.com/guidebook/sign-in-with-username-and-password/astro)
+- [Add Github OAuth with Lucia](https://lucia-auth.com/guidebook/github-oauth/astro)
+- [Integrating Sentry with Astro](https://akashrajpurohit.com/blog/seamless-error-tracking-integrating-sentry-with-astro/)
+- [Set Up Draft Pages Effectively in Astro with Config-Driven Content Authoring](https://akashrajpurohit.com/blog/set-up-draft-pages-effectively-in-astro-with-configdriven-content-authoring/)
diff --git a/src/content/docs/en/core-concepts/astro-components.mdx b/src/content/docs/en/core-concepts/astro-components.mdx
index 20c0c397cdbbc..1ddb32037d649 100644
--- a/src/content/docs/en/core-concepts/astro-components.mdx
+++ b/src/content/docs/en/core-concepts/astro-components.mdx
@@ -258,6 +258,11 @@ Named slots can also be passed to [UI framework components](/en/core-concepts/fr
:::
+:::note
+An astro slot name can not be dynamically generated, such as within a map function. If this feature is needed within UI framework components, it might be best to generate these dynamic slots within the framework itself.
+:::
+
+
### Fallback Content for Slots
Slots can also render **fallback content**. When there are no matching children passed to a slot, a `
` element will render its own placeholder children.
diff --git a/src/content/docs/en/core-concepts/astro-pages.mdx b/src/content/docs/en/core-concepts/astro-pages.mdx
index c230774b59f27..c29c8acbee644 100644
--- a/src/content/docs/en/core-concepts/astro-pages.mdx
+++ b/src/content/docs/en/core-concepts/astro-pages.mdx
@@ -4,6 +4,8 @@ description: An introduction to Astro pages
i18nReady: true
---
+import Since from '~/components/Since.astro'
+
**Pages** are files that live in the `src/pages/` subdirectory of your Astro project. They are responsible for handling routing, data loading, and overall page layout for every page in your website.
## Supported page files
@@ -51,6 +53,8 @@ Astro pages use the `.astro` file extension and support the same features as [As