Forgot your password?
Views
Document Actions
Castelli di sabbia ... elastici
Area dove sperimentare l'uso delle regole di formattazione del testo dei collegamenti elastici e la creazione di oggetti.
Questa è la pagina "Castelli di sabbia ... elastici", dove si può utilizzare una originale rivisitazione delle funzionalità peculiari dei sistemi "wiki" implementate nei documenti reST di Plone.
Questo sistema conserva le caratteristiche che hanno reso i sistemi wiki gli ambienti ideali per lo sviluppo collaborativo di pagine HTML ma elimina i fastidiosi problemi collegati alla sicurezza, all'indicizzazione, ecc., utilizzando per questi i più avanzati strumenti Plone (decisamente superiori ai sistemi wiki).
Questo testo è scritto usando il reSTructuredText, un tipo di marcatura e di strutturazione del testo semplice quanto potente.
Ci si può esercitare ovunque ad usare il reStructuredText ma la pagina palestra reST è il posto giusto per gli esperimenti. C'è anche la pagina palestra STX?¿ per allenarsi con lo Structured Text?¿, ma lì non valgono i riferimenti elastici.
Wiki o non wiki
Questo che vedi, nonostante ci troviamo in un oggetto Plone di tipo documento, è molto simile ad un tradizionale wiki ma è invece implementato da una trasformazione con PortalTransform che, in particolare, trasforma appunto in referenze elastiche i riferimenti del sorgente reST che non sono soddisfatti.
Riferimenti elastici
Con la semplice e leggera marcatura del reSTructuredText si segnano nel testo sorgente i pezzi di testo, corrispondenti alle ParoleCammellate nei wiki [1], che si desiderano far diventare collegamenti.
I collegamenti, che puntano ad oggetti il cui nome corrisponde ad un riferimento effettivamente esistente, sono mostrati nella maniera convenzionale (come ogni riferimento soddisfatto), mentre, quando non esiste la destinazione, vengono aggiunti due punti di domanda contrapposti in fondo al riferimento non soddisfatto?¿. [2]
Questo per ogni riferimento non soddisfatto?¿ presente nel file sorgente.
Il primo dei due è un normale punto di domanda che, se selezionato, crea un oggetto dello stesso tipo dell'oggetto di partenza attribuendogli il riferimento come nome (titolo).
Il punto di domanda capovolto, invece, consente di creare un oggetto di tipo differente da quello di partenza. Se il tipo di oggetto che viene scelto supporta l'interfaccia IATLink, l'indirizzo remoto di quell'oggetto diventerà la effettiva destinazione per quel collegamento.
In altre parole un collegamento (riferimento soddisfatto) punta ad un oggetto esistente il cui nome (titolo) corrisponde al riferimento (e l'oggetto può essere di qualsiasi tipo [3]).
Se il riferimento non è soddisfatto (riferimento non soddisfatto?¿) e se, per esempio, si è in un oggetto documento e si usa il primo punto di domanda mostrato alla fine del riferimento, si crea un altro oggetto di tipo documento con il titolo uguale al riferimento da cui si è partiti. Se invece si è in una pagina wiki l'oggetto creato con il primo punto di domanda sarà una pagina wiki. Ecc..
Con il punto di domanda capovolto, mostrato alla fine del riferimento, si può scegliere da un elenco quale tipo di oggetto creare (anche differente dall'oggetto di partenza quindi), quale destinazione del collegamento. Se è un oggetto standard il collegamento punterà lì.
Questo è un esempio di riferimento non soddisfatto?¿ che mostra i due punti di domanda contrapposti finali. Questi sono due pseudo collegamenti che anzichè chiamare un oggetto chiamano delle azioni.
| [1] | Nota: Nei wiki tradizionali per creare un collegamento si usano solitamente delle parole con almeno due lettere maiuscole come UnaParola, UnaParolaSolaConPiuMaiuscole, UnaParolaSolaConDelleGobbe, ParolaCammellata, EcCetera |
| [2] | Nota: Anziché uno solo come nei wiki tradizionali. |
| [3] | Nota: A differenza che nei wiki tradizionali dove le ParoleCammellate possono puntare solo ad altre pagine wiki. |
Esempi di codice con .. elastico
codice sorgente di un documento reST per creare due collegamenti: [4]
paroladiriferimento_ (non serve racchiuderla tra apici inversi) `frase di riferimento lunga quanto si vuole`_ (tra apici inversi)
| [4] | Nota: nel documento (o meglio nello spazio dei nomi della cartella) non esiste un riferimento che soddisfi al primo di questi due collegamenti che perciò viene mostrato con, alla fine della parola/frase, due punti di domanda contrapposti (ovvero due pseudo-collegamenti o Riferimenti elastici). Il secondo collegamento è invece soddisfatto come si può vedere di seguito. |
risultato:
paroladiriferimento?¿ (non serve racchiuderla tra apici inversi)
frase di riferimento lunga quanto si vuole (tra apici inversi)
codice di esempio di collegamento soddisfatto: [5]
`riferimento soddisfatto`_
(il collegamento che vedremo evidenziato nel testo)
.. _riferimento soddisfatto: ../wiki_dangling_sandbox
(il riferimento che lo risolve, questa stessa pagina)
| [5] | Nota: il riferimento con cui viene soddisfatto il collegamento può essere messo in qualsiasi parte del documento e quindi anche raggruppato con altri riferimenti. |
| [6] | Nota: nel documento (o nello spazio dei nomi della cartella) esiste il riferimento che risolve questo collegamento che quindi viene mostrato regolarmente come ci si aspetta. |
| [7] | Nota: in questo caso specifico l'indirizzo assegnato per risolvere il riferimento ("../wiki_dangling_sandbox") è un indirizzo relativo in quanto cerca la destinazione descrivendo il movimento relativo a partire da questo stesso documento. Il prefisso ../ fa salire di un livello rispetto alla cartella in cui siamo (quindi nella cartella Aiuti ed info) dove si trova l'oggetto con l'ID wiki_dangling_sandbox. |
Attenzione!
Per modificare questo documento wiki è necessario essere registrati nel portale.
Trasferimento della sede della cooperativa Arti e Mestieri