From 1b1be3d4427fa88c85b733a2335c4ff7e4acd394 Mon Sep 17 00:00:00 2001 From: MaxTheTurtle0 Date: Sat, 7 Oct 2023 19:24:14 +0200 Subject: [PATCH 01/77] added the first 25% of the translation --- src/content/docs/de/guides/upgrade-to/v3.mdx | 680 +++++++++++++++++++ 1 file changed, 680 insertions(+) create mode 100644 src/content/docs/de/guides/upgrade-to/v3.mdx diff --git a/src/content/docs/de/guides/upgrade-to/v3.mdx b/src/content/docs/de/guides/upgrade-to/v3.mdx new file mode 100644 index 0000000000000..680a416886bfc --- /dev/null +++ b/src/content/docs/de/guides/upgrade-to/v3.mdx @@ -0,0 +1,680 @@ +--- +title: Auf Astro v2 aktualisieren +description: So aktualisierst du dein Projekt auf die neueste Version von Astro. +i18nReady: true +--- + +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' +import FileTree from '~/components/FileTree.astro' + + +Diese Anleitung hilft dir bei der Migration von Astro v2 zu Astro v3. + +Du musst ein älteres Projekt auf v1 aktualisieren? Siehe unsere [ältere Anleitung zur Migration](/de/guides/upgrade-to/v1/). + +## Astro-Aktualisierung + +Aktualisiere die Astro-Version deines Projekts mit deinem Paketmanager auf die neueste Version. Wenn du Astro-Integrationen verwendest, aktualisiere bitte auch diese auf die neueste Version. + + + + ```shell + # Upgrade auf Astro v3.x + npm install astro@latest + + # Beispiel: React- und Tailwind-Integrationen aktualisieren + npm install @astrojs/react@latest @astrojs/tailwind@latest + ``` + + + ```shell + # Upgrade auf Astro v3.x + pnpm install astro@latest + + # Beispiel: React- und Tailwind-Integrationen aktualisieren + pnpm install @astrojs/react@latest @astrojs/tailwind@latest + ``` + + + ```shell + # Upgrade auf Astro v3.x + yarn add astro@latest + + # Beispiel: React- und Tailwind-Integrationen aktualisieren + yarn add @astrojs/react@latest @astrojs/tailwind@latest + ``` + + + +:::note[Du musst weitermachen?] +Nach dem Aktualisieren von Astro sollten keine Änderungen an deinem Projekt nötig sein! + +Falls jedoch Fehler oder unerwartetes Verhalten auftreten, schau bitte weiter unten nach, was sich geändert hat und möglicherweise in deinem Projekt aktualisiert werden muss. +::: + +## Astro v3.0 Experimentale Optionen wurden entfernt + +Entferne die folgenden experimentellen Optionen aus `astro.config.mjs`: + +```js del={5-8} +// astro.config.mjs +import { defineConfig } from 'astro/config'; + +export default defineConfig({ + experimental: { + assets: true, + viewTransitions: true, + }, +}) +``` + +Diese Funktionen sind jetzt standardmäßig verfügbar: + +- View Transitions für animierte Seitenübergänge und persistente Astro-Inseln. Siehe [view transitions API breaking changes und Upgrade-Ratschläge], wenn du diese experimentelle Option verwendet hast. +- Eine neue Bildservices-API `astro:assets` für das verwenden von Bildern in Astro, einschließlich eines neuen ``-Komponent und der `getImage()`-Funktion. Bitte lies die detaillierten [Bild Upgrade-Ratschläge](/de/guides/images/#upgrade-to-v30-from-v2x) **unabhängig davon, ob du diese experimentelle Option verwendet hast**, um zu sehen, wie sich dies auf dein Projekt auswirken könnte. + +Lies mehr über diese zwei interessanten Features und mehr im [Astro 3.0 Blogbeitrag](https://astro.build/blog/astro-3/)! + +## Astro v3.0 Breaking Changes + +Astro v2.0 enthält einige wichtige Änderungen und einige veraltete Funktionen wurden entfernt. Wenn dein Projekt nach dem Upgrade auf v2.0 nicht mehr wie erwartet funktioniert, findest du in dieser Anleitung eine Übersicht über alle Änderungen und Anweisungen, wie du deine Codebasis aktualisieren kannst. + +Siehe [das Änderungsprotokoll](https://github.com/withastro/astro/blob/main/packages/astro/CHANGELOG.md) für die vollständigen Versionshinweise. + +### Entfernt: Unterstützung für Node 16 + +Der Node 16 wird voraussichtlich im September 2023 sein Lebensende erreichen. + +Astro v3.0 verzichtet komplett auf die Unterstützung von Node 16, damit alle Astro-Benutzer die Vorteile der moderneren Funktionen von Node nutzen können. + +#### Was soll ich tun? + +Vergewissere dich, dass sowohl deine Entwicklungs- als auch dein Veröffentlichungs-Umgebung **Node `18.14.1` oder höher** verwenden. + +1. Überprüfe deine lokale Version von Node mit: + ```sh + node -v + ``` + + + +2. Überprüfe die Dokumentation deiner [Aktualisierungsumgebung](/de/guides/deploy/), um sicherzustellen, dass sie Node 18 unterstützt. + +Du kannst Node `18.14.1` für dein Astro-Projekt entweder in einer Dashboard-Konfigurationseinstellung oder in einer `.nvmrc`-Datei angeben. + +```bash title=".nvmrc" +18.14.1 +``` +### Entfernt: Unterstützung für TypeScript 4 + +Die `tsconfig.json` Voreinstellungen in Astro v2.x Unterstützen TypeScript 4.x und 5.x. Astro geht jetzt davon aus, dass du TypeScript 5.0 (März 2023) verwendest oder das dein Editor diese Version einschließt (wie z.B. VS Code 1.77). + +#### Was soll ich tun? + +Falls du TypeScript lokal installiert hast, aktualisiere es mindestens auf v5.0. + +```bash +npm install typescript@latest --save-dev +``` + +### Entfernt: `@astrojs/image` + +In Astro v2.x stellte Astro eine offizielle Bildintegration zur Verfügung, die Astro ``- und ``-Komponenten einschloss. + +Mit Astro v3.0 wurde diese Integration komplett entfernt. Die neue Lösung für den umgang mit Bildern ist eine integrierte Bildservices-API: `astro:assets`. + +#### Was soll ich tun? + +Entferne die `@astrojs/image` Integration aus deinem Projekt. Du musst nicht nur die Integration deinstallieren, sondern auch alle Import-Anweisungen sowie die vorhandenen ``- und ``-Komponenten aktualisieren oder entfernen. Möglicherweise musst du auch einen bevorzugten Standardbildverarbeitungsdienst konfigurieren. + +Du findest eine [Schritt für Schritt Anleitung zum Entfernen der alten Bildintegration](/en/guides/images/#remove-astrojsimage) in unserem Bilder-Guide. + +Die Migration zu `astro:assets` bringt auch einige neue Bildoptionen und Funktionen mit sich, die du vielleicht nutzen möchtest. Bitte sieh dir den vollständigen [Upgrade-Ratgeber für Bilder in Version 3.0](/de/guides/images/#upgrade-to-v30-from-v2x) für alle Details an! + +```js del={3,7} +// astro.config.mjs +import { defineConfig } from 'astro/config'; +import image from '@astrojs/image'; + +export default defineConfig({ + integrations: [ + image(), + ] +}) +``` + +### Entfernt: ``-Komponent + +In Astro v1.x wurde der -Komponent veraltet und in ein externes Paket verschoben. + +In Astro v3.0 wurde das Paket `@astrojs/markdown-component` vollständig entfernt. Der -Komponent von Astro wird nicht mehr in deinem Projekt funktionieren. + +#### Was soll ich tun? + +Entferne alle Verwendungen von `@astrojs/markdown-component`. + +```astro del={2} title="src/components/MyAstroComponent.astro" +--- +import Markdown from '@astrojs/markdown-component'; +--- +``` + +Um eine ähnliche ``-Komponente in deinem Code weiter zu verwenden, erwäge die Verwendung von [Community-Integrationen](https://astro.build/integrations/) wie [`astro-remote`](https://github.com/natemoo-re/astro-remote). Stelle sicher, dass du deine ``-Komponenten-Importe und Attribute, wie in der Dokumentation der Integration angegeben, aktualisierst. + +Andernfalls lösche alle Verweise auf den Import des Astro ``-Komponents und den Komponenten selbst in deinen `.astro`-Dateien. Du musst deinen Inhalt dann direkt als HTML umschreiben oder [Markdown importieren](/en/guides/markdown-content/#importing-markdown) von einer `.md`-Datei. + +### Entfernt: deprecated 1.x APIs + +In Astro v1.x, Astro deprecated our original configuration settings as well as ` +``` + +### Entfernt: automatic flattening of `getStaticPaths()`'s return value + +In Astro v2.x, the return value of [`getStaticPaths()`](/en/reference/api-reference/#getstaticpaths) was automatically flattened to allow you to return an array of arrays without errors. + +Astro v3.0 removes automatic flattening of `getStaticPaths()`'s result. + +#### Was soll ich tun? + +If you're returning an array of arrays instead of an array of _objects_ (as is expected), `.flatMap` and `.flat` should now be used to ensure that you are returning a flat array. + +An [error message indicating that `getStaticPath()`'s return value must be an array of objects](/en/reference/errors/invalid-get-static-paths-entry/#what-went-wrong) will be provided if you need to update your code. + +### Moved: `astro check` now requires an external package + +In Astro v2.x, [`astro check`](/en/reference/cli-reference/#astro-check) was included in Astro by default, and its dependencies were bundled in Astro. This meant a larger package whether or not you ever used `astro check`. This also prevented you from having control over the version of TypeScript and the Astro Language Server to use. + + +Astro v3.0 moves the `astro check` command out of Astro core and now requires an external package `@astrojs/check`. Additionally, you must install `typescript` in your project to use the `astro check` command. + +#### Was soll ich tun? + +Run the `astro check` command after upgrading to Astro v3.0 and follow the prompts to install the required dependencies, or manually install `@astrojs/check` and `typescript` into your project. + +### Deprecated: `build.excludeMiddleware` and `build.split` + +In Astro v2.x, `build.excludeMiddleware` and `build.split` were used to change how specific files were emitted when using an adapter in SSR mode. + +Astro v3.0 replaces these build config options with new [SSR adapter configuration options](/en/guides/integrations-guide/#official-integrations) to perform the same tasks: `edgeMiddleware` and `functionPerRoute`. + +#### Was soll ich tun? + +Update the Astro config file to now use the new options **in the adapter configuration** directly. + +```js title="astro.config.mjs" del={5-7} ins={9} +import { defineConfig } from "astro/config"; +import vercel from "@astrojs/vercel/serverless"; + +export default defineConfig({ + build: { + excludeMiddleware: true + }, + adapter: vercel({ + edgeMiddleware: true + }), +}); +``` + +```js title="astro.config.mjs" del={5-7} ins={9} +import { defineConfig } from "astro/config"; +import netlify from "@astrojs/netlify/functions"; + +export default defineConfig({ + build: { + split: true + }, + adapter: netlify({ + functionPerRoute: true + }), +}); +``` + +### Deprecated: `markdown.drafts` + +In Astro v2.x, the `markdown.drafts` configuration allowed you to have draft pages that were available in when running the dev server, but not built in production. + +Astro v3.0 deprecates this feature in favor of the content collections method of handling draft pages by filtering manually instead, which gives more control over the feature. + +#### Was soll ich tun? + +To continue to mark some pages in your project as drafts, [migrate to content collections](/en/guides/content-collections/#migrating-from-file-based-routing) and [manually filter out pages](/en/guides/content-collections/#filtering-collection-queries) with the `draft: true` frontmatter property instead. + +### Deprecated: returning simple object in endpoints + +In Astro v2.x, endpoints could return a simple object, which would be converted to a JSON response. + +Astro v3.0 deprecates this behavior in favor of returning a `Response` object directly. + +#### Was soll ich tun? + +Update your endpoints to return a `Response` object directly. + +```ts title="endpoint.json.ts" del={2} ins={3} +export async function GET() { + return { body: { "title": "Bob's blog" }}; + return new Response(JSON.stringify({ "title": "Bob's blog" })); +} +``` + +If you really need to keep the previous format, you can use the `ResponseWithEncoding` object but will be deprecated in the future. + +```ts title="endpoint.json.ts" del={2} ins={3} +export async function GET() { + return { body: { "title": "Bob's blog" } }; + return new ResponseWithEncoding({ body: { "title": "Bob's blog" }}); +} +``` + +### Changed default: `verbatimModuleSyntax` in tsconfig.json presets + +In Astro v2.x, the [`verbatimModuleSyntax`](https://www.typescriptlang.org/tsconfig#verbatimModuleSyntax) setting was off by default, with its TypeScript 4.x equivalent `importsNotUsedAsValues` being enabled in the `strict` preset. + +In Astro v3.0, `verbatimModuleSyntax` is enabled in every preset. + +#### Was soll ich tun? + +This option requires that types are imported using the `import type` syntax. + +```astro title="src/components/MyAstroComponent.astro" "type" +--- +import { type CollectionEntry, getEntry } from "astro:content"; +--- +``` + +While we recommend keeping it on and properly making your type imports with `type` (as shown above), you can disable it by setting `verbatimModuleSyntax: false` in your `tsconfig.json` file if it causes any issues. + +```json title="tsconfig.json" "false" +{ + "compilerOptions": { + "verbatimModuleSyntax": false + } +} +``` + +### Changed default: port `3000` + +In Astro v2.x, Astro ran on port `3000` by default. + +Astro v3.0 changes the [default port](/en/reference/cli-reference/#--port-number) to `4321`. 🚀 + +#### Was soll ich tun? + +Update any existing references to `localhost:3000`, for example in tests or in your `README`, to reflect the new port `localhost:4321`. + + +### Changed default: import.meta.env.BASE_URL `trailingSlash` + +In Astro v2.x, `import.meta.env.BASE_URL` appended your [`base`](/en/reference/configuration-reference/#base) setting with a [trailingSlash](/en/reference/configuration-reference/#trailingslash) by default. `trailingSlash: "ignore"` also appended a trailing slash. + +Astro v3.0 no longer appends `import.meta.env.BASE_URL` with a trailing slash by default, nor when `trailingSlash: "ignore"` is set. (The existing behavior of `base` in combination with `trailingSlash: "always"` or `trailingSlash: "never"` is unchanged.) + +#### Was soll ich tun? + +If your `base` already has a trailing slash, no change is needed. + +If your `base` does not have a trailing slash, add one if you wish to preserve the previous default (or `trailingSlash: "ignore"`) behavior: + +```js title="astro.config.mjs" del={4} ins={5} +import { defineConfig } from "astro/config"; + +export default defineConfig({ + base: 'my-base', + base: 'my-base/', +}); +``` + +### Changed default: `compressHTML` + +In Astro v2.x, Astro only compressed your emitted HTML when [`compressHTML`](/en/reference/configuration-reference/#compresshtml) was explicitly set to `true`. The default value was `false`. + +Astro v3.0 now compresses emitted HTML by default. + +#### Was soll ich tun? + +You can now remove `compressHTML: true` from your configuration as this is the new default behavior. + +```js title="astro.config.mjs" del={4} +import { defineConfig } from "astro/config"; + +export default defineConfig({ + compressHTML: true +}) +``` + +You must now set `compressHTML: false` to opt out of HTML compression. + +### Changed default: `scopedStyleStrategy` + +In Astro v2.x, the default value of [`scopedStyleStrategy`](/en/reference/configuration-reference/#scopedstylestrategy) was `"where"`. + +Astro v3.0 introduces a new, default value: `"attribute"`. By default, styles are now applied using `data-*` attributes. + +#### Was soll ich tun? + +To retain your project's current [style scoping](/en/guides/styling/#scoped-styles), update the configuration file to the previous default value: + + +```js title="astro.config.mjs" ins={4} +import { defineConfig } from "astro/config"; + +export default defineConfig({ + scopedStyleStrategy: "where" +}) +``` + +### Changed default: `inlineStyleSheets` + +In Astro v2.x, all project stylesheets were sent as link tags by default. You could opt in to inlining them into ` ``` -### Entfernt: automatic flattening of `getStaticPaths()`'s return value +### Entfernt: Automatisches Abflachen des Rückgabewerts von `getStaticPaths()` -In Astro v2.x, the return value of [`getStaticPaths()`](/en/reference/api-reference/#getstaticpaths) was automatically flattened to allow you to return an array of arrays without errors. +In Astro v2.x wurde der Rückgabewert von [`getStaticPaths()`](/de/reference/api-reference/#getstaticpaths) automatisch abgeflacht, um es dir zu ermöglichen, ein Array aus Arrays ohne Fehler zurückzugeben. -Astro v3.0 removes automatic flattening of `getStaticPaths()`'s result. +Astro v3.0 entfernt das automatische Abflachen des Rückgabewerts von `getStaticPaths()`. #### Was soll ich tun? -If you're returning an array of arrays instead of an array of _objects_ (as is expected), `.flatMap` and `.flat` should now be used to ensure that you are returning a flat array. +Wenn du ein Array von Arrays statt eines Arrays von Objekten zurückgibst (wie erwartet), sollten jetzt .flatMap und .flat verwendet werden, um sicherzustellen, dass du ein flaches Array zurückgibst. -An [error message indicating that `getStaticPath()`'s return value must be an array of objects](/en/reference/errors/invalid-get-static-paths-entry/#what-went-wrong) will be provided if you need to update your code. +Eine [Fehlermeldung, die darauf hinweist, dass der Rückgabewert von `getStaticPaths()` ein Array aus Objekten sein muss](/de/reference/errors/invalid-get-static-paths-entry/#what-went-wrong), wird bereitgestellt, wenn du deinen Code aktualisieren musst. -### Moved: `astro check` now requires an external package +### Verschoben: `astro check` erfordert jetzt ein externes Paket -In Astro v2.x, [`astro check`](/en/reference/cli-reference/#astro-check) was included in Astro by default, and its dependencies were bundled in Astro. This meant a larger package whether or not you ever used `astro check`. This also prevented you from having control over the version of TypeScript and the Astro Language Server to use. +In Astro v2.x war [`astro check`](/de/reference/cli-reference/#astro-check) standardmäßig in Astro enthalten, und seine Abhängigkeiten waren in Astro gebündelt. Dies führte zu einem größeren Paket, unabhängig davon, ob du jemals `astro check` verwendet hast. Dies hat auch verhindert, dass du die Version von TypeScript und den Astro Language Server kontrollieren konntest. - -Astro v3.0 moves the `astro check` command out of Astro core and now requires an external package `@astrojs/check`. Additionally, you must install `typescript` in your project to use the `astro check` command. +Astro v3.0 verschiebt den Befehl `astro check` aus Astro und erfordert jetzt ein externes Paket `@astrojs/check`. Zusätzlich musst du `typescript` in deinem Projekt installieren, um den Befehl `astro check` zu verwenden. #### Was soll ich tun? -Run the `astro check` command after upgrading to Astro v3.0 and follow the prompts to install the required dependencies, or manually install `@astrojs/check` and `typescript` into your project. +Führe nach dem Upgrade auf Astro v3.0 den Befehl `astro check` aus und befolge die Anweisungen, um die erforderlichen Abhängigkeiten zu installieren. Alternativ kannst du `@astrojs/check` und `typescript` manuell in dein Projekt installieren. -### Deprecated: `build.excludeMiddleware` and `build.split` +### Veraltet: `build.excludeMiddleware` und `build.split` -In Astro v2.x, `build.excludeMiddleware` and `build.split` were used to change how specific files were emitted when using an adapter in SSR mode. +In Astro v2.x wurden `build.excludeMiddleware` und `build.split` verwendet, um zu ändern, wie bestimmte Dateien beim Verwenden eines Adapters im SSR-Modus ausgegeben wurden. -Astro v3.0 replaces these build config options with new [SSR adapter configuration options](/en/guides/integrations-guide/#official-integrations) to perform the same tasks: `edgeMiddleware` and `functionPerRoute`. +Astro v3.0 ersetzt diese Erzeugungs-Konfigurationsoptionen durch neue [SSR-Adapter-Konfigurationsoptionen](/de/guides/integrations-guide/#official-integrations), um die gleichen Aufgaben zu erledigen: `edgeMiddleware` und `functionPerRoute`. #### Was soll ich tun? -Update the Astro config file to now use the new options **in the adapter configuration** directly. +Aktualisiere die Astro-Konfigurationsdatei, um die neuen Optionen nun direkt **in der Adapter-Konfiguration** zu verwenden. ```js title="astro.config.mjs" del={5-7} ins={9} import { defineConfig } from "astro/config"; @@ -358,25 +357,25 @@ export default defineConfig({ }); ``` -### Deprecated: `markdown.drafts` +### Veraltet: `markdown.drafts` -In Astro v2.x, the `markdown.drafts` configuration allowed you to have draft pages that were available in when running the dev server, but not built in production. +In Astro v2.x ermöglichte die Konfiguration `markdown.drafts` das Vorhandensein von Entwürfen von Seiten, die im Dev-Server verfügbar waren, aber nicht für die Produktion erzeugt wurden. -Astro v3.0 deprecates this feature in favor of the content collections method of handling draft pages by filtering manually instead, which gives more control over the feature. +Astro v3.0 veraltet dieses Feature zugunsten der Methode der Inhaltskollektionen zum Umgang mit Entwurfsseiten durch manuelle Filterung, was mehr Kontrolle über das Feature ermöglicht. #### Was soll ich tun? -To continue to mark some pages in your project as drafts, [migrate to content collections](/en/guides/content-collections/#migrating-from-file-based-routing) and [manually filter out pages](/en/guides/content-collections/#filtering-collection-queries) with the `draft: true` frontmatter property instead. +Um weiterhin einige Seiten in deinem Projekt als Entwürfe zu kennzeichnen, [gehe zu Inhaltskollektionen über](/de/guides/content-collections/#migrating-from-file-based-routing) und [filtere Seiten manuell aus](/de/guides/content-collections/#filtering-collection-queries) mit der `draft: true`-Frontmatter-Eigenschaft. -### Deprecated: returning simple object in endpoints +### Veraltet: Rückgabe eines einfachen Objekts an Endpunkten -In Astro v2.x, endpoints could return a simple object, which would be converted to a JSON response. +In Astro v2.x konnten Endpunkte ein einfaches Objekt zurückgeben, das in eine JSON-Antwort umgewandelt wurde. -Astro v3.0 deprecates this behavior in favor of returning a `Response` object directly. +Astro v3.0 veraltet dieses Verhalten zugunsten der direkten Rückgabe eines `Response`-Objekts. #### Was soll ich tun? -Update your endpoints to return a `Response` object directly. +Aktualisiere deine Endpunkte, um direkt ein `Response`-Objekt zurückzugeben. ```ts title="endpoint.json.ts" del={2} ins={3} export async function GET() { @@ -385,7 +384,7 @@ export async function GET() { } ``` -If you really need to keep the previous format, you can use the `ResponseWithEncoding` object but will be deprecated in the future. +Wenn du wirklich das vorherige Format beibehalten musst, kannst du das `ResponseWithEncoding`-Objekt verwenden, aber beachte, dass es in Zukunft veraltet sein wird. ```ts title="endpoint.json.ts" del={2} ins={3} export async function GET() { @@ -394,15 +393,15 @@ export async function GET() { } ``` -### Changed default: `verbatimModuleSyntax` in tsconfig.json presets +### Standardwert Geändert: `verbatimModuleSyntax` in tsconfig.json-Voreinstellungen -In Astro v2.x, the [`verbatimModuleSyntax`](https://www.typescriptlang.org/tsconfig#verbatimModuleSyntax) setting was off by default, with its TypeScript 4.x equivalent `importsNotUsedAsValues` being enabled in the `strict` preset. +In Astro v2.x war die Einstellung [`verbatimModuleSyntax`](https://www.typescriptlang.org/tsconfig#verbatimModuleSyntax) standardmäßig deaktiviert, wobei ihr TypeScript 4.x-Äquivalent `importsNotUsedAsValues` in der `strict`-Voreinstellung aktiviert war. -In Astro v3.0, `verbatimModuleSyntax` is enabled in every preset. +In Astro v3.0 ist `verbatimModuleSyntax` in jeder Voreinstellung aktiviert. #### Was soll ich tun? -This option requires that types are imported using the `import type` syntax. +Diese Option erfordert, dass Typen mit der Syntax `import type` importiert werden. ```astro title="src/components/MyAstroComponent.astro" "type" --- @@ -410,7 +409,7 @@ import { type CollectionEntry, getEntry } from "astro:content"; --- ``` -While we recommend keeping it on and properly making your type imports with `type` (as shown above), you can disable it by setting `verbatimModuleSyntax: false` in your `tsconfig.json` file if it causes any issues. +Obwohl wir empfehlen, es aktiviert zu lassen und deine Typen-importe ordnungsgemäß mit `type` zu machen (wie oben gezeigt), kannst du es deaktivieren, indem du `verbatimModuleSyntax: false` in deiner `tsconfig.json`-Datei setzt, falls es Probleme verursacht. ```json title="tsconfig.json" "false" { @@ -420,28 +419,27 @@ While we recommend keeping it on and properly making your type imports with `typ } ``` -### Changed default: port `3000` +### Standardwert Geändert: port `3000` -In Astro v2.x, Astro ran on port `3000` by default. +In Astro v2.x lief Astro standardmäßig auf Port `3000`. -Astro v3.0 changes the [default port](/en/reference/cli-reference/#--port-number) to `4321`. 🚀 +Astro v3.0 ändert den [Standardport](/de/reference/cli-reference/#--port-number) zu `4321`. 🚀 #### Was soll ich tun? -Update any existing references to `localhost:3000`, for example in tests or in your `README`, to reflect the new port `localhost:4321`. - +Aktualisiere alle vorhandenen Verweise auf `localhost:3000`, zum Beispiel in Tests oder in deiner `README`, um den neuen Port `localhost:4321` widerzuspiegeln. -### Changed default: import.meta.env.BASE_URL `trailingSlash` +### Standardwert Geändert: import.meta.env.BASE_URL `trailingSlash` -In Astro v2.x, `import.meta.env.BASE_URL` appended your [`base`](/en/reference/configuration-reference/#base) setting with a [trailingSlash](/en/reference/configuration-reference/#trailingslash) by default. `trailingSlash: "ignore"` also appended a trailing slash. +In Astro v2.x hat `import.meta.env.BASE_URL` standardmäßig deine [`base`](/de/reference/configuration-reference/#base)-Einstellung in Kombination mit einem [trailingSlash](/de/reference/configuration-reference/#trailingslash) um ein Schrägstrichsuffix erweitert. `trailingSlash: "ignore"` hat ebenfalls ein Schrägstrichsuffix hinzugefügt. -Astro v3.0 no longer appends `import.meta.env.BASE_URL` with a trailing slash by default, nor when `trailingSlash: "ignore"` is set. (The existing behavior of `base` in combination with `trailingSlash: "always"` or `trailingSlash: "never"` is unchanged.) +Astro v3.0 fügt `import.meta.env.BASE_URL` standardmäßig nicht mehr mit einem Schrägstrichsuffix hinzu, auch nicht wenn `trailingSlash: "ignore"` festgelegt ist. (Das bestehende Verhalten von `base` in Kombination mit `trailingSlash: "always"` oder `trailingSlash: "never"` bleibt unverändert.) #### Was soll ich tun? -If your `base` already has a trailing slash, no change is needed. +Wenn deine `base` bereits ein Schrägstrichsuffix hat, ist keine Änderung erforderlich. -If your `base` does not have a trailing slash, add one if you wish to preserve the previous default (or `trailingSlash: "ignore"`) behavior: +Wenn deine `base` kein Schrägstrichsuffix hat, füge einen hinzu, wenn du das vorherige Standardverhalten (oder `trailingSlash: "ignore"`) beibehalten möchtest: ```js title="astro.config.mjs" del={4} ins={5} import { defineConfig } from "astro/config"; @@ -452,15 +450,15 @@ export default defineConfig({ }); ``` -### Changed default: `compressHTML` +### Standardwert Geändert: `compressHTML` -In Astro v2.x, Astro only compressed your emitted HTML when [`compressHTML`](/en/reference/configuration-reference/#compresshtml) was explicitly set to `true`. The default value was `false`. +In Astro v2.x hat Astro dein ausgegebenes HTML nur komprimiert, wenn [`compressHTML`](/de/reference/configuration-reference/#compresshtml) explizit auf `true` gesetzt war. Der Standardwert war `false`. -Astro v3.0 now compresses emitted HTML by default. +Astro v3.0 komprimiert jetzt standardmäßig das ausgegebene HTML. #### Was soll ich tun? -You can now remove `compressHTML: true` from your configuration as this is the new default behavior. +Du kannst jetzt `compressHTML: true` aus deiner Konfiguration entfernen, da dies das neue Standardverhalten ist. ```js title="astro.config.mjs" del={4} import { defineConfig } from "astro/config"; @@ -470,17 +468,17 @@ export default defineConfig({ }) ``` -You must now set `compressHTML: false` to opt out of HTML compression. +Du musst nun `compressHTML: false` setzen, um die HTML-Komprimierung nicht zu verwenden. -### Changed default: `scopedStyleStrategy` +### Standardwert Geändert: `scopedStyleStrategy` -In Astro v2.x, the default value of [`scopedStyleStrategy`](/en/reference/configuration-reference/#scopedstylestrategy) was `"where"`. +In Astro v2.x war der Standardwert von [`scopedStyleStrategy`](/de/reference/configuration-reference/#scopedstylestrategy) `"where"`. -Astro v3.0 introduces a new, default value: `"attribute"`. By default, styles are now applied using `data-*` attributes. +Astro v3.0 führt einen neuen Standardwert ein: `"attribute"`. Standardmäßig werden Styles jetzt mit `data-*`-Attributen angewendet. #### Was soll ich tun? -To retain your project's current [style scoping](/en/guides/styling/#scoped-styles), update the configuration file to the previous default value: +Um das aktuelle [Style-Scoping](/de/guides/styling/#scoped-styles) deines Projekts beizubehalten, aktualisiere die Konfigurationsdatei auf den vorherigen Standardwert: ```js title="astro.config.mjs" ins={4} @@ -491,14 +489,14 @@ export default defineConfig({ }) ``` -### Changed default: `inlineStyleSheets` +### Standardwert Geändert: `inlineStyleSheets` -In Astro v2.x, all project stylesheets were sent as link tags by default. You could opt in to inlining them into `