Guide de démarrage rapide pour créer un site avec Astro et le modèle satnaing/astro-paper

Published: at 02:00

Voici un guide étape par étape détaillé pour mettre en place un projet utilisant Astro avec le modèle satnaing/astro-paper:

  1. Création du projet :

    • Ouvrez un terminal sur votre machine.
    • Tapez la commande suivante pour créer un nouveau projet avec le modèle spécifié : 
      npm create astro@latest -- --template satnaing/astro-paper

  2. Configuration initiale :

    • Lorsque vous êtes invité à spécifier un répertoire pour votre projet, entrez ./[répertoire du site].
    • Choisissez Yes pour l’utilisation de TypeScript.
    • Sélectionnez Strict pour le niveau de rigueur de TypeScript.
    • Répondez Yes à la question sur l’installation des dépendances.
    • Optez pour No lorsqu’on vous demande si vous voulez initialiser un nouveau dépôt git (vous pouvez toujours exécuter git init manuellement).

  3. Accéder au projet et démarrer le serveur de développement :

    • Changez de répertoire dans le terminal en utilisant : 
      cd ./[répertoire du site]
    • Exécutez la commande suivante pour démarrer le serveur de développement : 
      npm run dev

  4. Résolution de problèmes :

    • Si vous rencontrez l’erreur ENOENT indiquant que package.json n’est pas trouvé, assurez-vous d’être dans le bon répertoire ([répertoire du site]). Si le problème persiste, vérifiez que le processus de création du projet n’a pas rencontré de problèmes et que tous les fichiers nécessaires ont été correctement générés.

  5. Navigation et développement :

    • Votre serveur de développement devrait être accessible via http://localhost:4321/.
    • Vous pouvez maintenant commencer à développer votre site, en modifiant les fichiers dans le répertoire [répertoire du site] et en vérifiant les changements en temps réel dans votre navigateur.

  6. Ajout de fonctionnalités et frameworks :

    • Si vous souhaitez ajouter des frameworks comme React ou Tailwind, utilisez la commande astro add suivie du nom du framework.

  7. Recherche d’aide :

    • Pour toute aide supplémentaire, vous pouvez rejoindre la communauté Astro via leur chat.

Cette procédure vous guide à travers le processus de création d’un site avec Astro et vous aide à surmonter les erreurs courantes pouvant survenir lors de la configuration initiale.