blob: 3908391a9da7bd56b608b9a7a533509bb142dd17 (
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
|
Questo sembra essere un comune file di testo: in realtà è
un documento reStructuredText pienamente valido.
reStructuredText, o in breve reST, è infatti un linguaggio
di markup esplicitamente progettato perché i suoi sorgenti
fossero facilmente leggibili e di conseguenza assomiglia
molto al testo semplice con le semplici convenzioni per
indicare la formattazione che si usano ad esempio nei
messaggi email.
L'elemento di base in cui si suddivide un documento reST
è il paragrafo: un blocco di testo separato da righe
vuote ed indentato a sinistra allo stesso livello.
Un paragrafo può essere indentato a qualsiasi livello;
il primo livello viene generalmente usato per indicare
citazioni e come tale verrà trattato dagli strumenti
che manipolano reST per la conversione in altri formati.
Ulteriori livelli di indentazione sono legali, ma
potrebbero non avere un significato semantico preciso,
e in generale conviene evitarli.
Contrariamente ad altri linguaggi più anziani, reStructuredText
suppone che, salvo indicazione contraria, il testo sia
codificato in utf-8: questo permette di inserire
direttamente la maggior parte dei caratteri, dalle
semplici lettere accentate a diacritici esotici, o perfino
altri sistemi di scrittura.
Ad esempio è possibile scrivere direttamente parole greche
come λόγος, russe (Правда), giapponesi (おたく).
|
