Was macht Astro Website Builder?
Diese Fähigkeit hilft Ihnen, Websites mit Astro.build zu erstellen, indem sie Sie durch Themenauswahl, Dokumentationszugriff und bewährte Entwicklungspraktiken führt. Verwenden Sie diese Fähigkeit, wann immer ein Benutzer die Erstellung mit Astro erwähnt, eine Website erstellen möchte oder Hilfe bei Astro-spezifischen Funktionen benötigt.
Wann Sie Diese Fähigkeit Verwenden Sollten
Aktivieren Sie diese Fähigkeit, wenn:
- Der Benutzer „Astro“ oder „astro.build“ in seiner Anfrage erwähnt
- Der Benutzer eine Website erstellen möchte und Astro geeignet wäre (Blogs, Dokumentationen, Portfolios, Marketingseiten usw.)
- Der Benutzer ein Thema für sein Astro-Projekt auswählen muss
- Der Benutzer Hilfe bei Astro-Komponenten, Routing oder Konfiguration benötigt
- Der Benutzer React, Vue oder andere Frameworks mit Astro integrieren möchte
- Der Benutzer Zugriff auf die Astro-Dokumentation oder bewährte Praktiken benötigt
Arbeitsablauf – Übersicht
Wenn Sie eine Astro-Website erstellen, befolgen Sie diesen Prozess:
- Anforderungen verstehen – Bestimmen Sie die Art der Website und die benötigten Funktionen
- Passendes Thema auswählen – Wählen Sie aus Astros kostenlosen Themen basierend auf den Anforderungen aus
- Dokumentation einsehen – Ziehen Sie die Astro-Dokumentation für bestimmte Funktionen zu Rate
- Projekt initialisieren – Richten Sie die Projektstruktur ein
- Komponenten entwickeln – Erstellen Sie mit Astros Komponentenarchitektur
- Optimieren und bereitstellen – Befolgen Sie bewährte Praktiken für die Leistung
Schritt 1: Anforderungen verstehen
Identifizieren Sie zunächst die Art der Website und ihre Anforderungen:
Website-Typen:
- Blog-/Veröffentlichungsseite
- Portfolio/Präsentation
- Dokumentationsseite
- Marketing-/Landingpage
- E-Commerce-Seite
- Unternehmens-/Geschäftsseite
- Persönliche Website
Wichtige Fragen:
- Was ist der Hauptzweck der Seite?
- Welche Inhaltstypen wird es geben? (Blogbeiträge, Projekte, Produkte usw.)
- Benötigt sie Interaktivität? (Formulare, Suche, dynamische Inhalte)
- Welche Frameworks bevorzugt der Benutzer? (React, Vue, Svelte usw.)
- Benötigt sie bestimmte Funktionen? (Dark Mode, i18n, CMS-Integration)
Schritt 2: Passendes Thema auswählen
Verwenden Sie web_fetch, um kostenlose, React-kompatible Themen zu durchsuchen:
URL: https://astro.build/themes/1/?search=&technology%5B%5D=react&price%5B%5D=free
Auswahlkriterien für Themen:
Für Blogs/Veröffentlichungen:
- Suchen Sie nach Themen mit guter Typografie
- Muss Markdown/MDX unterstützen
- Sollte Tags/Kategorien haben
- RSS-Feed-Unterstützung
- Erwägen Sie: astro-paper, astro-blog-template
Für Portfolios:
- Visuelle Projektpräsentation
- Über-/Kontaktbereiche
- Fließende Animationen
- Erwägen Sie: astro-portfolio, personal-portfolio Themen
Für Dokumentationen:
- Verwenden Sie Starlight (offizielles Astro-Dokumentations-Framework)
- Funktionen: Suche, Seitenleiste, Dark Mode, i18n
- Am besten geeignet für: Technische Dokumentationen, API-Referenzen, Anleitungen
Für Landingpages:
- Hero-Bereich mit CTA
- Abschnitte zu Funktionen/Vorteilen
- Kontaktformulare
- Konversionsoptimiert
Für E-Commerce:
- Produktlisten und Filter
- Warenkorb-Funktionalität
- Zahlungsintegration bereit
- Produktdetailseiten
Aktion: Rufen Sie die Themenseite ab, analysieren Sie verfügbare Themen und empfehlen Sie 2-3 Optionen, die am besten zu den Benutzeranforderungen passen. Erklären Sie, warum jedes Thema geeignet ist.
Schritt 3: Zugriff auf die Astro-Dokumentation
Wenn Sie eine spezifische Astro-Dokumentation benötigen, ziehen Sie Folgendes zu Rate:
- Integrierte Referenz:
references/astro_docs.md– Enthält Kernkonzepte, Syntax und häufige Patterns von Astro - Vollständige Dokumentation: Rufen Sie
https://docs.astro.build/llms-full.txtauf, um umfassende Informationen zu erhalten
Wann Sie die Dokumentation zu Rate ziehen sollten:
- Fragen zur Komponentensyntax → Referenz astro_docs.md
- Routing und Seiten → Referenz astro_docs.md
- Styling-Optionen → Referenz astro_docs.md
- Fortgeschrittene Funktionen → Von docs.astro.build abrufen
- Integrationseinrichtung → Von docs.astro.build abrufen
- API-Details → Von docs.astro.build abrufen
Schritt 4: Astro-Projekt initialisieren
Create Astro CLI verwenden
# Neues Projekt erstellen
npm create astro@latest
# Oder mit einer spezifischen Vorlage
npm create astro@latest -- --template <theme-github-username>/<theme-repo>
Projektstruktur einrichten
Stellen Sie nach der Initialisierung eine ordnungsgemäße Struktur sicher:
projekt/
├── src/
│ ├── components/ # Wiederverwendbare Komponenten
│ ├── layouts/ # Seitenlayouts
│ ├── pages/ # Routen (ERFORDERLICH)
│ │ └── index.astro # Startseite
│ ├── content/ # Inhaltsammlungen (optional)
│ └── assets/ # Optimierte Bilder
├── public/ # Statische Assets
├── astro.config.mjs # Konfiguration
├── package.json
└── tsconfig.json
Wichtig: Das Verzeichnis src/pages/ ist für das Routing ERFORDERLICH.
Schritt 5: Komponenten und Seiten entwickeln
Entwicklungspattern für Komponenten
- Komponentendatei erstellen in
src/components/ - Props-Schnittstelle definieren (bei Verwendung von TypeScript)
- Komponentenskript schreiben (wird zur Build-Zeit ausgeführt)
- Vorlage erstellen (HTML mit Astro-Syntax)
- Bereichsbezogene Styles hinzufügen (optional)
Beispiel:
---
interface Props {
titel: string;
beschreibung?: string;
}
const { titel, beschreibung } = Astro.props;
---
<article>
<h2>{titel}</h2>
{beschreibung && <p>{beschreibung}</p>}
</article>
<style>
article {
padding: 1rem;
border: 1px solid #ccc;
}
</style>
Entwicklungspattern für Seiten
- Seitendatei erstellen in
src/pages/(bestimmt die Route) - Erforderliche Komponenten und Layouts importieren
- getStaticPaths() definieren für dynamische Routen
- Seite aus Komponenten zusammensetzen
Beispielseite:
---
import Layout from '../layouts/Layout.astro';
import Hero from '../components/Hero.astro';
const titel = "Meine Seite";
---
<Layout title={titel}>
<Hero />
<!-- Weitere Inhalte -->
</Layout>
Interaktivität hinzufügen
Wenn Sie clientseitige Interaktivität benötigen:
- Framework-Integration installieren:
npx astro add react - Framework-Komponente erstellen (.jsx, .vue, .svelte)
- Mit Client-Direktive importieren und verwenden:
---
import ReactComponent from '../components/ReactComponent.jsx';
---
<!-- Statisch (kein JS) -->
<ReactComponent />
<!-- Interaktiv -->
<ReactComponent client:load />
<!-- Optionen: client:idle, client:visible, client:media -->
Schritt 6: Bei Bedarf Dokumentation zu Rate ziehen
Bevor Sie Code schreiben, lesen Sie die relevanten Abschnitte aus references/astro_docs.md:
- Fragen zu Komponenten → Abschnitt „Komponenten-Syntax“ lesen
- Routing-Probleme → Abschnitt „Routing“ lesen
- Styling → Abschnitt „Styling“ lesen
- Bilder → Abschnitt „Bilder und Assets“ lesen
- Konfiguration → Abschnitt „Konfiguration“ lesen
Für fortgeschrittene Themen die vollständige Dokumentation abrufen:
web_fetch: https://docs.astro.build/llms-full.txt
Bewährte Praktiken
Leistungsoptimierung
- Komponenten standardmäßig statisch halten – Fügen Sie
client:*nur hinzu, wenn es wirklich nötig ist - Astros Image-Komponente verwenden – Automatische Optimierung
- Insel-Architektur nutzen – Minimales JavaScript standardmäßig
- Code-Splitting – Astro teilt automatisch pro Seite auf
Entwicklungsworkflow
- Mit der Struktur beginnen – Zuerst Layouts und grundlegende Seiten einrichten
- Komponentengetrieben – Wiederverwendbare Komponenten erstellen
- Typsicherheit – TypeScript für Props und bessere DX verwenden
- Inhaltssammlungen – Für typsicheres Inhaltsmanagement
- Lokal testen – Führen Sie
npm run devhäufig aus
Häufige Patterns
- Verwenden Sie Layouts für eine konsistente Seitenstruktur
- Erstellen Sie eine SEO-Komponente für Meta-Tags
- Richten Sie ordnungsgemäße TypeScript-Schnittstellen ein
- Implementieren Sie ordnungsgemäße Fehlerseiten (404, 500)
- Fügen Sie korrekte Alt-Texte zu Bildern hinzu
- Verwenden Sie semantisches HTML
Fehlerbehebung
Häufige Probleme
„Module nicht gefunden“
- Stellen Sie korrekte Importpfade sicher
- Überprüfen Sie, ob Integrationen installiert sind
- Verifizieren Sie, dass
astro.config.mjsdie korrekte Integrationseinrichtung enthält
„Seite wird nicht gerendert“
- Stellen Sie sicher, dass die Datei im Verzeichnis
src/pages/liegt - Überprüfen Sie auf Syntaxfehler im Frontmatter
- Stellen Sie die korrekte Dateierweiterung sicher (.astro, .md, .mdx)
„Styles werden nicht angewendet“
- Bereichsbezogene Styles gelten nur für das eigene HTML der Komponente
- Verwenden Sie
is:globalfür globale Styles - Überprüfen Sie die Tailwind-Konfiguration, falls Tailwind verwendet wird
„Komponente nicht interaktiv“
- Fügen Sie
client:*-Direktive zu Framework-Komponenten hinzu - Stellen Sie sicher, dass die Integration installiert ist (z. B.
@astrojs/react) - Überprüfen Sie die Browserkonsole auf JavaScript-Fehler
Ressourcen
Skripte
scripts/theme_analyzer.py– Hilft beim Abrufen und Analysieren von Astro-Themen von der offiziellen Themenseite. Verwenden Sie es, um Themenoptionen programmatisch basierend auf Technologie- und Preisfiltern zu erkunden.
Referenzen
references/astro_docs.md– Zuerst LESEN für Kernkonzepte von Astro, Komponentensyntax, Routing, Styling und häufige Patterns. Dies ist Ihre primäre Referenz für die Astro-Entwicklung.
Externe Ressourcen
- Astro-Themen: https://astro.build/themes/
- Astro-Dokumentation (LLM-freundlich): https://docs.astro.build/llms-full.txt
- Astro-Dokumentation: https://docs.astro.build
- Astro-Discord: https://astro.build/chat
Beispiel-Workflows
Beispiel 1: Einen Blog erstellen
Benutzer: „Ich möchte einen Blog mit Astro und React erstellen“
Workflow:
- Anforderungen identifizieren: Blog-Seite, benötigt React-Unterstützung, möchte ein kostenloses Thema
- Themen abrufen:
web_fetch https://astro.build/themes/1/?technology%5B%5D=react&price%5B%5D=free - Thema empfehlen: 2-3 blogorientierte Themen mit Erklärungen vorschlagen
references/astro_docs.mdlesen, um Komponenten-Patterns nachzuschlagen- Einrichtung anleiten: Installationsbefehle und Struktur bereitstellen
- Beim Erstellen helfen: Blogbeitrag-Layout, Listenseite, einzelne Beitragsseiten erstellen
- Interaktivität hinzufügen: Zeigen, wie React-Komponenten mit
client:loadfür Funktionen wie Kommentare eingefügt werden
Beispiel 2: Portfolio-Website
Benutzer: „Erstelle eine Portfolio-Seite für mich mit https://astro.build/“
Workflow:
- Anforderungen klären: Was soll präsentiert werden (Projekte, Fähigkeiten, Erfahrung?)
- Portfolio-Themen von der Astro-Themenseite abrufen
- Beste Übereinstimmung basierend auf dem Bereich des Benutzers empfehlen (Entwickler, Designer usw.)
- Komponentensyntax aus
references/astro_docs.mdlesen - Projektstruktur mit ausgewähltem Thema einrichten
- Komponenten erstellen/anpassen (Hero, Projektraster, Über mich, Kontakt)
- Bei Bedarf fließende Übergänge hinzufügen
- Bilder mit Astros Image-Komponente optimieren
Beispiel 3: Dokumentationsseite
Benutzer: „Ich brauche eine Dokumentationsseite mit Suche und Dark Mode“
Workflow:
- Identifizieren: Dokumentationsseite, benötigt Suche und Dark Mode
- Starlight empfehlen (offizielles Astro-Dokumentations-Framework)
- Einrichtung zeigen:
npm create astro@latest -- --template starlight - Starlight-Dokumentation aus der vollständigen Astro-Dokumentation lesen
- Seitenleisten-Navigationsstruktur konfigurieren
- Inhaltsstruktur einrichten
- Dark Mode aktivieren (integriert)
- Suche konfigurieren (integriert mit Pagefind)
Wichtige Erinnerungen
- LESEN Sie zuerst
references/astro_docs.md, bevor Sie Fragen zu Komponenten oder Syntax beantworten - Rufen Sie Themen von der Astro-Themenseite ab, wenn der Benutzer einen Ausgangspunkt benötigt
- Verwenden Sie web_fetch für die vollständige Dokumentation, wenn nötig
- Halten Sie es einfach – Astro ist darauf ausgelegt, unkompliziert zu sein; überkomplizieren Sie nicht
- Insel-Architektur – Denken Sie daran, dass Komponenten standardmäßig statisch sind
- Typsicherheit – Ermutigen Sie zur Verwendung von TypeScript für eine bessere Entwicklungserfahrung
Erfolgskriterien
Ein Astro-Projekt ist korrekt eingerichtet, wenn:
- ✅ Die Projektstruktur den Astro-Konventionen folgt
- ✅ Das Verzeichnis
src/pages/existiert und mindestens index.astro enthält - ✅ Ein passendes Thema basierend auf den Anforderungen ausgewählt wurde
- ✅ Komponenten den Astro-Syntax-Patterns folgen
- ✅ Clientseitige Interaktivität nur dort hinzugefügt wurde, wo sie benötigt wird
- ✅ TypeScript-Schnittstellen für Komponenten-Props definiert wurden
- ✅ Bilder mit Astros Image-Komponente optimiert wurden
- ✅ Die Seite erfolgreich mit
npm run devläuft