Aller au contenu

Installation d'Astro avec l'ILC automatique

Prêt à installer Astro ? Suivez ce guide pour utiliser la CLI create astro pour commencer.

Prérequis

  • Node.js - version v18.14.1 ou supérieure.
  • Éditeur de code - Nous recommandons VS Code avec notre extension officielle Astro.
  • Interface de ligne de commande - Astro est accessible via son interface par ligne de commande (CLI).

Installation

create-astro est le moyen le plus rapide pour démarrer un nouveau projet Astro à partir de zéro. Il vous guidera lors de chaque étape d’installation de votre nouveau projet Astro. Il vous permet de choisir entre différents templates de démarrage ou fournir le votre en utilisant l’argument --template.

1. Utiliser l’assistant d’installation

Exécutez la commande suivante dans votre terminal pour démarrer notre assistant d’installation pratique :

Terminal window
# créer un nouveau projet avec npm
npm create astro@latest

Vous pouvez exécuter create astro n’importe où sur votre machine, il n’est donc pas nécessaire de créer un nouveau répertoire vide pour votre projet avant de commencer. Si vous n’avez pas encore de répertoire vide pour votre nouveau projet, l’assistant en créera automatiquement un pour vous.

Si tout se passe bien, vous devriez voir un message “Ready for liftoff!” suivi de quelques “Étapes suivantes”. Exécutez cd vers votre nouveau répertoire pour commencer à utiliser Astro.

Si vous avez manqué l’étape npm install durant l’assistant create-astro, veuillez vous assurer d’installer les dépendances avant de continuer.

2. Lancer Astro ✨

Avec Astro, vous disposez d’un serveur de développement intégré qui regroupe toutes les fonctionnalités nécessaires pour la réalisation de votre projet. La commande astro dev démarrera le serveur de développement local pour que vous puissiez voir votre nouveau site web en action pour la toute première fois.

Chaque modèle de départ est livré avec un script préconfiguré qui exécutera astro dev pour vous. Utilisez votre gestionnaire de paquets préféré pour exécuter cette commande et démarrer le serveur de développement d’Astro.

Terminal window
npm run dev

Si tout se passe comme prévu, Astro devrait maintenant être en train de faire tourner votre projet à l’addresse http://localhost:4321/ !

Astro va également suivre les modifications de fichiers dans le répertoire src/, vous n’aurez donc pas besoin de redémarrer le serveur à chaque fois que vous apporterez des modifications au cours du développement.

Si vous n’arrivez pas à ouvrir votre projet dans le navigateur, revenez au terminal où vous avez lancé le script dev pour voir ce qui a mal tourné, ou si votre projet est servi sur une url différente que celle mentionnée ci-dessus.

Modèles de démarrage

Vous pouvez également démarrer un nouveau projet astro basé sur un exemple officiel ou sur la branche main de n’importe quel dépôt GitHub en passant un argument --template à la commande create astro.

Terminal window
# créer un nouveau projet avec un exemple officiel
npm create astro@latest -- --template <example-name>
# créer un nouveau projet basé sur la branche principale d'un dépôt GitHub
npm create astro@latest -- --template <github-username>/<github-repo>

Par défaut, cette commande utilisera la branche main du référentiel de modèles. Pour utiliser un nom de branche différent, passez-le dans l’argument --template : <github-username>/<github-repo>#<branch>.

Explorez notre galerie de thèmes et de modèles de démarrage où vous pouvez parcourir des thèmes pour des blogs, des portfolios, de la documentation, des landing page, et plus encore ! Ou, recherchez sur GitHub pour encore plus de projets de démarrage.

Étapes Suivantes

Bravo ! Vous êtes maintenant prêt à développer avec Astro ! 🥳

Voici quelques sujets que nous vous recommandons d’explorer ensuite. Vous pouvez les lire dans n’importe quel ordre. Vous pouvez même quitter notre documentation pour un moment et aller jouer dans votre nouveau codebase de projet Astro, revenant ici chaque fois que vous rencontrez des problèmes ou avez des questions.

📚 Ajoutez un framework: Apprenez à étendre Astro avec un support pour React, Svelte, Tailwind et plus encore en utilisant npx astro add dans notre guide d’intégrations.

📚 Déployez votre site: Apprenez à construire et déployer un projet Astro sur le web dans notre guide de déploiement.

📚 Comprenez votre projet: En savoir plus sur la structure de projet d’Astro dans notre guide de la structure de projet.