iskm/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-05-08 15:58:33 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Merge pull request #2978 from chris54721/patch-3

Browse Source 
[rst/it] Improve wording
This commit is contained in:
Andre Polykanine A.K.A. Menelion Elensúlë 2017-10-28 17:56:28 +03:00 committed by GitHub
commit 4e46adce50
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
it-it/rst-it.html.markdown
View File

@ -6,10 +6,12 @@ contributors:
- ["Andre Polykanine", "https://github.com/Oire"] - ["Andre Polykanine", "https://github.com/Oire"]
translators: translators:
- ["Ale46", "https://github.com/Ale46"] - ["Ale46", "https://github.com/Ale46"]
- ["Chris54721", "https://chris54721.net"]
lang: it-it lang: it-it
--- ---
RST è un formato di file formalmente creato dalla comunità Python per scrivere documentazione (e quindi fa parte di Docutils). RST (Restructured Text) è un formato di file inizialmente creato dalla comunità Python
per la documentazione (per questo motivo appartiene a Docutils).
I file RST sono semplici file di testo con una sintassi leggera (in confronto all'HTML). I file RST sono semplici file di testo con una sintassi leggera (in confronto all'HTML).
@ -23,7 +25,7 @@ Per usare Restructured Text, sarà necessario installare [Python](http://www.pyt
$ easy_install docutils $ easy_install docutils
``` ```
O se il tuo sistema ha `pip`, puoi usare anche lui: Oppure, se hai `pip` installato sul tuo sistema:
```bash ```bash
$ pip install docutils $ pip install docutils
@ -32,7 +34,7 @@ $ pip install docutils
## Sintassi del file ## Sintassi del file
Un semplice esempio della sintassi del file: Ecco un semplice esempio della sintassi RST:
``` ```
.. Le righe che iniziano con due punti sono comandi speciali. Ma se non è possibile trovare alcun comando, la riga viene considerata come un commento .. Le righe che iniziano con due punti sono comandi speciali. Ma se non è possibile trovare alcun comando, la riga viene considerata come un commento
@ -41,16 +43,16 @@ Un semplice esempio della sintassi del file:
I titoli principali sono scritti utilizzando caratteri di uguale, sopra e sotto 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. Si noti che devono esserci tanti caratteri di uguale quanti caratteri del titolo.
Anche il titolo è sottolineato con caratteri di uguale Anche i titoli normali usano caratteri di uguale, ma solo sotto
====================================================== ===============================================================
Sottotitoli con i trattini I sottotitoli usano i trattini
-------------------------- ------------------------------
E sotto-sottotitoli con tildi E i sotto-sottotitoli le tildi
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Puoi inserire il testo in *corsivo* o in **grassetto**, puoi "contrassegnare" il testo come codice con un doppio apice ``: `` print () ``. Puoi inserire il testo in *corsivo* o in **grassetto**, puoi "contrassegnare" il testo come codice con un doppio apice ``: `` print () ``.
@ -60,13 +62,13 @@ Le liste sono semplici come in Markdown:
- Secondo elemento - Secondo elemento
     - Sottoelemento      - Sottoelemento
o oppure
* Primo elemento * Primo elemento
* Secondo elemento * Secondo elemento
     * Sottoelemento      * Sottoelemento
Le tabelle sono davvero facili da scrivere: Le tabelle sono molto semplici da inserire:
=========== ======== =========== ========
Stato Capitale Stato Capitale
@ -75,22 +77,21 @@ Francia Parigi
Giappone Tokio 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 :) Anche le tabelle più complesse possono essere inserite facilmente (colonne e/o righe unite) ma ti suggerisco di leggere la documentazione completa per questo :)
Esistono diversi modi per creare collegamenti: 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). - Aggiungendo un underscore dopo una parola: Github_ e aggiungendo l'URL di destinazione dopo il testo (questo metodo 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) - Digitando un URL completo: https://github.com/ (verrà automaticamente convertito in un collegamento)
- Facendo un collegamento simile a Markdown: `Github <https://github.com/>`_ . - Utilizzando una sintassi simile a Markdown: `Github <https://github.com/>`_ .
.. _Github https://github.com/ .. _Github https://github.com/
``` ```
## Come usarlo ## Come usarlo
RST viene fornito con docutils che dispone di `rst2html`, per esempio: RST viene fornito con docutils, che dispone di `rst2html`, per esempio:
```bash ```bash
$ rst2html miofile.rst output.html $ rst2html miofile.rst output.html