Installer et configurer Sculpin dans l'environnement ServBay

Qu'est-ce que Sculpin ?

Sculpin est un générateur de site statique basé sur PHP, idéal pour la création de blogs, de documents et d'autres sites statiques. Il utilise le moteur de template Twig et les données frontales YAML, ce qui rend le développement de sites web très flexible et puissant.

Étapes d'installation de Sculpin

Dans cet article, nous allons expliquer comment installer et configurer Sculpin dans l'environnement ServBay.

Étape 1 : Créer un répertoire de projet

Tout d'abord, créez un nouveau répertoire de projet dans le répertoire www de ServBay :

cd /Applications/ServBay/www
mkdir servbay-sculpin-app
cd servbay-sculpin-app

Étape 2 : Créer un projet Sculpin avec Composer

ServBay a déjà Composer intégré, donc nous pouvons directement utiliser Composer pour créer un projet Sculpin :

composer create-project sculpin/sculpin-blog-skeleton .

Étape 3 : Configurer le serveur web

1. Ajouter un nouveau site web

   Ouvrez ServBay, cliquez sur l'onglet « Host », ajoutez un nouveau site web :

   • Nom : My Sculpin Site
   • Nom de domaine : servbay-sculpin.local
   • Type de site web : PHP
   • Version PHP : Choisissez la version PHP correspondante
   • Répertoire racine du site web : /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Enregistrer la configuration

   Enregistrez la configuration et redémarrez ServBay.

Étape 4 : Construire le site Sculpin

1. Installer les dépendances

   Exécutez la commande suivante dans le répertoire du projet pour installer les dépendances :

   composer install

2. Construire le site

   Exécutez la commande suivante pour construire le site Sculpin :

   vendor/bin/sculpin generate --watch --server

Étape 5 : Lancer le serveur de développement local

1. Lancer le serveur de développement local

   Exécutez la commande suivante pour lancer le serveur de développement local :

   vendor/bin/sculpin generate --server --watch

2. Accéder au serveur de développement

   Ouvrez votre navigateur et accédez à https://servbay-sculpin.local, vous verrez la version de développement local du site Sculpin.

Étape 6 : Personnaliser le site web Sculpin

1. Modifier le contenu

   Modifiez les fichiers Markdown et les fichiers de modèle Twig dans le répertoire source pour personnaliser le contenu et la disposition de votre site.

2. Ajouter une nouvelle page

   Créez de nouveaux fichiers Markdown dans le répertoire source pour ajouter de nouvelles pages. Par exemple, créez un fichier about.md :

   ---
   title: "About Us"
   ---
   
   # About Us
   
   This is the about page.

3. Configurer le menu de navigation

   Modifiez les fichiers de modèle Twig du menu de navigation dans le répertoire source/_layouts pour ajouter de nouveaux liens de navigation.

4. Reconstruire le site

   À chaque modification du contenu ou des modèles, exécutez la commande suivante pour reconstruire le site Sculpin :

   vendor/bin/sculpin generate

Utiliser Sculpin pour créer un site web

Vous avez maintenant installé et configuré Sculpin dans l'environnement ServBay avec succès. Voici quelques opérations courantes :

Créer des articles de blog

1. Créer un article

   Créez un nouveau fichier Markdown dans le répertoire source/_posts pour ajouter un article de blog. Par exemple, créez un fichier 2024-06-06-my-first-post.md :

   ---
   title: "My First Post"
   date: 2024-06-06
   ---
   
   # My First Post
   
   This is the content of my first post.

2. Reconstruire le site

   Exécutez la commande suivante pour construire le site Sculpin :

   vendor/bin/sculpin generate

Personnaliser styles et scripts

1. Modifier les styles

   Modifiez les fichiers CSS dans le répertoire source/assets/css pour personnaliser les styles de votre site web.

2. Modifier les scripts

   Modifiez les fichiers JavaScript dans le répertoire source/assets/js pour personnaliser le comportement interactif de votre site web.

3. Compiler les ressources

   Exécutez la commande suivante pour compiler les fichiers CSS et JavaScript :

   vendor/bin/sculpin generate

Grâce à ces étapes, vous avez réussi à installer et configurer Sculpin dans l'environnement ServBay et commencé à utiliser Sculpin pour construire votre site web. La flexibilité et la puissance de Sculpin en font un choix idéal pour la création de sites web statiques.