#format wiki 
#LANGUAGE it
<<Include(GruppoDocumentazione/Header)>>

<<Include(GruppoDocumentazione/Header3)>>
<<BR>>
<<Indice(depth=2)>>
<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?f=46&t=633350")>>

##Il nuovo '''Wiki''' mette a disposizione anche una modalità grafica per la modifica. Una volta aperta la pagina per la modifica, basta fare clic su «'''Modo ##grafico'''» per avere un editor grafico. In questo modo non serve conoscere la sintassi del '''Wiki''' per poter scrivere un documento. Tuttavia il processore ha ##qualche problema, è altamente consigliato gestire l' ''editing'' delle pagine con il '''Metodo Testuale'''.

= Formattare il testo =

Nella finestra in modalità testuale non ci sono tasti di formattazione o menù come in un editor di testi, e allora, come si fa a formattare il testo, per avere il grassetto, il corsivo o la sottolineatura?

È necessario racchiudere il testo in alcuni tag speciali, i più importanti sono questi: {{{
 ''corsivo'' (due apici)
 '''grassetto''' (tre apici)
 '''''corsivo grassetto''''' (cinque apici)
 __sottolineatura__ (due lineette) 
}}}

Quando dovete descrivere un comando da inserire nel terminale, è d'uso inserire il relativo testo all'interno di una cornice colorata, affinché il lettore capisca che deve operare in terminale. Questa cornice si ottiene digitando tre parentesi graffe prima e tre parentesi graffe dopo il testo.
Le parentesi si ottengono con queste sequenze di tasti:

 * '''!AltGr+7''' o '''!AltGr+Maius.+È''' -> {

 * '''!AltGr+0''' o '''!AltGr+Maius.+ +''' -> }

= Titoli =

I titoli dei paragrafi si ottengono inserendo il testo tra i segni di uguale (=), a seconda del numero dei segni, il titolo sarà di primo, secondo o terzo livello: {{{
 = Titolo 1 =
 == Titolo 2 ==
 === Titolo 3 ===
 ==== Titolo 4 ====
 ===== Titolo 5 ===== 
}}}

= Elenchi puntati e numerati =

La creazione di elenchi puntati e numerati è molto semplice, digitate all'inizio della riga un asterisco (*) oppure un numero o una lettera maiuscola o minuscola seguita da un punto (1., a., A.), il Wiki creerà l'elenco.

{{{
 1.
 2.
 A.
 B.
 a.
 b.
}}}

Per approfondire visita la pagina AiutoSuListe.

= Indice =

Avrete notato che all'inizio di questa pagina c'è una tabella che riassume i titoli del documento, ottenerla è molto semplice, basta inserire questo tag compreso tra due parentesi quadre: {{{
<<Indice>>
}}}

Per una formattazione più precisa consultate la pagina [[GuidaWiki/RegoleStilistiche]].

= Testo a capo =

Il processore del wiki, il motore che crea le pagine per il web, non riconosce gli "a capo". In pratica, a meno di inserire una riga vuota, tutto il testo viene visualizzato come se fosse continuativo. Per forzare un "a capo" è necessario usare il tag: {{{
<<BR>>
}}}

= Collegamenti =

I collegamenti sono riconosciuti dal wiki secondo queste regole:

 * NomeWiki: i nomi di pagine con questo formato {{{<<NomePagina>>}}} sono riconosciuti automaticamente.
 * collegamento interno alla pagina: anteporre un {{{<<Anchor(nomeanchor)>>}}} al titolo del capitolo/paragrafo da collegare, e inserire nel tag {{{[[#nomeanchor|testo]]}}} il testo che punta al capitolo/paragrafo.
 * collegamenti internet: gli indirizzi che iniziano con «{{{<<http://>>}}}» o «{{{<<https://>>}}}» sono riconosciuti automaticamente.

Per evitare che due parole con le iniziali maiuscole tutte attaccate diventino un collegamento, anteporre alla prima il carattere "!". Ad esempio, `!NomeWiki` verrà rappresentato come !NomeWiki.

== Testo collegato ==

Se vogliamo che un certo testo sia un collegamento, possiamo inserire questo tag: {{{
[[NomePagina|Testo di descrizione]]
}}}

che verrà rappresentato così: [[NomeWiki|Questa è un prova di un collegamento]]!

Per informazioni più dettagliate sui collegamenti visitate questa [[AiutoSuCollegamenti|pagina]].

= Linee orizzontali =

L'utilizzo delle linee orizzontali è utile in quanto consente di "spezzare" la grafica di una pagina e, quindi, di separare blocchi di testo (per es. capitoli) rendendo meno faticosa la lettura. Puoi disegnare delle linee divisorie orizzontali inserendo quattro o più caratteri "-" (n.d.r. trattino) consecutivi. Il numero di tali caratteri determina lo spessore della linea, da un minimo di 4 fino a un massimo di 10.

Esempi: {{{
----
-----
------
-------
--------
---------
----------
}}}

che verrà così rappresentato:
----
-----
------
-------
--------
---------
----------

= Tabelle =

Per creare una tabella, devi iniziare e terminare una riga di testo usando il marcatore "||". Tra quei due marcatori iniziale e finale puoi inserire qualunque numero di altre celle separandole sempre con "||". 
Per ottenere una cella centrata che occupi diverse colonne, comincia quella cella con più di un marcatore.

== Attributi delle tabelle ==

Oltre alla possibilità di specificare più di un marcatore per ottenere una cella che occupi più colonne, è possibile anche specificare svariati altri attributi HTML della tabella. 
Qualsiasi attributo deve essere specificato tra parentesi angolari <...> direttamente dopo il marcatore della cella. 
Il formato wiki-like offre le seguenti opzioni: 
 * <50%>: larghezza della cella 
 * <-2>: colspan 
 * <|2>: rowspan 
 * <(>: allineata a sinistra 
 * <:>: centrata 
 * <)>: allineata a destra 
 * <^>: allineata alla parte superiore 
 * <v>: allineata alla parte inferiore 
 * <style="font-weight: bold;> testo grassetto
 * <style="background-color: #XXXXXX;"> colore di sfondo
 * <style="color: #XXXXXX;"> colore del testo
 * <style="border:none;"> casella/tabella senza bordo

Da predefinito il testo è di colore nero, lo sfondo è di colore bianco o di quello impostato per la tabella.

Sostituire il '''#XXXXXX''' col corrispondente valore esadecimale del colore desiderato, per orientare la scelta leggere [[https://toolset.mrwebmaster.it/html/colori-del-web.html|Colori HTML]].

{{{#!wiki note
Usare i colori solo quando necessitano e con moderazione.
}}}

Se usi opzioni consecutive che possono causare conflitti, tipo <(:)>, prevale l'ultima che hai specificato. Non esiste alcuna opzione per centrare verticalmente, dal momento che questo è sempre il default. 
Oltre a queste, puoi usare alcune di quelle HTML tradizionali (nota che sono consentiti solo alcuni attributi HTML). Specificando una opzione in questa maniera, è possibile impostare le proprietà di ciascuna riga e della tabella stessa, in particolare puoi specificarne l'ampiezza utilizzando ||<tablestyle="width:100%;">...|| nella prima riga della tabella, e il colore di una intera riga con ||<rowstyle="background-color: #FFFFE0;">...|| nella prima cella della riga. Come puoi vedere, devi aggiungere come prefisso table o row al nome dell'attributo HTML. 

Esempio: {{{
 Layout generico con opzioni in stile HTML:
 ||||||<tablestyle="width:80%;">'''Intestazione'''||
 ||<rowstyle="background-color: #FFFFE0;"> cella 1||cella 2||cella 3||
 ||<rowspan=2> occupa più righe||||<#E0E0FF> occupa 2 colonne||
 ||cella 2||cella 3||
 Larghezza cella:
 || stretta ||<:99%> larga ||
 Occupa più di una riga e colonna:
 ||<|2> 2 righe || riga 1 ||
 || riga 2 ||
 ||<-2> riga 3 su 2 colonne ||
 Allineamento:
 ||<(> sinistra ||<^|3> sopra ||<v|3> sotto ||
 ||<:> centrato ||
 ||<)> destra ||
 Testo grassetto:
 ||<style="font-weight: bold;"> grassetto ||
 Testo grassetto e casella senza bordo:
 ||<style="border: none; font-weight: bold;"> grassetto e casella senza bordi ||
 Testo colorato:
 ||<style="color: #808000;"> oliva ||<style="color: #000080;"> mare ||
 Sfondo colorato:
 ||<style="background-color: #FF00FF;"> fucsia ||<style="background-color: #00FF00;"> lime ||
 Testo grassetto colorato:
 ||<style="color: #008000; font-weight: bold;"> grassetto colorato verde ||
 Testo e sfondo colorati:
 ||<style="color: #FFFFFF; background-color: #FF0000;"> bianco su sfondo rosso ||
 Testo grassetto e sfondo colorati:
 ||<style="color: #FFFF00; font-weight: bold; background-color: #0000FF;"> giallo grassetto su sfondo blu ||
}}}

che verrà visualizzato così:
 Layout generico con opzioni in stile HTML:
 ||||||<tablestyle="width:80%;">'''Intestazione'''||
 ||<rowstyle="background-color: #FFFFE0;"> cella 1||cella 2||cella 3||
 ||<rowspan=2> occupa più righe||||<#E0E0FF> occupa 2 colonne||
 ||cella 2||cella 3||
 Larghezza cella:
 || stretta ||<:99%> larga ||
 Occupa più di una riga e colonna:
 ||<|2> 2 righe || riga 1 ||
 || riga 2 ||
 ||<-2> riga 3 su 2 colonne ||
 Allineamento:
 ||<(> sinistra ||<^|3> sopra ||<v|3> sotto ||
 ||<:> centrato ||
 ||<)> destra ||
 Testo grassetto:
 ||<style="font-weight: bold;"> grassetto ||
 Testo grassetto e casella senza bordo:
 ||<style="border: none; font-weight: bold;"> grassetto e casella senza bordi ||
 Testo colorato:
 ||<style="color: #808000;"> oliva ||<style="color: #000080;"> mare ||
 Sfondo colorato:
 ||<style="background-color: #FF00FF;"> fucsia ||<style="background-color: #00FF00;"> lime ||
 Testo grassetto colorato:
 ||<style="color: #008000; font-weight: bold;"> grassetto colorato verde ||
 Testo e sfondo colorati:
 ||<style="color: #FFFFFF; background-color: #FF0000;"> bianco su sfondo rosso ||
 Testo grassetto e sfondo colorati:
 ||<style="color: #FFFF00; font-weight: bold; background-color: #0000FF;"> giallo grassetto su sfondo blu ||


<<Anchor(elenchi_tabelle)>>
== Elenchi interni alle tabelle ==

Per riprodurre [[Wiki10Passi#Elenchi_puntati|elenchi puntati/numerati]] all'interno di tabelle è possibile sfruttare due metodi:
 * inserire manualmente ad es. sequenze di '''•''' e `<<BR>>` per ricostruire la struttura di un elenco puntato;
 * utilizzare la macro '''!ElencoTabella''' che si presenta nella forma:{{{
<<ElencoTabella(\n * 1°ELEMENTO\n * 2°ELEMENTO\n)>>
}}}

Ad esempio utilizzando la macro, il codice:{{{
||<tablestyle="width:15%;":> '''Menù del giorno'''||
|| Primi piatti:<<ElencoTabella(\n * Spaghetti\n * Lasagne\n * Zuppa\n * Ravioli\n)>> ||
}}}verrà reso così:
||<tablestyle="width:15%;":> '''Menù del giorno'''||
|| Primi piatti:<<ElencoTabella(\n * Spaghetti\n * Lasagne\n * Zuppa\n * Ravioli\n)>> ||

Da notare che all'interno della macro non possono essere utilizzati direttamente i simboli della virgola e dell'uguale ''',''' ''' ='''.<<BR>>
Dovranno essere sostituiti con il relativo codice unicode:

||<tablestyle="width:10%;" :30%> ''','''  || `&#44;` ||
||<:> ''' =''' || `&#61;` ||
 
Ad esempio le virgole presenti in questo codice:{{{
<<ElencoTabella(\n * libro, sedia, tavolo e armadio\n)>>
}}}dovranno essere sostituite con il valore `&#44;`:{{{
<<ElencoTabella(\n * libro&#44; sedia&#44; tavolo e armadio\n)>>
}}}

----
CategoryComunitaDocumentazione