Filtri e variabili globali Liquid
I filtri trasformano i valori dentro {{ }}. Seekdown registra un set pensato per l’assistente: sono i mattoni che userai di continuo.
| Filtro | Cosa fa | Esempio |
|---|---|---|
t | Traduce per chiave, con un valore di riserva. | {{ 'ask' | t: 'Ask' }} |
r | Risolve l’URL di una risorsa dell’assistente. | {{ 'img/search.svg' | r }} |
markdown | Converte il markdown in HTML (da abbinare a safe). | {{ result.payload.reply | markdown | safe }} |
safe / raw_html | Emette HTML senza escape. | {{ html | safe }} |
ellipsis | Tronca il testo con i puntini di sospensione. | {{ reference.summary | ellipsis: 160 }} |
default | Valore di riserva quando è vuoto. | {{ reference.title | default: 'Untitled' }} |
hasTemplate | Vero se esiste un template con quel nome. | {% if reference.type | hasTemplate %} |
fromNow | Tempo relativo. | {{ result.date | fromNow }} |
dateToString / dateFormat | Formatta una data. | {{ date | dateToString: 'YYYY-MM-DD' }} |
length | Lunghezza di una stringa, un array o un oggetto. | {{ state.results | length }} |
entries | Trasforma un oggetto in coppie chiave/valore da iterare. | {% for e in form.fields | entries %} |
lower | Minuscolo. | {{ type | lower }} |
sanitize | Esegue l’escape delle virgolette per l’uso negli attributi. | data-x="{{ text | sanitize }}" |
randomId | Genera un id univoco. | {{ 'field_' | randomId }} |
log | Stampa un valore (JSON) per il debug. | {{ state | log }} |
Variabili globali
Oltre a state, la variabile globale skdwn dà ai template accesso all’istanza attiva (il suo config, helpers, templates e startOptions), così un template può leggere un’impostazione o fare riferimento direttamente a un helper.