--- title: "Tutorial - Installazione e configurazione di Cecil, un generatore di siti statici (SSG) in PHP" description: "Scopri come Cecil ti permette di creare il tuo sito statico con l'aiuto di un motore template moderno (Jamstack)" url: https://docs.ovhcloud.com/it/guides/web-cloud/web-hosting/static-website-installation-cecil lang: it lastUpdated: 2026-06-08 --- # Tutorial - Installazione e configurazione di Cecil, un generatore di siti statici (SSG) in PHP ## Obiettivo Questa guida ti mostra come installare e configurare [Cecil](https://cecil.app/). È un'applicazione scritta in PHP che permette di generare e gestire pagine Web statiche. Un sito Web composto principalmente da pagine Web statiche garantisce tempi di caricamento migliori per i tuoi utenti e una maggiore sicurezza. Senza contenuto dinamico, le tue pagine sono più resistenti agli attacchi informatici. La generazione di un sito statico permette di usufruire di una maggiore libertà per creare il sito Web che preferisci. Risparmierete tempo anche perché non avrete inizio da zero. **Questa guida ti mostra come Cecil ti permette di creare il tuo sito statico con l'aiuto di un motore template moderno (Jamstack).** ## Prerequisiti - Disporre di una [offerta di hosting Web OVHcloud](https://www.ovhcloud.com/it/web-hosting/) con accesso SSH Questo accesso permette di installare online una o più soluzioni alternative a quelle proposte di default nelle nostre soluzioni di hosting Web. - Aver familiarità con l'inserimento da riga di comando - Essere in grado di trasferire file in FTP con un cliente come [FileZilla](/it/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) - Configurare la vostra zona DNS in modo che il vostro nome di dominio (o sottodominio) punti al vostro hosting web condiviso. Questo risulta particolarmente utile se desiderate ospitare diversi [siti web](/it/guides/web-cloud/web-hosting/multisites-configure-multisite.md) sul vostro hosting web condiviso. - Installare preventivamente [Comporre](https://getcomposer.org/) con il file `composer.phar` alla radice del tuo hosting Web condiviso o nella cartella di destinazione del tuo dominio. ## Procedura Un [hosting web condiviso](https://www.ovhcloud.com/it/web-hosting/) permette di dichiarare domini o sottodomini sui siti web che contiene. È necessario disporre di un dominio o sottodominio per distribuire il vostro sito web realizzato con **Cecil**. Per aiutarvi a dichiarare un dominio o un sottodominio su uno dei siti web del vostro hosting, consultate la nostra pagina « [Condividere il proprio hosting tra diversi siti](/it/guides/web-cloud/web-hosting/multisites-configure-multisite.md) ». ### Crea la directory in cui saranno presenti i tuoi file Una volta connesso in SSH al tuo hosting Web, crea una directory alla radice con questo comando : ```sh mkdir mystaticwebsite ``` Sostituisci `mystaticwebsite` con il nome della cartella scelta (senza accenti e senza spazi). Clicca su questa directory: ```sh cd mystaticwebsite ``` Sostituisci `mystaticwebsite` con il nome della tua cartella. ### Scaricamento Nella directory che hai appena creato, scarica Cecil: ```sh curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar ``` ### Installazione Avvia l'installazione di Cecil con il comando: ```sh php cecil.phar new:site ``` Inserisci gli elementi richiesti: - il titolo del tuo sito _(title)_ - _baseline_ - l'URL del tuo sito Web (ad esempio, `https://mywebsite.ovh`) - una descrizione del tuo sito Web ![Installazione Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil01.png) Una volta inseriti questi elementi, è necessario implementare il sito digitando questo comando: ```sh php cecil.phar build ``` Visualizzando il contenuto della directory, vedrete la presenza di una directory `_site`. La directory conterrà tutti i file HTML e gli assets: ![Installazione Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil02.png) Puoi visualizzare il risultato accedendo al tuo dominio: ![Installazione Cecil](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil03.png) #### Configurazione del puntamento del dominio o sottodominio Per visualizzare il risultato del tuo sito sul browser, modifica il puntamento del tuo dominio o sottodominio nella directory `_site` creata precedentemente al momento dell'installazione di **Cecil**. Se il vostro nome di dominio o sottodominio è ospitato da OVHcloud, consultate i nostri guide riguardanti la [configurazione DNS](/it/guides/web-cloud/domains/dns-zone-edit.md) e l'implementazione di un [sito web sul vostro hosting web](/it/guides/web-cloud/web-hosting/multisites-configure-multisite.md). ### Configura il tuo sito Le informazioni generali del tuo sito possono essere configurate nel file `config.yml`: ```sh nano config.yml ``` Sostituisci le informazioni predefinite con le tue e salva il file. ![File di configurazione YAML](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil04.png) ### Crea una nuova pagina Le pagine che contengono i dati del tuo sito vengono create utilizzando file in formato _Markdown_. Queste pagine sono personalizzabili. **Cecil** integra il motore _template_ [Twig](https://twig.symfony.com/) che è utilizzato di default con _framework_ [Symfony](https://symfony.com/). I fascicoli e i file sono organizzati come segue: - `assets` : contiene elementi grafici, audio e video, script JavaScript e stili (CSS, Sass) - `layouts`: directory in cui saranno i _templates_ - `pagine` : luogo dove saranno i tuoi file _Markdown_ - `_site`: directory che contiene i file generati e che è indicato dal tuo dominio - `static`: tutti i file statici di tipo PDF #### Crea un file _Markdown_ da riga di comando Alla radice del sito, esegui questo comando: ```sh php cecil.phar new:page mypage.md ``` Alla radice della directory `/pages` viene creato un file `mypage.md`. Sostituisci `mypage` con il nome della tua pagina. ![Installazione Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil05.png) #### Genera i file statici Sempre alla radice, inserisci questo comando : ```sh php cecil.phar build ``` Il tuo file si trova nella directory `_site/mypage/`: ![Installazione Cecil](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil06.png) Lo si può visualizzare sul server digitando l'URL del sito, seguito da `/mypage/`: ![Risultato browser](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil07.png) ### Personalizza i file del tuo sito #### Modifica sul server Per modificare i file _Markdown_ è possibile accedere direttamente al server di hosting Web. Con un'offerta di [hosting Web OVHcloud](https://www.ovhcloud.com/it/web-hosting/) che include un accesso SSH (**a partire dall'offerta Pro**), puoi utilizzare indifferentemente [GNU nano](https://nano-editor.org/), [vi](https://ex-vi.sourceforge.net/) o [vim](https://www.vim.org/). Le schermate di questo tutorial sono state effettuate con **GNU nano**. Modifica il file `mypage.md` nella directory `pages` digitando questo comando se sei alla radice del tuo sito: ```sh nano pages/mypage.md ``` Sostituisci `mypage` con il nome della tua pagina. ![Modifica del file in GNU nano](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil08.png) Aggiungi alcune linee rispettando la sintassi _Markdown_: ![Aggiunta di contenuto nel file](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil09.png) Elimina i file nella cache con il comando seguente: ```sh php cecil.phar clear ``` Ricostruisci le tue pagine dopo aver salvato il tuo file: ```sh php cecil.phar build ``` torna alla pagina per visualizzare il risultato: ![Pagina aggiornata](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil10.png) #### Modifica la tua postazione di lavoro Se preferisci utilizzare il tuo editore di codice abituale, collegati con un client FTP al tuo server per recuperare i file sul tuo computer: ![Scarica con FileZilla](/images/assets/screens/other/web-tools/filezilla/cecil-folder.png) Ora puoi modificare i file nel tuo I.D.E.: ![Visualizzazione in Visual Studio Code](/images/assets/screens/other/web-tools/vscode/static-website-installation-cecil12.png) È sufficiente inviare i file modificati o i nuovi file sul tuo server e di _rebuilder_ per avere online le tue pagine. ### Aggiungi la pagina generata al menu del tuo sito Per aggiungere questa nuova pagina al menu del sito web, modifica manualmente l'intestazione del file `.md` aggiungendo la seguente riga: ```sh menu: mano ``` ### Conclusioni **Cecil** è uno strumento che permette di costruire in modo efficace un sito statico a partire da file _Markdown_ , linguaggio di configurazione più semplice da utilizzare dell'HTML. L'organizzazione dei file Markdown condiziona la gerarchia delle tue pagine Web. Utilizzare un motore template, molto utilizzato nella comunità degli sviluppatori web, ti permetterà di trovare facilmente numerose fonti su Internet per progettare un'interfaccia di apparenza professionale. ## Per saperne di più [Aggiungere contenuto dinamico in una pagina Web statica generata con Cecil](/it/guides/web-cloud/web-hosting/static-website-installation-cecil-api-call.md) Il [sito ufficiale dell'applicazione Cecil](https://cecil.app/) Uno [guida al formato Markdown](https://www.markdownguide.org/) [Consulta la guida sull'utilizzo di FileZilla](/it/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) Per prestazioni specializzate (referenziamento, sviluppo, ecc...), contatta i [partner OVHcloud](https://partner.ovhcloud.com/it/directory/). Contatta la nostra [Community di utenti](https://community.ovhcloud.com/).