Questa sezione e le sue sottosezioni forniscono tutte le informazioni necessarie per realizzare un progetto web basato su Glis\-Web

\hyperlink{installazione}{Installare Glis\-Web}

\hyperlink{templates}{creazione e gestione dei templates per Glis\-Web}

\hyperlink{convenzioni}{Convenzioni per la scrittura del codice}

\hyperlink{debug}{Strategie di debug e troubleshooting} \hypertarget{installazione}{}\section{Installare Glis\-Web}\label{installazione}
Questa sezione tratta passo passo la procedura di installazione di Glis\-Web. La procedura di installazione è pensata per essere il più semplice possibile ma richiede comunque alcune abilità tecniche di base che si suppone possediate prima di iniziare.

\subsection*{download di Glis\-Web}

Per prima cosa, scaricate la versione più aggiornata disponibile di Glis\-Web e scompattatela nella radice del vostro sito. Per ragioni di sicurezza, vi suggeriamo di impostare i permessi in modo che solo il server web possa scrivere sui files e sulle cartelle della piattaforma.

\subsection*{configurazione minimale di Glis\-Web}

Una volta scaricato e decompresso il framework, per avviare il nuovo sito è sufficiente eseguire i seguenti passaggi\-:


\begin{DoxyItemize}
\item nella cartella radice del sito sostituite, se l'avete, la vostra favicon.\-ico con quella di default vuota
\item aprire con un browser l'indirizzo $<$protocollo\-Sito$>$\-://$<$url\-Sito$>$/$<$percorso\-Framework$>$\hyperlink{install_8php}{install.\-php}
\item compilare i campi richiesti e verificare che non vi siano errori
\item eliminare o spostare in una sottocartella il file \hyperlink{install_8php}{install.\-php}
\item creare almeno un template seguendo le \hyperlink{templates}{istruzioni per la creazione dei template per Glis\-Web}
\end{DoxyItemize}

\subsection*{utilizzare Glis\-Web senza db}

Glis\-Web può funzionare anche senza database, archiviando e gestendo tutte le informazioni necessarie tramite files di configurazione. Questa soluzione è particolarmente indicata in caso di siti molto piccoli e con cambiamenti poco frequenti nei contenuti, in quanto consente performances veramente eccezionali.

\begin{DoxyRefDesc}{Da fare}
\item[\hyperlink{todo__todo000042}{Da fare}]questa sezione va documentata con calma\end{DoxyRefDesc}
\hypertarget{templates}{}\section{creazione e gestione dei templates per Glis\-Web}\label{templates}
\subsection*{creare un template di tipo Twig per Glis\-Web}

Il motore di rendering consigliato per Glis\-Web è Twig, anche se il framework può essere facilmente esteso per supportarne altri. Per creare un template di tipo Twig per Glis\-Web, seguire i seguenti passi\-:


\begin{DoxyItemize}
\item creare la cartella /src/templates/$<$nome\-Template$>$
\item creare il file /src/templates/$<$nome\-Template$>$/config.php dove andrà valorizzata la variabile \$tpl\-Type (in questo caso assegnandole la costante T\-E\-M\-P\-L\-A\-T\-E\-\_\-\-T\-W\-I\-G)
\item creare il file /src/templates/$<$nome\-Template$>$/default.html che verrà ulilizzato dal motore di rendering nel caso non venga specificato diversamente nella configurazione della pagina
\item creare il file /src/templates/$<$nome\-Template$>$/css/screen.css e sincerarsi che venga richiamato da default.\-html
\item se necessario, creare i files css per altri tipi di media (ad es. print) e richiamarli opportunamente da default.\-html
\item 
\end{DoxyItemize}\hypertarget{convenzioni}{}\section{Convenzioni per la scrittura del codice}\label{convenzioni}
Questa sezione tratta le coding conventions da rispettare scrivendo codice per la piattaforma Glis\-Web.

\subsection*{Numerazione dei files di configurazione}

Normalmente i files di configurazione principali hanno numeri d'ordine (step) multipli di cinque. Se tuttavia l'unico scopo di un file di configurazione è quello di elaborare o applicare i parametri specificati in un altro, questo avrà il numero d'ordine successivo a quello del file di riferimeno (vedi ad es. 010 site e 011 site). \hypertarget{debug}{}\section{Strategie di debug e troubleshooting}\label{debug}
In questa sezione viene mostrato come effettuare il debug della piattaforma Glis\-Web.

\subsection*{funzioni per il debug}

La piattaforma Glis\-Web mette a disposizione degli sviluppatori alcune funzioni utili per effettuare il debug del codice, raccolte nella libreria \-\_\-src/\-\_\-lib/\-\_\-debug.\-tools.\-php. 