Installer et configurer Kirby dans l'environnement ServBay

Qu'est-ce que Kirby ?

Kirby est un système de gestion de contenu (CMS) flexible et puissant basé sur des fichiers, idéal pour la création de différents types de sites web. Kirby n'utilise pas de base de données, mais le système de fichiers pour stocker le contenu, ce qui le rend très léger et facile à déployer.

Étapes d'installation de Kirby

Dans cet article, nous allons expliquer comment installer et configurer Kirby 4.2 en utilisant Composer 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-kirby-app
cd servbay-kirby-app

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

ServBay vient avec Composer intégré, nous pouvons donc utiliser directement Composer pour créer le projet Kirby :

composer create-project getkirby/starterkit .

Étape 3 : Configurer le serveur Web

1. Ajouter un nouveau site web

   Ouvrez ServBay, cliquez sur l'onglet "Hôtes", ajoutez un nouveau site web :

   • Nom : My Kirby Site
   • Domaine : servbay-kirby.local
   • Type de site : PHP
   • Version de PHP : 8.2
   • Répertoire racine du site : /Applications/ServBay/www/servbay-kirby-app

2. Enregistrer la configuration

   Enregistrez la configuration.

Étape 4 : Configurer Kirby

1. Créer un répertoire de contenu

   Dans le répertoire racine du projet, le répertoire content a déjà été créé par Kirby Starterkit.

Étape 5 : Lancer Kirby

1. Accéder à Kirby

   Ouvrez un navigateur et accédez à https://servbay-kirby.local, où vous verrez la page d'accueil par défaut de Kirby.

Étape 6 : Installer le panneau Kirby (optionnel)

Si vous souhaitez utiliser le panneau d'administration de Kirby, vous pouvez le configurer en suivant les étapes ci-dessous :

1. Accéder au panneau Kirby

   Ouvrez un navigateur et accédez à https://servbay-kirby.local/panel, où vous verrez la page d'installation du panneau Kirby.

2. Créer un compte administrateur

   Suivez les instructions pour créer un compte administrateur en remplissant le nom d'utilisateur, le mot de passe et l'adresse email, puis cliquez sur "Créer un compte".

Utiliser Kirby pour construire un site web

Maintenant que vous avez installé et configuré Kirby dans l'environnement ServBay, vous pouvez commencer à l'utiliser pour construire votre site web. Voici quelques opérations courantes :

Créer des pages et du contenu

1. Créer une page

   Créez un nouveau répertoire de page dans le répertoire content. Par exemple, créez une page about :

   mkdir content/about
   echo "Title: À propos de nous\n----\nCeci est la page À propos." > content/about/about.txt

2. Modifier les modèles

   Créez ou modifiez les fichiers de modèle dans le répertoire site/templates. Par exemple, créez un modèle about.php :

   <!-- site/templates/about.php -->
   <h1><?= $page->title() ?></h1>
   <p><?= $page->text() ?></p>

Configurer le menu de navigation

1. Modifier les modèles

   Modifiez le fichier modèle principal dans le répertoire site/templates, par exemple default.php, pour ajouter un menu de navigation :

   <!-- site/templates/default.php -->
   <nav>
     <ul>
       <?php foreach ($site->children()->listed() as $item): ?>
         <li>
           <a href="<?= $item->url() ?>"><?= $item->title() ?></a>
         </li>
       <?php endforeach ?>
     </ul>
   </nav>

Personnaliser les styles et les scripts

1. Ajouter des styles

   Créez un fichier CSS dans le répertoire assets/css et incluez-le dans le fichier de modèle. Par exemple, créez style.css :

   /* assets/css/style.css */
   body {
     font-family: Arial, sans-serif;
   }

   Incluez le fichier CSS dans le fichier de modèle :

   <!-- site/templates/default.php -->
   <link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">

2. Ajouter des scripts

   Créez un fichier JavaScript dans le répertoire assets/js et incluez-le dans le fichier de modèle. Par exemple, créez script.js :

   // assets/js/script.js
   document.addEventListener('DOMContentLoaded', function() {
     console.log('Bonjour, Kirby!');
   });

   Incluez le fichier JavaScript dans le fichier de modèle :

   <!-- site/templates/default.php -->
   <script src="<?= url('assets/js/script.js') ?>"></script>

En suivant ces étapes, vous avez installé et configuré avec succès Kirby dans l'environnement ServBay et avez commencé à l'utiliser pour construire votre site web. La flexibilité et l'architecture basée sur des fichiers de Kirby en font un choix idéal pour construire une variété de types de sites web.