Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Immutable Page
  • Info
  • Attachments


Problemi in questa pagina? Segnalali in questa discussione

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 o il corsivo?

È necessario racchiudere il testo in alcuni tag speciali, i più importanti sono questi:

 ''corsivo'' (due apici)
 '''grassetto''' (tre apici)
 '''''corsivo grassetto''''' (cinque apici) 

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 questa sequenza di tasti:

  • AltGr+7 -> {

  • AltGr+0 -> }

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ì: Questa è un prova di un collegamento!

Per informazioni più dettagliate sui collegamenti visitate questa 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

  • <#XXXXXX>: colore di sfondo

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 ||
 Colori:
 ||<#FF8080> rosso ||<#80FF80> verde ||<#8080FF> blu ||

che verrà visualizzato così:

  • Layout generico con opzioni in stile HTML:

    Intestazione

    cella 1

    cella 2

    cella 3

    occupa più righe

    occupa 2 colonne

    cella 2

    cella 3

    Larghezza cella:

    stretta

    larga

    Occupa più di una riga e colonna:

    2 righe

    riga 1

    riga 2

    riga 3 su 2 colonne

    Allineamento:

    sinistra

    sopra

    sotto

    centrato

    destra

    Colori:

    rosso

    verde

    blu

Elenchi interni alle tabelle

Per riprodurre 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ì:

Menù del giorno

Primi piatti:

  • Spaghetti
  • Lasagne
  • Zuppa
  • Ravioli

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

,

&#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)>>

Tabelle wiki standard

Di seguito viene mostrato il codice di una tabella wiki standard utilizzata nella documentazione:

||<tablestyle="width:80%;" rowstyle="background-color: #cccccc;" :30%>'''Colonna 1''' ||<:70%>'''Colonna 2''' ||
||<#f7f7f7>  '''Riga 1''' ||  Testo riga 1       ||
||<#f7f7f7>  '''Riga 2''' ||  Testo riga 2       ||
||<#f7f7f7>  '''Riga 3''' ||  Testo riga 3       ||
||<#f7f7f7>  '''Riga 4''' ||  Testo riga 4       ||
||<#f7f7f7>  '''Riga 5''' ||  Testo riga 5       ||
||<#f7f7f7>  '''Riga 6''' ||  Testo riga 6       ||
||<#f7f7f7>  '''Riga 7''' ||  Testo riga 7       ||
||<#f7f7f7>  '''Riga 8''' ||  Testo riga 8       ||

che verrà visualizzata così:

Colonna 1

Colonna 2

Riga 1

Testo riga 1

Riga 2

Testo riga 2

Riga 3

Testo riga 3

Riga 4

Testo riga 4

Riga 5

Testo riga 5

Riga 6

Testo riga 6

Riga 7

Testo riga 7

Riga 8

Testo riga 8


CategoryComunitaDocumentazione