Inserire una tabella

Inserire una tabella con le opzioni

Per inserire una tabella con le opzioni si deve digitare il seguente codice:

[width="60%",cols="opzioni colonne">,options="opzioni tabella"]
|===
| colonna 1 | colonna 2 |  colonna 3 |
|  cella 1| cella 2 |  cella 3 |
| cella 4 |  cella 5|  cella 6 |
|  cella 7| cella 8 |  cella 9 |
| cella 10 | cella 11 |  cella 12 |
|===

Quindi se digitiamo il seguente codice:

[width="60%",cols="s,^,^m,>e">,options="header,footer"]
|===
| colonna 1 | colonna 2 |  colonna 3 |  colonna 4
|  1| 2 |  3 |  4
| 5 |  6|  7 |  8
|  9| 10 |  11 |  12
| 13 | 14 |  15 | 16
|===

Otterremo la seguente tabella:

colonna 1	colonna 2	colonna 3	colonna 4
13	14	`15`	16
1	2	`3`	4
5	6	`7`	8
9	10	`11`	12

L’unico limite nel creare le tabelle in Asciidoc è che possiamo creare tabelle con al massimo 4 colonne, ovviamente con quante righe vogliamo.

Opzioni tabella

Ora dobbiamo spiegare le opzioni della tabella. Come abbiamo visto sopra la prima riga del codice di una tabella si presenterà tipo questa:

[width="60%",cols="s,^,,^m,>e">,options="header,footer"]

Spieghiamo ora il significato di questi marcatori.

Marcatori opzioni tabella

Tutte le opzioni sono inserite tra virgolette e sono separate da una virgola l’una dall’altra.

Larghezza tabella:

width="60%": Larghezza in percentuale della tabella

Allineamento colonne:
cols="^": testo centrato nella colonna
cols=">": testo allineato a destra nella colonna
cols=" ": nessun marcatore significa testo allineato a sinistra nella colonna

Attributi del testo:

Dopo il marcatore dell’allineamento si può mettere il marcatore dell’attributo del testo.

Per esempio:

cols="s,^,^m,>e">

cols="s": colonna con testo in grassetto
cols="m": colonna con testo più marcato (ma meno del grassetto)
cols="e": colonna con testo in corsivo
cols=" ": nessun marcatore significa colonna con testo normale

Opzioni generali tabella:

options="header,footer"

Questa opzione serve ad indicare di evidenziare la riga dell’intestazione della tabella mettendone in grassetto il testo.

Inserire una tabella con delle celle unite

Per inserire una tabella con delle opzioni che permettono di unire singole celle si scriverà un codice tipo questo:

[width="35%", cols="^,^,^,^", options="header,footer"]
|===
|1 >s|2 |3 |4
2.2+|5 2+|6
|7 |8
|9 |10 |11 |12
|===

Che produrrà la seguente tabella:

1	2	3	4
9	10	11	12
5		6
5		7	8

Opzioni delle celle della tabella

Ora dobbiamo spiegare le opzioni che possiamo applicare alle singole celle della tabella.

Vediamo l’esempio di un come si sviluppa il codice di una singola cella:

2.2+ >s|contenuto

che indica:
2.2+ --> marcatore numero celle unite in verticale (quindi righe)
2+   --> marcatore numero celle unite in orizzontale
>s   --> marcatore dell'allineamento della cella con l'attributo del testo
 |   --> contenuto della cella a cui si applicano i marcatori

Spieghiamo ora il significato di questi marcatori che si possono applicare alle singole celle della tabella.

Marcatori opzioni cella

Tutte le opzioni devono essere messe prima della cella a cui si applicano e vengono inserite in questa forma:

2.2+ >s|contenuto

Le opzioni che non si vogliono applicare semplicemente si omettono dal codice.

Marcatori cella

2.2+|: Il primo numero indica le celle unite in verticale e il secondo le celle unite in orizzontale
2+|: il numero indica le celle unite in orizzontale
>s|: il primo marcatore indica l’allineamento della cella e il secondo marcatore l’attributo del testo. Questi marcatori li abbiamo già trattati sopra per quanto riguarda le opzioni della tabella

Altri metodi per fare le tabelle

Ci sono altri due metodi per creare le tabelle con il codice AsciiDoc. Soltanto che con questi due metodi possiamo utilizzare le opzioni generali per le tabelle, ma non possiamo utilizzare le opzioni per le singole celle. Quindi non possiamo unire le celle o usare attributi di testo personalizzati per una singola cella.

1° metodo alternativo per creare una tabella

Per creare una tabella con questo metodo scriveremo un codice tipo questo:

[width="70%",cols="^,,>,options="header,footer"]
:===
 intestazione 1:intestazione 2:intestazione 3
 a:b:c
 a:b:c
:===

E produrremo la seguente tabella:

intestazione 1

intestazione 2

intestazione 3

2° metodo alternativo per creare una tabella