Installazione e configurazione di Sculpin nell'ambiente ServBay

Cos'è Sculpin?

Sculpin è un generatore di siti statici basato su PHP, adatto per la creazione di blog, documentazione e altri siti web statici. Utilizza il motore di template Twig e i dati YAML, rendendo lo sviluppo del sito web molto flessibile e potente.

Passaggi per installare Sculpin

In questo articolo, vedremo come installare e configurare Sculpin nell'ambiente ServBay.

Passaggio 1: Creare la directory del progetto

Per prima cosa, creare una nuova directory del progetto nella directory www di ServBay:

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

Passaggio 2: Creare il progetto Sculpin con Composer

ServBay ha già incluso Composer, quindi possiamo usare direttamente Composer per creare il progetto Sculpin:

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

Passaggio 3: Configurare il server web

1. Aggiungere un nuovo sito web

   Aprire ServBay, cliccare sulla scheda "Host" e aggiungere un nuovo sito web:

   • Nome: My Sculpin Site
   • Dominio: servbay-sculpin.local
   • Tipo di sito web: PHP
   • Versione PHP: selezionare la versione PHP appropriata
   • Directory radice del sito web: /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Salvare la configurazione

   Salvare la configurazione e riavviare ServBay.

Passaggio 4: Costruire il sito Sculpin

1. Installare le dipendenze

   Nel directory del progetto, eseguire il comando seguente per installare le dipendenze:

   composer install

2. Costruire il sito

   Eseguire il comando seguente per costruire il sito Sculpin:

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

Passaggio 5: Eseguire il server di sviluppo locale

1. Avviare il server di sviluppo locale

   Eseguire il comando seguente per avviare il server di sviluppo locale:

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

2. Accedere al server di sviluppo

   Aprire il browser e accedere a https://servbay-sculpin.local, vedrete la versione di sviluppo locale del sito Sculpin.

Passaggio 6: Personalizzare il sito Sculpin

1. Modificare i contenuti

   Modificare i file Markdown e i file di template Twig nella directory source per personalizzare il contenuto e il layout del sito web.

2. Aggiungere nuove pagine

   Creare nuovi file Markdown nella directory source per aggiungere nuove pagine. Ad esempio, creare un file about.md:

   ---
   title: "About Us"
   ---
   
   # About Us
   
   Questa è la pagina "About Us".

3. Configurare il menu di navigazione

   Modificare il file di template Twig del menu di navigazione nella directory source/_layouts per aggiungere nuovi collegamenti di navigazione.

4. Ricostruire il sito

   Dopo ogni modifica ai contenuti o ai template, eseguire nuovamente il comando seguente per costruire il sito Sculpin:

   vendor/bin/sculpin generate

Utilizzare Sculpin per costruire il sito

Ora che avete installato e configurato Sculpin nell'ambiente ServBay, potete iniziare a utilizzarlo per costruire il vostro sito. Ecco alcune operazioni comuni:

Creare un post del blog

1. Creare un post

   Nella directory source/_posts, creare un nuovo file Markdown per aggiungere un post del blog. Ad esempio, creare un file 2024-06-06-my-first-post.md:

   ---
   title: "My First Post"
   date: 2024-06-06
   ---
   
   # My First Post
   
   Questo è il contenuto del mio primo post.

2. Ricostruire il sito

   Eseguire il comando seguente per costruire il sito Sculpin:

   vendor/bin/sculpin generate

Personalizzare stili e script

1. Modificare gli stili

   Modificare i file CSS nella directory source/assets/css per personalizzare gli stili del sito.

2. Modificare gli script

   Modificare i file JavaScript nella directory source/assets/js per personalizzare il comportamento interattivo del sito.

3. Compilare le risorse

   Eseguire il comando seguente per compilare i file CSS e JavaScript:

   vendor/bin/sculpin generate

Seguendo questi passaggi, avete installato e configurato con successo Sculpin nell'ambiente ServBay e avete iniziato a utilizzarlo per costruire il vostro sito. La flessibilità e la potenza di Sculpin lo rendono una scelta ideale per la creazione di siti web statici.