Installazione e configurazione di Kirby in ambiente ServBay

Cos'è Kirby?

Kirby è un sistema di gestione dei contenuti (CMS) flessibile e potente basato su file, ideale per costruire diversi tipi di siti web. Kirby non dipende da un database ma utilizza il file system per memorizzare i contenuti, rendendolo molto leggero e facile da distribuire.

Passaggi per installare Kirby

In questo articolo, introdurremo come installare e configurare Kirby 4.2 utilizzando Composer in un ambiente ServBay.

Passaggio 1: Creare la directory del progetto

Innanzitutto, crea una nuova directory del progetto nella directory www di ServBay:

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

Passaggio 2: Creare il progetto Kirby con Composer

ServBay fornisce già Composer, quindi possiamo usare direttamente Composer per creare il progetto Kirby:

composer create-project getkirby/starterkit .

Passaggio 3: Configurare il server web

1. Aggiungere un nuovo sito web

   Apri ServBay, clicca sulla scheda "Host" e aggiungi un nuovo sito web:

   • Nome: My Kirby Site
   • Dominio: servbay-kirby.local
   • Tipo di sito web: PHP
   • Versione PHP: 8.2
   • Directory root del sito: /Applications/ServBay/www/servbay-kirby-app

2. Salvare la configurazione

   Salva la configurazione.

Passaggio 4: Configurare Kirby

1. Creare la directory dei contenuti

   La directory content è già creata dal Kirby Starterkit nella directory root del progetto.

Passaggio 5: Avviare Kirby

1. Accedere a Kirby

   Apri il browser, accedi a https://servbay-kirby.local e vedrai la pagina di benvenuto predefinita di Kirby.

Passaggio 6: Installare il Pannello di Kirby (opzionale)

Se desideri utilizzare il pannello di amministrazione di Kirby, segui questi passaggi:

1. Accedere al Pannello di Kirby

   Apri il browser e accedi a https://servbay-kirby.local/panel per visualizzare la pagina di installazione del pannello di Kirby.

2. Creare un account amministratore

   Segui le istruzioni per creare un account amministratore, inserendo nome utente, password e indirizzo email, quindi clicca su "Crea account".

Utilizzare Kirby per costruire un sito web

Ora che hai installato e configurato con successo Kirby in ambiente ServBay, puoi iniziare a usarlo per costruire il tuo sito web. Ecco alcune operazioni comuni:

Creare pagine e contenuti

1. Creare una pagina

   Crea una nuova directory per la pagina nella directory content. Ad esempio, crea una pagina "about":

   mkdir content/about
   echo "Title: About Us\n----\nThis is the about page." > content/about/about.txt

2. Modificare i template

   Crea o modifica i file di template nella directory site/templates. Ad esempio, crea un template about.php:

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

Configurare il menu di navigazione

1. Modificare il template

   Modifica il file di template principale nella directory site/templates, ad esempio default.php, per aggiungere il menu di navigazione:

   <!-- 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>

Personalizzare stile e script

1. Aggiungere stile

   Crea un file CSS nella directory assets/css e includilo nel file di template. Ad esempio, crea style.css:

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

   Includi il file CSS nel file di template:

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

2. Aggiungere script

   Crea un file JavaScript nella directory assets/js e includilo nel file di template. Ad esempio, crea script.js:

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

   Includi il file JavaScript nel file di template:

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

Seguendo questi passaggi, hai installato e configurato correttamente Kirby in ambiente ServBay e hai iniziato a usarlo per costruire il tuo sito web. La flessibilità e l'architettura basata su file di Kirby lo rendono una scelta ideale per costruire una varietà di siti web.