Bien démarrer

Astro est un générateur de site statique moderne. Comprenez ce qu’est Astro en visitant notre page d’accueil ou notre annonce de sortie. Cette page est une vue d’ensemble de la documentation d’Astro et de toutes les ressources associées.

Vous cherchez un rapide condensé de ce qu’offre Astro ? Visitez notre page d’accueil.

Essayer Astro

La manière la plus simple d’essayer Astro est de lancer npm init astro à partir d’un nouveau dossier depuis votre machine. Notre utilitaire CLI vous assistera dans la création d’un nouveau projet Astro.

Pour bien débuter avec Astro en 5 étapes rapides et faciles, visitez notre Guide de démarrage rapide.

Autrement, lisez notre Guide d’installation pour un accompagnement pas-à-pas sur la mise en place d’Astro.

Terrains de jeu en ligne (Online Playground)

Si vous voulez tester Astro directement dans votre navigateur, vous pouvez utiliser un playground en ligne. Essayez notre modèle “Hello World!” sur CodeSandbox.

Note: quelques-unes des fonctionnalités (ex : Rafraîchissement Rapide) sont pour le moment limitées sur CodeSandbox.

Apprendre Astro

Tous les développeurs qui essaient Astro n’ont ni la même expérience, ni les mêmes méthodes d’apprentissage. Que vous préfériez une approche plutôt théorique ou pratique, nous espérons que vous trouverez l’aide qu’il vous faut dans cette section.

Comme toute nouvelle technologie, Astro possède une certaine courbe d’apprentissage. Malgré cela, avec de la pratique et de la patience, nous savons, que vous allez prendre la main, en très peu de temps.

Apprendre la syntaxe .astro

Quand vous débutez l’apprentissage d’Astro, vous allez rencontrer beaucoup de fichier avec l’extension .astro. C’est la Syntaxe des Composants Astro : des fichiers particuliers avec un format similaire au HTML qu’Astro utilise comme template. Ils ont été conçus pour être familiers à toute personne ayant une expérience avec le HTML ou le JSX.

Notre guide sur les composants Astro vous présente la syntaxe Astro et reste la meilleure façon d’apprendre.

Documentation de l’API

Cette documentation vous sera utile si vous souhaitez comprendre en détails certaines API d’Astro. Par exemple, la Documentation de la Configuration liste toutes les options de configuration à votre disposition. La Documentation des Composants de base liste tous les composants disponibles de base, comme <Markdown /> et <Code />.

Documentation versionnée

Cette documentation reflète toujours la dernière version stable d’Astro. Dès que nous auront atteint l’étape de la v1.0, nous ajouterons la possibilité de parcourir la documentation versionnée.

Rester informé

Le compte Twitter @astrodotbuild est la source officielle d’information de l’équipe Astro.

Nous publions également les annonces de nouvelles versions sur notre Communauté Discord dans le salon #announcements.

Toutes les releases d’Astro ne requièrent pas leur propre article de blog, mais vous pouvez trouver un changelog détaillé de toutes les releases dans le fichier CHANGELOG.md du dépôt Astro.

Quelque chose vous manque ?

Si vous pensez que quelque chose manque dans la documentation ou si vous en trouvez une partie déroutante, veuillez créer une “issue” sur le dépôt de la documentation avec vos suggestions d’amélioration, ou bien mentionnez le compte @astrodotbuild sur Twitter. Nous adorons avoir de vos nouvelles !

Crédits

Ce guide de démarrage est basé sur le guide “Bien débuter” de React.