Guida all'utilizzo del wiki
ATTENZIONE: Per poter utilizzare il wiki è necessario creare i nuovi documenti e selezionare come formare reStructured Text
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 esistono i riferimenti elastici.
Wiki o non wiki
Questo che vedi, nonostante ci troviamo in un oggetto Plone di tipo documento, è effettivamente un wiki 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
I collegamenti wiki, 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`_. [1]
Questo per ogni: `Riferimento non soddisfatto`_ presente nel file sorgente.
Il primo dei due è un normale punto di domanda e, 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 wiki.
In altre parole un collegamento (riferimento soddisfatto) punta ad un oggetto esistente il cui nome (titolo) corrisponde al riferimento (l'oggetto può essere di qualsiasi tipo).
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: Anziché uno solo come nei wiki tradizionali. |
Esempi di codice con .. elastico
codice reST per creare dei collegamenti (vale per tutti i collegamenti non ancora soddisfatti): [2]
paroladiriferimento_ (non serve racchiuderla tra apici inversi) `frase di riferimento lunga quanto si vuole`_ (tra apici inversi)
| [2] | Nota: nel documento (o nello spazio dei nomi della cartella) non esiste un riferimento che soddisfi a questo (potenziale) collegamento che perciò viene mostrato con, alla fine della parola/frase, due punti di domanda contrapposti (ovvero i due pseudo-collegamenti o Riferimenti elastici). |
risultato:
`frase di riferimento lunga quanto si vuole`_
codice di esempio di collegamento soddisfatto: [3] [4]
`Riferimento soddisfatto`_
(il collegamento che vedremo evidenziato nel testo)
.. _Riferimento Soddisfatto: http://www.plone.org
(il riferimento che lo risolve)
risultato:
| [3] | Nota: il riferimento con cui viene soddisfatto il relativo collegamento può essere messo in qualsiasi parte del documento e quindi anche raggruppato con altri riferimenti. |
| [4] | 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. |
Si ringraziano Alberto Berti e Lallo Gaifass per questo meraviglioso strumento.