Introduzione alla semantica di Textpattern.

il blog di ubu

Introduzione alla semantica di Textpattern

Tradotto (con qualche libertà) da:
Joel Dueck, Textpattern semantics.

Questo articolo si prefigge di fare chiarezza sugli elementi dell’architettura di Textpattern e sulle le loro reciproche relazioni. Una corretta comprensione dei concetti che stanno alla base di Textpattern e della loro funzione è una vera manna sulla strada della felicità e della completa realizzazione di sé.

Una grande idea: due gerarchie separate.

Una cosa salta all’occhio fin dal primo momento: Textpattern organizza ogni sito in due strutture distinte: Contenuti e Aspetto.

Il diagramma qui sotto ti dice esattamente a cosa servono queste due gerarchie e come si relazionano fra di loro.

gerarchie 2

Tieni a mente questo principio generale: Contenuti organizza le informazioni; Aspetto organizza differenti modi di visualizzare queste informazioni.
Nota anche che Links e Immagini sono due contenitori di informazioni aggiuntivi che possono essere richiamati dall’interno dei singoli Articoli, dalle Pagine e dai Moduli.

Ma vediamo meglio che cosa significano in Textpattern questi termini:

Categoria
Un modo di organizzare gli articoli secondo la natura del loro contenuto. (Ovvero non secondo la loro posizione nella struttura del sito).

Categoria: Articolo
Un articolo è, in senso molto generale, un blocco di contenuti univoco. Textpattern assegna delle proprietà a questi blocchi: titoli, autori, data di creazione, categorie, e così via.

Sezione
E’ l’equivalente delle sezioni di un quotidiano. Alle sezioni si accede attraverso l’URL del tuo browser: http://www.georgefrankly.com/about ti porterà alla sezione About del sito georgefrankly.com. La sezione di per sé stessa contiene ben poche informazioni a parte quale pagina e quale stile usare. La pagina iniziale (la home) è una sezione a sé stante e predefinita, e non appare nella lista delle sezioni.

Sezione : Stile
Le sezioni rimandano agli Stili, che contengono le informazioni CSS circa i caratteri, il posizionamento degli elementi etc. Gli Stili sono legati alle Sezioni, non alle Pagine o alle Categorie.

Sezione : Pagina
Qui risiede la struttura XHTML generale delle Pagine di ogni Sezione. Le Pagine utilizzano Moduli e codice Textpattern ‘globale’ per collegarsi agli articoli e ad altro contenuto.

Sezione : Pagina : Modulo
Un Modulo è un ‘mattoncino’ di contenuto riutilizzabile a piacimento che può contenere del testo, del codice HTML e del codice Textpattern ‘modulare’.

Ma che è ‘sto codice Textpattern?

Come si diceva sopra, varie parti di Textpattern possono utilizzare il codice Textpattern, ovvero i tag. Ci sono due tipi di tag: i tag Globali e quelli Modulari (in inglese rispettivamente Page Tags e Form Tags): si differenziano per il contesto nel quale sono utilizzati. Come il nome suggerisce: i primi all’interno delle Pagine, i secondi dei singoli Moduli.

Pedro Palazón fornisce un’ottima spiegazione dei diversi tipi di tag nel suo Textpattern Tag Manual (in inglese).

Qualcosa di più su Categorie e Sezioni

La maggior parte delle persone confondono i ruoli di Categorie e Sezioni. L’errore più comune è di utilizzare le Categorie come una struttura per navigare nel sito. Ma se la pensi così allora avrai un bel daffare a capire che ruolo hanno le Sezioni.

Le Sezioni dividono gli articoli in gruppi distinti, totalmente separati gli uni dagli altri. Le Categorie sono invece semplicemente delle etichette che assegni ai vari articoli. Sono usate per ordinare le informazioni all’interno di una Sezione.

All’interno di una Sezione puoi visualizzare:

  • tutti gli articoli di quella Sezione oppure
  • solo gli articoli di una certa Categoria, purché appartengano a quella Sezione.

(Eccezione: con il tag <txp:article_custom /> *si può* forzare Textpattern a mostrare articoli di altre Sezioni. Ma è, appunto, un comportamento diverso dalla norma: il tag comune <txp:article /> richiama solo gli articoli della Sezione corrente, come descritto qui sopra.)

Questo spiega perché Textpattern non visualizza mai diverse Sezioni sulla stessa pagina.

Le Categorie sono universali e assolutamente non legate alle Sezioni. Se hai una Categoria ‘Curiosità’, puoi assegnarla a qualunque articolo indipendentemente dalla Sezione a cui appartiene. Ripeto: questo succede perché Sezioni e Categorie sono due sistemi di catalogazione distinti.

Sia le Categorie che le Sezioni sono opzionali. Se decidi di non usare le Sezioni (puoi farlo nel pannello Amministrazione), tutti i tuoi articoli verranno visualizzati usando la stessa Pagina (predefinita o “default”). Se scegli di non usare le Categorie allora semplicemente non ti verrà mostrata l’opzione di assegnare queste etichette agli articoli.

La Sezione ‘Prima pagina’

La prima pagina in realtà è una Sezione a sé. Ha una Pagina specifica (‘default’) e uno Stile specifico (‘default’). Però non puoi assegnare un articolo alla prima pagina come faresti per le altre Sezioni. La prima pagina non ha degli articoli suoi: semplicemente mostra gli articoli di tutte le Sezioni che hanno l’opzione In prima pagina? impostata su “Sì”.

Link permanenti, o permalink.

I permalink vengono usati come riferimento permanente a un articolo specifico. Se clicchi su un permalink vedrai l’articolo visualizzato utilizzando la pagina della Sezione a cui appartiene. Questo perché se il tuo sito usa le Sezioni, il permalink include la Sezione nella URL. Ricordalo bene: accedi alle Sezioni grazie alla URL.

Facciamo un esempio di link permanente: http://www.spud.com/tech/12/CantArgue già guardandolo vediamo che rimanda a un articolo della Sezione tech, con un titolo che sarà qualcosa di simile a “Cant Argue” (Textpattern riscrive i titoli degli articoli per usarli come permalink). Se punti il browser a quell’indirizzo, Textpattern richiamerà l’articolo usando la Pagina della Sezione ‘Tech’.

Siccome Textpattern si affida all’URL per capire quale Pagina usare per ogni articolo, in realtà puoi usare uno stratagemma per forzarlo a usare pagine diverse per Sezioni diverse. Per esempio,
http://www.spud.com/about/12/CantArgue farà apparire l’articolo usando la pagina pensata per la Sezione ‘About’, anche se l’articolo è salvato in una Sezione differente. Ok, magari non è un trucco davvero utile, ma serviva per illustrare come Textpattern usa gli URL per visualizzare i contenuti di un sito.

E questo è quanto.

Se hai dei dubbi o qualcosa non è chiaro potrebbe essere per via della mia traduzione: scrivimi, oppure scrivi all’autore del testo originale.