mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-26 10:48:51 +00:00
111 lines
3.1 KiB
Markdown
111 lines
3.1 KiB
Markdown
|
---
|
|||
|
|
language: restructured text (RST)
|
|||
|
|
filename: restructuredtext-it.rst
|
|||
|
|
contributors:
|
|||
|
|
- ["DamienVGN", "https://github.com/martin-damien"]
|
|||
|
|
- ["Andre Polykanine", "https://github.com/Oire"]
|
|||
|
|
translators:
|
|||
|
|
- ["Ale46", "https://github.com/Ale46"]
|
|||
|
|
lang: it-it
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
RST è un formato di file formalmente creato dalla comunità Python per scrivere documentazione (e quindi fa parte di Docutils).
|
|||
|
|
|
|||
|
|
I file RST sono semplici file di testo con una sintassi leggera (in confronto all'HTML).
|
|||
|
|
|
|||
|
|
## Installazione
|
|||
|
|
|
|||
|
|
Per usare Restructured Text, sarà necessario installare [Python](http://www.python.org) ed il pacchetto `docutils`.
|
|||
|
|
|
|||
|
|
`docutils` può essere installato da riga di comando:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ easy_install docutils
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
O se il tuo sistema ha `pip`, puoi usare anche lui:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ pip install docutils
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Sintassi del file
|
|||
|
|
|
|||
|
|
Un semplice esempio della sintassi del file:
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
.. Le righe che iniziano con due punti sono comandi speciali. Ma se non è possibile trovare alcun comando, la riga viene considerata come un commento
|
|||
|
|
|
|||
|
|
===============================================================================
|
|||
|
|
I titoli principali sono scritti utilizzando caratteri di uguale, sopra e sotto
|
|||
|
|
===============================================================================
|
|||
|
|
|
|||
|
|
Si noti che devono esistere tanti caratteri di uguale quanti sono i caratteri del titolo.
|
|||
|
|
|
|||
|
|
Anche il titolo è sottolineato con caratteri di uguale
|
|||
|
|
======================================================
|
|||
|
|
|
|||
|
|
Sottotitoli con i trattini
|
|||
|
|
--------------------------
|
|||
|
|
|
|||
|
|
E sotto-sottotitoli con tildi
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
Puoi inserire il testo in *corsivo* o in **grassetto**, puoi "contrassegnare" il testo come codice con un doppio apice ``: `` print () ``.
|
|||
|
|
|
|||
|
|
Le liste sono semplici come in Markdown:
|
|||
|
|
|
|||
|
|
- primo articolo
|
|||
|
|
- Secondo elemento
|
|||
|
|
- Sottoelemento
|
|||
|
|
|
|||
|
|
o
|
|||
|
|
|
|||
|
|
* Primo elemento
|
|||
|
|
* Secondo elemento
|
|||
|
|
* Sottoelemento
|
|||
|
|
|
|||
|
|
Le tabelle sono davvero facili da scrivere:
|
|||
|
|
|
|||
|
|
=========== ========
|
|||
|
|
Stato Capitale
|
|||
|
|
=========== ========
|
|||
|
|
Francia Parigi
|
|||
|
|
Giappone Tokio
|
|||
|
|
=========== ========
|
|||
|
|
|
|||
|
|
Le tabelle più complesse possono essere fatte facilmente (colonne e/o righe unite) ma ti suggerisco di leggere il documento completo per questo :)
|
|||
|
|
|
|||
|
|
Esistono diversi modi per creare collegamenti:
|
|||
|
|
|
|||
|
|
- Aggiungendo un underscore dopo una parola: Github_ e aggiungendo l'URL di destinazione dopo il testo (questo modo ha il vantaggio di non inserire URL non necessari all'interno del testo leggibile).
|
|||
|
|
- Digitando un URL completo: https://github.com/ (verrà automaticamente convertito in un collegamento)
|
|||
|
|
- Facendo un collegamento simile a Markdown: `Github <https://github.com/>`_ .
|
|||
|
|
|
|||
|
|
.. _Github https://github.com/
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Come usarlo
|
|||
|
|
|
|||
|
|
RST viene fornito con docutils che dispone di `rst2html`, per esempio:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
$ rst2html miofile.rst output.html
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
*Nota : In alcuni sistemi il comando potrebbe essere rst2html.py*
|
|||
|
|
|
|||
|
|
Ma ci sono applicazioni più complesse che utilizzano il formato RST:
|
|||
|
|
|
|||
|
|
- [Pelican](http://blog.getpelican.com/), un generatore di siti statici
|
|||
|
|
- [Sphinx](http://sphinx-doc.org/), un generatore di documentazione
|
|||
|
|
- e molti altri
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Letture
|
|||
|
|
|
|||
|
|
- [Riferimento ufficiale rapido](http://docutils.sourceforge.net/docs/user/rst/quickref.html)
|