Primi passi con wiki

Per poter inserire dei testi, immagini, tabelle, link ecc…..wiki riconosce una sintassi che risulta essere molto semplice ma allo stesso tempo molto efficace. In questo piccolo manuale si forniscono alcune indicazioni sulla formattazione dei testi, l’inserimento di immagini o altri files e tabelle.Tutta la documentazione di dokuwiki è presente in lingua inglese

Dokuwiki supporta il grassetto, il corsivo, e la sottolineatura. E’ inoltre possibile combinare tutti questi elementi assieme:

Dokuwiki supporta il **grassetto**, il //corsivo//, e la __sottolineatura__.
__// **E’ inoltre possibile combinare tutti questi elementi assieme:**//__

E' possibile scrivere _sotto e ^sopra al testo

E' possibile scrivere <sub>sotto</sub> e <sup>sopra</sup> al testo

E' possibile barrare una parte di testo

E' possibile <del>barrare</del> una parte di testo

I paragrafi si ottengono lasciando semplicemente una linea bianca (andando a capo due volte).
Se si volesse andare a capo senza aprire un nuovo paragrafo è sufficiente inserire due backslashes.

Se si volesse andare a capo senza aprire un nuovo paragrafo è sufficiente inserire due backslashes “ \\ ”.

I link sono un aspetto molto importante in quanto permettono con un semplice click del mouse di spostarsi in altri siti web, in altre pagine wiki, in altre sezioni del proprio sito oppure vi è anche la possibilità di creare un link a delle immagini.

Vengono riconosciuti automaticamente digitando l'indirizzo del sito su cui ci si vuole indirizzare, www.google.it.

Vengono riconosciuti automaticamente 
digitando l'indirizzo del sito su cui ci si vuole indirizzare, www.google.it.

Se si vuole aggiungere un nome al proprio link esterno: Questo link vi porterà sul sito di google

Se si vuole aggiungere un nome al proprio link esterno: 
[[http://www.google.it|Questo link vi porterà sul sito di google]]

Un ultimo aspetto molto importante ed utile nell’ambito dei collegamenti esterni riguarda la possibilità di inviare una e-mail ad un destinatario: pinco@pallo.it.

Un ultimo aspetto molto importante ed utile nell’ambito dei collegamenti esterni 
riguarda la possibilità di inviare una e-mail ad un destinatario: <pinco@pallo.it>.

Consentono di spostarsi all’interno del proprio sito o pagina wiki: pagina; vi è la possibilità di definire o meno un nome al proprio link: mio titolo.

Consentono di spostarsi all’interno del proprio sito o pagina wiki [[pagename]]; 
vi è la possibilità di definire o meno un nome al proprio link:[[pagename|mio titolo]].

Link rapidi ad altri siti web costruiti sulla base del sistema wiki, come il noto Wikipedia.

Link rapidi ad altri siti web costruiti sulla base 
del sistema wiki, come il noto [[wp>Wikipedia]].

E’ possibile utilizzare un’immagine come link combinando la sintassi relativa all’inserimento di un’immagine (vedremo in seguito) a quella dei link interni o esterni: .

E’ possibile utilizzare un’immagine come link combinando la sintassi relativa 
all’inserimento di un’immagine (vedremo in seguito) a quella dei link interni o esterni: 
[[http://www.google.it|{{wiki:dokuwiki-128.png}}]].

Vi è la possibilità di creare dei titoli e sottotitoli di diverse dimensioni. In modo tale da suddividere il testo in più sezioni. Si va dal livello 5 il più piccolo al livello 1 il più grande aggiungendo prima e dopo il titolo un “=”.

==== Headline Level 3 ====
=== Headline Level 4 ===
== Headline Level 5 ==

Come anticipato precedentemente è possibile inserire delle immagini interne ed esterne specificandone la loro dimensione:

immagine interna: presente nel wiki.
immagine esterna: la si va a cercare nel proprio pc o nel web (altri siti internet). 
dimensione: è possibile definire la grandezza di un immagine in pixel

Vediamo la sintassi:

{{wiki:dokuwiki-128.png}}	-> immagine interna

la parola chiave wiki: implica che l’immagine è interna, il resto del codice è il nome dell’immagine con estensione .png

{{http://de3.php.net/images/php.gif}}    -> immagine esterna

la parola chiave http: implica che l’immagine è esterna (precisamente su web, nel caso l’immagine fosse su pc questo pezzo viene omesso), il resto del codice specifica il percorso (URL) del file, infine il nome del file con estensione .gif (php.gif).

Per caricare un'immagine da pc, il processo è molto semplice, è sufficiente cliccare sul pulsante “inserisci immagini o altri file”. (Cliccare sull'immagine sottostante per ingrandire)

A questo punto, cliccare sulla voce “wiki” nel menù a tendina a sinistra (avete i diritti di upload solo sulla cartella wiki). Vi apparirà quindi il celeberrimo pulsante “sfoglia”, basterà cliccarlo, cercare sul proprio pc l'immagine da caricare e cliccare la voce “invia file”. (Clicca sull'immagine sottostante per ingrandire)

Ora non ci rimane che cliccare sul nome del file e quest'ultimo verrà caricato sul documento cui stiamo lavorando.

{{wiki:dokuwiki-128.png?200x50}}     -> immagine interna di 200 per 50 pixel (x;y)

Per ridimensionare un immagine si fa riferimento alle due assi X e Y in cui X=width (larghezza) e Y= height (altezza). Scrivendo quindi immagine .png?200×50 e uguale a immagine.png?(il punto interrogativo comunica a wiki che stò definendo le dimensioni)X=200 e Y=50, l’unità di misura di riferimento è il pixel (picture element).

Per l’allineamento di un’immagine vi è un modo molto semplice, lasciare degli spazi bianchi, in base agli spazi che si lasciano l’immagine verrà allineata:

{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png}}

E’ molto importante anche nella creazione di siti web definire un titolo ad ogni immagine, non sempre l’immagine viene visualizzata correttamente per motivi a volte non dipendenti dallo sviluppatore; ecco quindi l’importanza di assegnare un titolo (nel caso l’immagine non venisse visualizzata il titolo dovrebbe sempre apparire). Come si fa?

{{ wiki:dokuwiki-128.png |Questo è il mio titolo}}

Sulla base degli esempi precedenti non dovrebbero servire spiegazioni…..

Con wiki è possibile creare delle liste di nomi ordinate secondo numeri oppure semplicemente elenchi di nomi preceduti da un pallino:

Per creare una lista ordinata è sufficiente andare a capo, digitare due volte la barra spaziatrice e digitare il “trattino (noto come score, quello basso invece viene chiamato underscore)” come nell’esempio:

1. questa è una lista ordinata
2. secondo punto della lista ordinata
   1. digitando per altre due volte la barra spaziatrice è possibile indentare ulteriormente il testo
3. ultimo punto della lista

  - questa è una lista ordinata
  - secondo punto della lista ordinata
    - digitando per altre due volte la barra spaziatrice è possibile indentare ulteriormente il testo
  - ultimo punto della lista

Per creare una lista ordinata è sufficiente andare a capo, digitare due volte la barra spaziatrice e digitare il tasto “asterisco * ” come nell’esempio:

• questa è una lista non ordinata
• secondo punto della lista non ordinata
  • digitando per altre due volte la barra spaziatrice è possibile indentare ulteriormente il testo
• ultimo punto della lista

  * questa è una lista non ordinata
  * secondo punto della lista non ordinata
    * digitando per altre due volte la barra spaziatrice è possibile indentare ulteriormente il testo
  * ultimo punto della lista

Vi è un modo molto semplice per creare delle tabele in wiki:

Per inizializzare una riga si usa il simbolo | per le intestazioni invece ^.

^ Titolo 1            ^ Titolo 2             ^ Titolo 3          ^       
| Riga 1 Colonna 1    | Riga 1 Colonna 2     | Riga 1 Colonna 3  |      
| Riga 2 Colonna 1    | esempio di colspan                      ||
| Riga 3 Colonna 1    | Riga 2 Colonna 2     | Riga 2 Colonna 3  |    

E' inoltre possibile creare tabelle più complesse con titoli orrizzontali e verticali….

Come figura nell'esempio basta inserire una cella vuota all'inizio…

|              ^ Titolo 1                     ^ Titolo 2         ^  
^ Titolo 3    | Riga 1 Colonna 2              | Riga 1 Colonna 3 |
^ Titolo 4    | non vi è colspan questa volta |                  |
^ Titolo 5    | Riga 2 Colonna 2              | Riga 2 Colonna 3 |

Un limite è dato dal fatto che non si possono applicare “rowspan”(aumentare l'altezza delle celle).

Infine l'allineamento del testo risulta essere molto semplice, è sufficiente digitare due spazi nel lato opposto cui si vuole allineare il testo:

Ecco l'esempio

^         Tabella con allineamenti         ^^^
|        Destra|    Centro    |Sinistra      |
|Sinistra      |        Destra|    Centro    |
|    Centro    |Sinistra      |        Destra|
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Vi è la possibilità di includere delle porzioni di testo che non vengono intese da wiki come “tag” ovvero come comando che3D== Sopra e sotto al testo to secondo sintassi wiki. Vi sono due modo per rendere immuni delle parti di testo, una attraverso il tag “file”, ed una con il tag “code”.

Grazie a tale immunità gli spazi digitati vengono preservati: ad sesempio              questo

E' grazie ad alcuni non parsate che è stato possibile realizzare una guida come questa sulla sintassi di wiki.

L’ultimo punto di questa piccola guida riguarda la possibilità di creare alcuni smileys con wiki. Wiki traduce alcuni simboli come questo “ :-)” nel suo smiley equivalente →  . Ecco una lista di smileys con le combinazioni di simpoli contenuti in wiki (è inoltre possibiler incrementare la lista di smiley posizionando le emoticons e le prorie combinazioni di simpoli nella directory “conf/smileys.conf”)

Elenco smileys supportati e presenti in wiki:

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• 7indirizzo del sito su cui ci si25% :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• LOL
• FIXME
• DELETEME