> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/sito-web/modello-comuni/configurare-le-guide-del-sito-comunale.md).
# Configurare le guide del sito comunale
Guida
**Guida** è la classe che rappresenta contenuti procedurali strutturati in passi sequenziali, pensati per accompagnare il cittadino attraverso una procedura complessa (es. come votare).
Identificatore > howto
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------ | ----------- |
| Titolo (title) | Il titolo relativo alla guida passo per passo per la quale si vogliono dare indicazioni. | Linea di testo (ezstring) | X | X |
| Descrizione breve (abstract) | Descrizione sintetica, con un linguaggio semplice, che possa aiutare qualsiasi utente a identificare con chiarezza di che tipo di procedura si tratta e il contenuto di pagina. Non utilizzare un linguaggio ricco di riferimenti normativi, amministrativi o scientifici. | Blocco di testo (eztext) | X | X |
| Immagine (image) | Immagine che rappresenta la guida descritta. | Relazioni oggetti (ezobjectrelationlist) | | X |
| Panoramica (description) | Descrizione estesa del processo di usufruizione con questa scheda. | Blocco XML (ezxmltext) | X | X |
| A chi è rivolto (audience) | Descrizione testuale degli utenti a cui è rivolta la procedura. | Blocco XML (ezxmltext) | | X |
| Testo introduttivo della procedura (step\_intro) | | Blocco XML (ezxmltext) | | X |
| Step della procedura (steps) | | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Ulteriori informazioni (more\_info) | Eventuali ulteriori dati e informazioni utili allo svolgimento della procedura che non sono principali o legate a un passo specifico. | Blocco XML (ezxmltext) | | X |
| Parliamo di (topics) | Indicazione degli argomenti con cui il contenuto di pagina è stato taggato. | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Documenti (attachments) | | Relazioni oggetti (ezobjectrelationlist) | | X |
{% hint style="warning" %}
Questa funzionalità è attivabile su richiesta del Comune.
{% endhint %}
## Vai alla sezione "Vivere il Comune"
Collocati nella sezione "Vivere il Comune" (1) e scegli la categoria "Guide" (2).
## Crea la guida
Dopo aver scelto la pagina corretta, procedi alla [creazione del contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-un-nuovo-contenuto.md).
Inserisci il titolo, che sia breve e comprensibile (max. 60 caratteri).
## Descrivi il contenuto
Successivamente, inserisci la descrizione breve del contenuto.
Compila poi la panoramica: una descrizione più estesa della procedura, di cui viene spiegato il processo di fruizione.
## Inserisci i destinatari
Inserisci una descrizione testuale degli utenti a cui è rivolta la guida.
## Descrivi la procedura
[Crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e più passaggi della procedura (1) oppure [crea gli Step da associare](/sito-web/modello-comuni/configurare-le-guide-del-sito-comunale/creare-gli-step.md) al contenuto (2).
Questa funzione di permette di inserire degli *step* che guidano l'utente attraverso la procedura (es. conoscere le procedure di voto).
## Pubblica il contenuto
Una volta compilati i campi obbligatori, [pubblica il contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/pubblicare-un-contenuto.md).
Guida
**Guida** è la classe che rappresenta contenuti procedurali strutturati in passi sequenziali, pensati per accompagnare il cittadino attraverso una procedura complessa (es. come votare).
Identificatore > howto
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------ | ----------- |
| Titolo (title) | Il titolo relativo alla guida passo per passo per la quale si vogliono dare indicazioni. | Linea di testo (ezstring) | X | X |
| Descrizione breve (abstract) | Descrizione sintetica, con un linguaggio semplice, che possa aiutare qualsiasi utente a identificare con chiarezza di che tipo di procedura si tratta e il contenuto di pagina. Non utilizzare un linguaggio ricco di riferimenti normativi, amministrativi o scientifici. | Blocco di testo (eztext) | X | X |
| Immagine (image) | Immagine che rappresenta la guida descritta. | Relazioni oggetti (ezobjectrelationlist) | | X |
| Panoramica (description) | Descrizione estesa del processo di usufruizione con questa scheda. | Blocco XML (ezxmltext) | X | X |
| A chi è rivolto (audience) | Descrizione testuale degli utenti a cui è rivolta la procedura. | Blocco XML (ezxmltext) | | X |
| Testo introduttivo della procedura (step\_intro) | | Blocco XML (ezxmltext) | | X |
| Step della procedura (steps) | | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Ulteriori informazioni (more\_info) | Eventuali ulteriori dati e informazioni utili allo svolgimento della procedura che non sono principali o legate a un passo specifico. | Blocco XML (ezxmltext) | | X |
| Parliamo di (topics) | Indicazione degli argomenti con cui il contenuto di pagina è stato taggato. | Relazioni oggetti (ezobjectrelationlist) | X | X |
| Documenti (attachments) | | Relazioni oggetti (ezobjectrelationlist) | | X |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.opencityitalia.it/sito-web/modello-comuni/configurare-le-guide-del-sito-comunale.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.