Personal tools
You are here: Home Aiuto Guida all'utilizzo del wiki
Document Actions

Guida all'utilizzo del wiki

by coloriomauro last modified 2007-05-23 14:24

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.

System Message: ERROR/3 (<string>, line 17)

Directive "indice" not registered (canonical name "indice").

System Message: ERROR/3 (<string>, line 17)

Unknown directive type "indice".

.. indice:: Indice della pagina

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:

paroladiriferimento_

`frase di riferimento lunga quanto si vuole`_

System Message: ERROR/3 (<string>, line 103)

Directive "riquadro" not registered (canonical name "riquadro").

System Message: ERROR/3 (<string>, line 103)

Unknown directive type "riquadro".

.. riquadro:: **attenzione:**

   per favore non usare *questi* pseudo-collegamenti,
   servono a scopo didattico, per esercitarti vai piuttosto alla
   `palestra reST`_.

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:

Riferimento soddisfatto

[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.

System Message: ERROR/3 (<string>, line 135)

Directive "Attenzione" not registered (canonical name "attenzione").

System Message: ERROR/3 (<string>, line 135)

Unknown directive type "Attenzione".

.. Attenzione:: Per modificare questo documento wiki è necessario essere **registrati**
       nel portale.

Si ringraziano Alberto Berti e Lallo Gaifass per questo meraviglioso strumento.

Docutils System Messages

System Message: ERROR/3 (<string>, line 12); backlink

Unknown target name: "palestra rest".

System Message: ERROR/3 (<string>, line 12); backlink

Unknown target name: "palestra stx".

System Message: ERROR/3 (<string>, line 12); backlink

Unknown target name: "structured text".

System Message: ERROR/3 (<string>, line 32); backlink

Unknown target name: "riferimento non soddisfatto".

System Message: ERROR/3 (<string>, line 38); backlink

Unknown target name: "riferimento non soddisfatto".

System Message: ERROR/3 (<string>, line 55); backlink

Unknown target name: "riferimento non soddisfatto".

System Message: ERROR/3 (<string>, line 69); backlink

Unknown target name: "riferimento non soddisfatto".

System Message: ERROR/3 (<string>, line 99); backlink

Unknown target name: "paroladiriferimento".

System Message: ERROR/3 (<string>, line 101); backlink

Unknown target name: "frase di riferimento lunga quanto si vuole".

Powered by Plone CMS, the Open Source Content Management System

This site conforms to the following standards: