You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Diese Anleitung hilft dir bei der Migration von Astro v1 zu Astro v2.
11
13
12
14
Du musst ein älteres Projekt auf v1 aktualisieren? Siehe unsere [ältere Anleitung zur Migration](/de/guides/upgrade-to/v1/).
@@ -132,7 +134,6 @@ Mit Astro v2.0 wurde diese Konfigurationsoption komplett entfernt, da das Verhal
132
134
133
135
Die Anwendung von Markdown-Plugins und Rehype-Plugins in deiner Markdown-Konfiguration **deaktiviert nicht mehr die Standard-Plugins von Astro**. GitHub-Flavored Markdown und Smartypants werden jetzt unabhängig davon angewendet, ob benutzerdefinierte `remarkPlugins` oder `rehypePlugins` konfiguriert sind oder nicht.
134
136
135
-
136
137
##### Was soll ich tun?
137
138
138
139
Entferne `extendDefaultPlugins` in deiner Konfiguration. Das ist jetzt das Standardverhalten von Astro in v2.0, und du kannst diese Zeile ersatzlos löschen.
@@ -414,7 +415,7 @@ export default defineConfig({
414
415
415
416
Diese Funktionen sind jetzt standardmäßig verfügbar:
416
417
417
-
-[ContentCollections](/de/guides/content-collections/) als eine Möglichkeit, deine Markdown- und MDX-Dateien mit Typsicherheit zu verwalten.
418
+
-[Content-Collections](/de/guides/content-collections/) als eine Möglichkeit, deine Markdown- und MDX-Dateien mit Typsicherheit zu verwalten.
418
419
-[Prerendering einzelner Seiten zu statischem HTML](/de/guides/on-demand-rendering/) bei der Verwendung von SSR, um die Geschwindigkeit und Cachefähigkeit zu verbessern.
419
420
- Ein neu gestaltetes Overlay für Fehlermeldungen.
Diese Features sind jetzt standardmäßig verfügbar:
69
71
70
-
- View Transitions für animierte Seitenübergänge und persistente Astro-Inseln.
72
+
- View Transitions für animierte Seitenübergänge und persistente Astro Islands.
71
73
- Eine neue Bildservices-API `astro:assets` für das Verwenden von Bildern in Astro, einschließlich einer neuen `<Image />`-Komponente und der `getImage()`-Funktion.
72
74
73
75
Lies mehr über diese zwei interessanten Features und mehr im [Astro 3.0 Blogbeitrag](https://astro.build/blog/astro-3/)!
@@ -93,15 +95,14 @@ Vergewissere dich, dass sowohl deine Entwicklungs- als auch deine Veröffentlich
93
95
node -v
94
96
```
95
97
96
-
97
-
98
98
2. Überprüfe die Dokumentation deiner [Veröffentlichungs-Umgebung](/de/guides/deploy/), um sicherzustellen, dass sie Node 18 unterstützt.
99
99
100
100
Du kannst Node `18.14.1` für dein Astro-Projekt entweder in einer Dashboard-Konfigurationseinstellung oder in einer `.nvmrc`-Datei angeben.
101
101
102
102
```bash title=".nvmrc"
103
103
18.14.1
104
104
```
105
+
105
106
### Entfernt: Unterstützung für TypeScript 4
106
107
107
108
Die `tsconfig.json`-Voreinstellungen in Astro v2.x unterstützen TypeScript 4.x und 5.x.
@@ -169,6 +170,7 @@ Astro v3.0 entfernt diese veralteten APIs vollständig. Stattdessen sollten die
169
170
#### Was soll ich tun?
170
171
171
172
Wenn du weiterhin v1.x APIs verwendest, nutze stattdessen die neuen APIs für die jeweiligen Features:
@@ -182,9 +184,9 @@ Astro v3.0 entfernt diese partiellen Shims vollständig. Web-APIs stehen nicht m
182
184
183
185
Wenn du Web-APIs in serverseitig gerenderten Komponenten verwendest, musst du entweder die Verwendung dieser APIs bedingt machen oder [`client:only`](/de/reference/directives-reference/#clientonly) verwenden.
184
186
185
-
### Entfernt: `image` aus `astro:content` im Schema von Inhalts-Sammlungen
187
+
### Entfernt: `image` aus `astro:content` im Schema von Content-Collections
186
188
187
-
In Astro v2.x wurde der `image`-Export aus `astro:content` als veraltet deklariert, der für Schemas im Rahmen von Inhalts-Sammlungen verwendet wurde.
189
+
In Astro v2.x wurde der `image`-Export aus `astro:content` als veraltet deklariert, der für Schemas im Rahmen von Content-Collections verwendet wurde.
In Astro v2.x ermöglichte die Konfiguration `markdown.drafts` das Vorhandensein von Entwürfen für Seiten, die im Dev-Server verfügbar waren, aber nicht für die Produktion erzeugt wurden.
361
+
In Astro v2.x ermöglichte die Konfiguration `markdown.drafts` das Vorhandensein von Entwürfen für Seiten, die im Entwicklungsserver verfügbar waren, aber nicht für die Produktion erzeugt wurden.
360
362
361
-
Astro v3.0 deklariert dieses Feature als veraltet und bevorzugt die Verwendung von Inhalts-Sammlungen zum Umgang mit Entwurfsseiten durch manuelle Filterung, was mehr Kontrolle über das Feature ermöglicht.
363
+
Astro v3.0 deklariert dieses Feature als veraltet und bevorzugt die Verwendung von Content-Collections zum Umgang mit Entwurfsseiten durch manuelle Filterung, was mehr Kontrolle über das Feature ermöglicht.
362
364
363
365
#### Was soll ich tun?
364
366
365
-
Um weiterhin einige Seiten in deinem Projekt als Entwürfe zu kennzeichnen, [verwende stattdessen Inhalts-Sammlungen](/de/guides/content-collections/) und [filtere Seiten manuell aus](/de/guides/content-collections/#filtering-collection-queries), indem du die `draft: true`-Frontmatter-Eigenschaft verwendest.
367
+
Um weiterhin einige Seiten in deinem Projekt als Entwürfe zu kennzeichnen, [verwende stattdessen Content-Collections](/de/guides/content-collections/) und [filtere Seiten manuell aus](/de/guides/content-collections/#filtering-collection-queries), indem du die `draft: true`-Frontmatter-Eigenschaft verwendest.
366
368
367
369
### Veraltet: Rückgabe eines einfachen Objekts an Endpunkten
368
370
@@ -376,17 +378,17 @@ Aktualisiere deine Endpunkte, um direkt ein `Response`-Objekt zurückzugeben.
Wenn du wirklich das vorherige Format beibehalten musst, kannst du das `ResponseWithEncoding`-Objekt verwenden, aber beachte, dass es in Zukunft veraltet sein wird.
@@ -477,7 +479,6 @@ Astro v3.0 führt einen neuen Standardwert ein: `"attribute"`. Standardmäßig w
477
479
478
480
Um das aktuelle [Style-Scoping](/de/guides/styling/#scoped-styles) deines Projekts beizubehalten, aktualisiere die Konfigurationsdatei auf den vorherigen Standardwert:
479
481
480
-
481
482
```js title="astro.config.mjs" ins={4}
482
483
import { defineConfig } from"astro/config";
483
484
@@ -553,7 +554,7 @@ Benenne alle Funktionen in ihre Großbuchstaben-Äquivalente um:
@@ -626,7 +627,6 @@ Astro v3.0 entfernt die CLI aus dem Eintrittspunkt und exportiert einen neuen Sa
626
627
627
628
Um die Astro Kommandozeilenschnittstelle [programmatisch auszuführen](/de/reference/programmatic-reference/), verwende die neuen experimentellen JavaScript-APIs:
628
629
629
-
630
630
```js
631
631
import { dev, build } from"astro";
632
632
@@ -648,7 +648,6 @@ Astro v3.0 entfernt die beiden Einstiegspunkte zugunsten des vorhandenen Einstie
648
648
649
649
Diese sind Einstiegspunkte für Astros interne API und sollten sich nicht auf dein Projekt auswirken. Aber wenn du diese Einstiegspunkte verwendest, aktualisiere sie wie unten gezeigt:
0 commit comments