diff --git a/it-it/markdown.html.markdown b/it-it/markdown.html.markdown index b006dbb4..44801747 100644 --- a/it-it/markdown.html.markdown +++ b/it-it/markdown.html.markdown @@ -2,41 +2,65 @@ language: markdown contributors: - ["Dan Turkel", "http://danturkel.com/"] + - ["Jacob Ward", "http://github.com/JacobCWard/"] translators: - ["Jacopo Andrea Giola", "http://geekpanda.net"] + - ["Ale46", "https://github.com/Ale46"] filename: markdown-it.md lang: it-it --- Markdown è stato creato da John Gruber nel 2004. Il suo scopo è quello di essere una sintassi facile da leggere e scrivere, e che può essere convertita in HTML (ad oggi anche in molti altri formati). -Mandate tutto il feedback che volete! / Sentitevi liberi di forkare o di mandare pull request! +Markdown varia nelle sue implementazioni da un parser all'altro. Questa guida cercherà di chiarire quali caratteristiche esistono a livello globale o quando sono disponibili solo per un determinato parser. +- [Elementi HTML](#elementi-html) +- [Titoli](#titoli) +- [Stili di testo semplici](#stili-di-testo-semplici) +- [Paragrafi](#paragrafi) +- [Liste](#liste) +- [Estratti di codice](#estratti-di-codice) +- [Linea orizzontale](#linea-orizzontale) +- [Links](#links) +- [Immagini](#immagini) +- [Miscellanea](#miscellanea) + +## Elementi HTML +Markdown è un superset di HTML, quindi ogni file HTML è a sua volta un file Markdown valido. ```markdown - + +``` - +## Titoli - - +Potete creare gli elementi HTML da `
`) indentando una linea con quattro spazi oppure con un carattere tab.
+```markdown
Questa è una linea di codice
Come questa
+```
-
+Potete inoltre inserire un altro tab (o altri quattro spazi) per indentare il vostro codice
+```markdown
my_array.each do |item|
puts item
end
+```
-
+Codice inline può essere inserito usando il carattere backtick `
+```markdown
Giovanni non sapeva neppure a cosa servisse la funzione `go_to()`!
+```
-
-
-\`\`\`ruby
+In Github Flavored Markdown, potete inoltre usare una sintassi speciale per il codice
+
+```ruby
def foobar
puts "Hello world!"
end
-\`\`\`
+```
+Se usate questa sintassi, il testo non richiederà di essere indentato, inoltre Github userà l'evidenziazione della sintassi del linguaggio specificato dopo i \`\`\` iniziali
-
-
-
-
+## Linea orizzontale
+Le linee orizzontali (`
`) sono inserite facilmente usanto tre o più asterischi o trattini, con o senza spazi.
+```markdown
***
---
- - -
****************
+```
-
-
+## Links
+Una delle funzionalità migliori di markdown è la facilità con cui si possono inserire i link. Mettete il testo da visualizzare fra parentesi quadre [] seguite dall'url messo fra parentesi tonde ()
+```markdown
[Cliccami!](http://test.com/)
+```
-
+Potete inoltre aggiungere al link un titolo mettendolo fra doppi apici dopo il link
+```markdown
[Cliccami!](http://test.com/ "Link a Test.com")
+```
-
+La sintassi funziona anche con i path relativi.
+```markdown
[Vai a musica](/music/).
+```
-
-
+Markdown supporta inoltre anche la possibilità di aggiungere i link facendo riferimento ad altri punti del testo.
+```markdown
[Apri questo link][link1] per più informazioni!
[Guarda anche questo link][foobar] se ti va.
[link1]: http://test.com/ "Bello!"
[foobar]: http://foobar.biz/ "Va bene!"
+```
+l titolo può anche essere inserito in apici singoli o in parentesi, oppure omesso interamente. Il riferimento può essere inserito in un punto qualsiasi del vostro documento e l'identificativo del riferimento può essere lungo a piacere a patto che sia univoco.
-
-
-
-
+Esiste anche un "identificativo implicito" che vi permette di usare il testo del link come id.
+```markdown
[Questo][] è un link.
[Questo]: http://thisisalink.com/
+```
+Ma non è comunemente usato.
-
-
-
-
+## Immagini
+Le immagini sono inserite come i link ma con un punto esclamativo inserito prima delle parentesi quadre!
+```markdown

+```
-
+E la modalità a riferimento funziona esattamente come ci si aspetta
+```markdown
![Questo è il testo alternativo.][myimage]
[myimage]: relative/urls/cool/image.jpg "Se vi serve un titolo, lo mettete qui"
+```
+## Miscellanea
+### Auto link
-
-
-
+```markdown
è equivalente ad
[http://testwebsite.com/](http://testwebsite.com/)
+```
+### Auto link per le email
-
-
+```markdown
+```
+### Caratteri di escaping
-
-
+```markdown
Voglio inserire *questo testo circondato da asterischi* ma non voglio che venga renderizzato in corsivo, quindi lo inserirò così: \*questo testo è circondato da asterischi\*.
+```
-
-
+### Combinazioni di tasti
+In Github Flavored Markdown, potete utilizzare il tag `` per raffigurare i tasti della tastiera.
+```markdown
Il tuo computer è crashato? Prova a premere
Ctrl+Alt+Canc
+```
-
-
+### Tabelle
+Le tabelle sono disponibili solo in Github Flavored Markdown e sono leggeremente complesse, ma se proprio volete inserirle fate come segue:
+```markdown
| Col1 | Col2 | Col3 |
| :------------------- | :------: | -----------------: |
| Allineato a sinistra | Centrato | Allineato a destra |
| blah | blah | blah |
+```
+oppure, per lo stesso risultato
-
-
+```markdown
Col 1 | Col2 | Col3
:-- | :-: | --:
È una cosa orrenda | fatela | finire in fretta
-
-
-
```
+---
Per altre informazioni, leggete il post ufficiale di John Gruber sulla sintassi [qui](http://daringfireball.net/projects/markdown/syntax) e il magnifico cheatsheet di Adam Pritchard [qui](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).