Summary Regole di base per formattare il testo in UGIdotNETWiki

La formattazione sul Wiki è molto semplice e si basa su testo dedorato con qualche piccola annotazione extra. Utilizzando semplice testo è infatti possibile ottenere una formattazione accattivante. E' un po' come con gli emoticon nel caso degli instant messenger: tre caratteri ed ecco un bel sorriso .

Avvertenza Quasi tutte queste regole di formattazione sono disponibili in un box sul lato destro della pagina quando si modifica un contenuto.

Regole di formattazione di base

Di seguito sono riportate le regole di formattazione di base.

Formattazione di testo semplice

Due apici (' ') per italico

Tre apici (' ' ') per grassetto

Punto esclamativo (!) all'inizio di una riga per H1 (intestazione grande)

Doppio punto esclamativo (!!) all'inizio di una riga per H2 (intestazione medio-grande)

Triplo, quadruplo punto esclamativo (!!!, !!!!, ecc...) per H3, H4 e così via

Link

Ogni parola in notazione Pascal diventa un link.

Inserendo una parola in una coppia di parentesi quadre (in questo modo: [esempio]) si riesce ad ottenere un link anche senza notazione Pascal. Questo caso però dovrebbe essere considerato un'eccezione da evitare, meglio quindi provare ad usare la notazione Pascal quando possibile.

Esempio di link senza notazione Pascal: Wiki

Ogni URL diventa automaticamente un link (http://www.ugidotnet.org).

E' inoltre possibile ottenere link arbitrari usando la formattazione textile (vedi sotto).

Linee

Quattro trattini (- - - -) all'inizio di una riga producono una HR (Horizontal Row).

Elenchi

Per ottenere un elenco puntato basta iniziare una riga con un carattere TAB (oppure una sequenza di 8 spazi) seguito da un asterisco:

Elemento 1

Elemento 1.1
Elemento 1.2

Elemento 2

Per ottenere un elenco ordinato basta iniziare una riga con un carattere TAB (oppure una sequenza di 8 spazi) seguito da 1. (uno-punto):

Elemento 1

Elemento 1.1
Elemento 1.2

Elemento 2

NOTA: non è possibile annidare elenchi puntati in elenchi ordinati e viceversa.

Emoticon

Tutte le emoticon più comuni funzionano (consultare un instant messenger per visionare l'elenco completo).

Ecco le principali:

(y)	(n)	(b)	(d)	(x)	(z)	(6)	:-[	(})	({)

:-)	;)	:(	:\|	:'(	:-$	(H)	:-@	(A)	(L)

(U)	(k)	(g)	(f)	(w)	(p)	(~)	(T)	(t)	(@)

(c)	(i)	(S)	(*)	(8)	(E)	(^)	(O)	(M)

Tabelle

Una linea di testo che comincia e finisce con || è una riga di tabella. Le celle della tabella sono divise sempre con ||.

Esempio di tabella:

 ||Cella 1.1||Cella 1.2||Cella 1.3||Cella 1.4||Cella 1.5||Cella 1.6||Cella 1.7||Cella 1.8||Cella 1.9||
 ||Cella 2.1||Cella 2.2||Cella 2.3||Cella 2.4||Cella 2.5||Cella 2.6||Cella 2.7||Cella 2.8||Cella 2.9||
 ||Cella 3.1||Cella 3.2||Cella 3.3||Cella 3.4||Cella 3.5||Cella 3.6||Cella 3.7||Cella 3.8||Cella 3.9||
 ||Cella 4.1||Cella 4.2||Cella 4.3||Cella 4.4||Cella 4.5||Cella 4.6||Cella 4.7||Cella 4.8||Cella 4.9||
 ||Cella 5.1||Cella 5.2||Cella 5.3||Cella 5.4||Cella 5.5||Cella 5.6||Cella 5.7||Cella 5.8||Cella 5.9||

Risultato finale:

Cella 1.1	Cella 1.2	Cella 1.3	Cella 1.4	Cella 1.5	Cella 1.6	Cella 1.7	Cella 1.8	Cella 1.9
Cella 2.1	Cella 2.2	Cella 2.3	Cella 2.4	Cella 2.5	Cella 2.6	Cella 2.7	Cella 2.8	Cella 2.9
Cella 3.1	Cella 3.2	Cella 3.3	Cella 3.4	Cella 3.5	Cella 3.6	Cella 3.7	Cella 3.8	Cella 3.9
Cella 4.1	Cella 4.2	Cella 4.3	Cella 4.4	Cella 4.5	Cella 4.6	Cella 4.7	Cella 4.8	Cella 4.9
Cella 5.1	Cella 5.2	Cella 5.3	Cella 5.4	Cella 5.5	Cella 5.6	Cella 5.7	Cella 5.8	Cella 5.9

NOTA: vedere anche le RegoleDiFormattazioneTabelleDelWiki per informazioni avanzate di formattazione (allineamento, evidenziazione, ecc.).

Colore e dimensione del testo

Sintassi:

 Per impostare il colore del testo: %colore% oppure %#1122AA% (6 caratteri HEX)
 Per impostare la dimensione del testo: %big% oppure %small%
 Combinazioni: %colore big% oppure %small colore%
 Per azzerare le impostazioni di colore e dimensione: %% (doppio percentuale) oppure fine della linea di testo EOL

Esempi di formattazione:

 Normale %red% testo rosso %% di nuovo normale

Normale testo rosso di nuovo normale

 %red% testo rosso %blue% testo blu
 di nuovo normale

testo rosso testo blu

di nuovo normale

 %big% Testo grande %small% testo piccolo %% di nuovo normale

Testo grande testo piccolo di nuovo normale

 %big red%Testo grande rosso %blue small% testo piccolo blu

Testo grande rosso testo piccolo blu

 %big big%Testo molto grande %% di nuovo normale

Testo molto grande di nuovo normale

Regole di formattazione avanzata

Di seguito sono riportate le regole di formattazione avanzata.

Testo preformattato o codice

Qualsiasi linea di testo che inizia con uno spazio diventa preformattata (blocco PRE), come nell'esempio di seguito:

 Public Class MyClass
    Public Sub New()
        DoCoolStuff()
        If IsReallyCool Then
            DoSomethingEvenMoreCool()
        End If
    End Sub
 End Class
 public class CSharpExample {
    CSharpExample() {
       int n = 5;
       object[] test = new object[n];
    }
 }

NOTA: il testo dentro ad un blocco preformattato non rileva automaticamente i link inseriti in esso.

Testo non indentato preformattato: è abbastanza macchinoso fare il copia&incolla di un file sorgente dentro al wiki e poi inserire uno spazio all'inizio di ogni riga per preformattare il testo. Per fortuna i blocchi PRE risolvono questo problema. Ci sono due possibili scenari di utilizzo: 1) sintassi semplice {@...@} 2) sintassi con chiave {@Key...Key@}.

Sintassi semplice:

{@
il testo va qui e
non serve usare spazi o tab
}@

Risultato finale:

il testo va qui e
non serve usare spazi o tab

Sintassi con chiave (nel caso in cui per qualche ragione il testo già contenga }@ all'inizio di una riga):

{@UniqKey
il testo va qui e
non serve usare spazi o tab
}@ viene messo all'inizio di una riga
ma il testo rimane preformattato
}@WrongKey
ancora preformattato
}@UniqKey

Risultato finale:

il testo va qui e
non serve usare spazi o tab
}@ viene messo all'inizio di una riga
ma il testo rimane preformattato
}@WrongKey
ancora preformattato

Immagini

Per inserire una immagine, basta riportare l'URL esterno al file (estensione jpeg/gif/jpg).

Esempio di immagine:

 http://www.microsoft.com/billgates/images/sofa-bill.jpg

Riferimenti ad un wiki esterno

Per referenziare un argomento su un wiki esterno (ovvero un argomento non contenuto in questo wiki) va aggiunto ovunque prima del link:

 @siteName=http://myserver/mywiki/default.aspx/$$$

Ovunque dopo il link va usato:

 TopicName@siteName

Il casing of "siteName" è arbitrario, non ci sono restrizioni. La sequenza $$$ nell'URL deve essere sostituita col nome dell'argomento fornito.

Formattazione "textile"

http://www.textism.com/tools/textile/index.html

Esempi di formattazione:

 testo: _enfasi_
 testo: *grassetto* 
 testo: ??citazione?? 
 testo: -testo cancellato- 
 testo: +testo inserito+ 
 testo: ^apice^ 
 testo: ~pedice~ 
 testo: @codice@ 
 testo: "questo è un link (tooltip opzionale)":http://www.ugidotnet.org

Risultato finale:

testo: enfasi
testo: grassetto
testo: citazione
testo: ~~testo cancellato~~
testo: testo inserito
testo: ^apice
testo: _pedice
testo: codice
testo: questo è un link

Cancellazione di una pagina

Per cancellare una pagina, modificare semplicemente il testo in modo che contenga unicamente la parola "delete".

Recupero di una pagina

Per recuperare una pagina cancellata, basta navigare fino alla pagina in questione (che appare a questo punto come una pagina nuova) e salvarla. Nello storico delle versioni sono disponibili anche le versioni antecedenti alla cancellazione. Selezionata la versione di interesse, si può finalmente tirare un sospiro di sollievo.

Proprietà

Vedere ProprietàDiPaginaDelWiki.

Sequenza di escape

Se si vuole evitare che il NomeArgomento venga mostrato come link, è possibile usare come carattere di escape una coppia di doppie-virgolette (due volte il carattere "): basta racchiudere il testo fra le due coppie di doppie virgolette per evitare che venga trasformato in un link. Questo "trucco" funziona con la maggior parte delle formattazioni (ad esempio: grassetto, italico, collegamenti URL, ecc.).

Esempio:

 ""NormalmenteQuestoSarebbeUnLink"" e ""'''questo dovrebbe comparire in grassetto'''""

Risultato finale:

NormalmenteQuestoSarebbeUnLink e '''questo dovrebbe comparire in grassetto'''