aboutsummaryrefslogtreecommitdiff
path: root/esempi/07.rst
blob: b460ef0f0902010d86284f8f4c241ecfacc6ce4e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
=======
Tabelle
=======

Il modo di inserire tabelle in reStructuredText è disegnare una griglia
mediante caratteri ascii; è abbastanza noioso da scrivere, ma 
permette di esprimere tabelle abbastanza complesse.

+----------+----------+---------+
| Titolo 1 | Titolo 2 | Titolo3 |
+==========+==========+=========+
| Casella  | Casella larga      |
+----------+----------+---------+
| Casella  | - a      | 1       |
| su più   | - b      +---------+
| righe    | - c      | 2       |
+----------+----------+---------+

In realtà esistono due modi per disegnare tabelle: quello a griglia 
visto prima ed un metodo semplificato più veloce da scrivere, 
ma limitato nei contenuti.

====================== ========= ======== =========
   Caratteristiche           Tipo di tabella 
---------------------- ----------------------------
     disponibili       A griglia Semplice Ad elenco
====================== ========= ======== =========
Facili da scrivere     NO        SI       SI
Caselle su più colonne SI        SI       NO
Caselle su più righe   SI        NO       NO
Paragrafi nelle celle  SI        NO       SI
====================== ========= ======== =========

In realtà se si considerano anche le direttive esistono tre modi 
per disegnare le tabelle: a griglia, semplice e con un elenco.

.. list-table:: Tabella ad elenco
   :widths: 10 20 20
   :header-rows: 1
   :stub-columns: 1

   * - Tipo di tabella
     - generabile con
     - leggibilità
   * - a griglia
     - + `script in python <http://media.commandline.org.uk//code/table.txt>`_
       + `script per vim <http://www.vim.org/scripts/script.php?script_id=3041>`_
     - Ben leggibile, purché non superi l'ottantina di caratteri di 
       larghezza (oltre può dare problemi a chi usa schermate ISO/ANSI)
   * - semplice
     - Può essere scritta a mano
     - Ben leggibile per larghezze limitate
   * - ad elenco
     - È sufficientemente semplice per essere scritta a mano
     - Ben leggibile nel caso di contenuti che si prestano bene 
       a questo formato
   * - csv
     - + dati provenienti da spreadhseet o altre elaborazioni.
     - Meno leggibile delle alternative.

Esistono quindi quattro modi per scrivere tabelle: a griglia, semplificate, 
ad elenco e da dati in CSV (Comma Separated Values).

.. csv-table:: 
   :header: "Giorno", "Massima", "Minima"
   
   "2038-01-16","10","2"
   "2038-01-17","5","-2"
   "2038-01-18","7","0"
   "2038-01-19","-10","-20"

Infine esiste la direttiva ``table`` che contiene una tabella scritta 
con uno dei primi due metodi e le associa un titolo.

.. table:: Una tavola

   =============  ============
      Tabella        Tavola
   =============  ============
   non ha titolo  ha un titolo
   =============  ============