Come redigere pagine in formato Wiki

Il formato Wiki fornisce un metodo per formattare un testo un tag intuitivi e comprensibili. Quando il testo Wiki sarà visualizzato, si trasformerà in formato XHTML. Il notevole vantaggio del formato Wiki risiede nel fatto che non è necessario imparare l'HTML per ottenere risultati validi e che il testo che redigete rimane comprensibile anche prima della conversione. Il formato Wiki è di fatto un'alternativa al semplice salvataggio di file Word in formato HTML con in più la possibilità di mantenere la modificabilità del testo direttamente on-line.

Per scrivere in formato Wiki, è sufficiente inserire del testo semplice al quale aggiungere una serie di caratteri speciali di controllo della formattazione.

### Formattazione di paragrafi

I paragrafi devono essere separati da almeno un'interlinea. Per aggiungere formati ai paragrafi, aggiungete uno dei seguenti caratteri di controllo come primo carattere della prima riga del paragrafo seguito da uno spazio vuoto.

Carattere | Tipo di formattazione
--- | ---
Nessuno | Paragrafo normale
> | Citazione
Spazio | Testo pre formattato (Carattere Monospaced)
% | Esclude la pre formattazione ed il formato Wiki
!# | Titolo - sostituire al simbolo # i numeri da 1 a 6 per indicare la dimensione del titolo. (1 è la più grande)
Q. | Domanda - utilizzata per migliorare la presentazione di testi contenenti domande e risposte
A. | Risposta - vedi sopra

### Formattazione di elenchi

Elenchi semplici possono essere realizzati inserendo caratteri speciali seguiti da uno spazio all'inizio di ciascuna riga. L'elenco termina con una linea vuota. Gli elenchi possono essere nidificati a piacimento.

Carattere | Tipo di elenco
--- | ---
* | Elenco puntato non ordinato
# | Elenco numerato ordinato
: | Elenco di definizioni, definizione
; | Elenco di definizioni, testo

Il seguente esempio di elenco nidificato:

      * Primo elemento
      * Secondo elemento
      ## elemento nidificato 1
      ## elemento nidificato 2
      * Terzo elemento

produce il seguente risultato:

- Primo elemento
- Secondo elemento

1. elemento nidificato 1
2. elemento nidificato 1

- Terzo elemento

### Formattazione del testo

La formattazione del testo consente di formattare parti di linee con stili particolari. Questi caratteri speciali possono essere inseriti in un qualsiasi punto del testo ma non possono essere incrociati.

Example | Example | Formatting
--- | --- | ---
*hello world* | hello world | Grassetto
/hello world/ | hello world | Corsivo
+hello world+ | hello world | Sottolineato
-hello world- | hello world | Barrato
hello ~world~ | hello world | Pedice
hello ^world^ | hello world | Apice
"hello world" | “hello world” | Virgolette
%hello world% | `hello world` | Carattere Monospaced
@hello world@ | hello world | Esempio

### Acronimi

Per usare gli acronimi è sufficiente scrivere l'acronimo in maiuscolo seguito dalla descrizione tra parentesi. Tra l'acronimo e la parentesi aperta non ci devono essere spazi vuoti. Esempio:

HTML(Hypertext Markup Language)
HTML

### Hyper Link

I link possono essere inseriti nel testo facendoli seguire tra parentesi con le parole che volete compaiano. Tra il testo del link e la parentesi aperta non ci devono ssere spazi vuoti.

Esempio: http://www.google.com/(Cerca) sarà convertito in Cerca.

Analogamente, per i link di posta elettronica:

nobody@example.com(Test User) sarà convertito in Test User

### Link ai moduli di Moodle

Se conoscete l'id di un modulo di Moodle (cercate " ?id=nn" al termine dalla URL che punta al modulo) e il nome del modulo, potete creare un link al modulo utilizzando la seguente sintassi:

NomeDelModulo:nn(Descrizione)

per esempio, risorsa:36(Una pagina) forum:10(Vai al forum)

### Link alle immagini di Moodle

E' possibile inserire immagini in qualsiasi punto del testo Wiki. E' necessario eseguire preventivamante l'upload delle immagini e tenere nota del percorso all'interno dell'area di upload.
Sintassi:

/..percorso del file..(testo alternativo)

Per esempio: /mypics/graphic.jpg(Immagine dello staff)

### Link ai file di Moodle

Analogamante alla immagini, è possibile creare link ai file. Anche i file devono essere preventivamante caricati nell'area di upload.
Sintassi:

file:..percorso del file(testo del link)

Per esempio, file:/pdfs/moodle.pdf(Informazioni su Moodle)

### Formattazione automatica

Molte espressioni di uso comune sono convertite in XHTML automaticamante. Le principali sono:

- HTTP link sono convertiti in link attivi
- ..., (R), (TM), (C), 1/4, 1/2, 3/4 sono convertiti nell'opportuno carattere corrispondente.
- numeri x numeri si converte nel giusto simbolo di moltiplicazione
- una linea che iniza con almeno quattro trattini è convertita in una linea orizzontale.

### Controllo ortografico (Sperimentale)

Per attivare il controllo ortografico, potete inserire le seguente linea di testo riportata sotto. Tutto il testo che segue la linea sarà controllato.

    !SPELL:language_code:language_variant

    Examples:
    !SPELL:en:british
    !SPELL:sp

"language_code" deve essere sostituito dal codice della lingua desiderata (e.g., EN, FR etc),
" language_variant" (insieme ai due punti) è facoltativo e può assumere i valori, nel caso di language_code= EN, "american", "british", o "canadian".

Le parole non riconosciute sono evidenziate e potete valutare i suggerimenti posizionando il mouse sopra la parola.

NOTA: il controllo ortografico utilizza le librerie pspell. Queste librerie sono necessarie così come è necessario disporre nel proprio server del dizionario della lingua che si intende utilizzare. In mancanza, il controllo ortografico non potrà funzionare. Il controllo ortografico non è supportato in Windows.