AsciiDoc: differenze tra le versioni

Versione delle 12:35, 3 dic 2019

Versione attuale delle 13:06, 9 feb 2024

(5 versioni intermedie di 4 utenti non mostrate)

Riga 1:

{{Formato file

'''AsciiDoc''' è un formato per documenti di testo, a [[markup|marcatori]], leggibile direttamente da sorgente e semanticamente equivalente a [[DocBook]] [[XML]], che usa convenzioni di testo semplice come marcatori. Documenti AsciiDoc possono essere creati usando un qualunque editor di testo semplice e letti “come stanno”, o trasformati in [[HTML]] o qualsiasi altro formato supportato dal gruppo di programmi di elaborazione di DocBook, come [[PDF]], [[TeX]], [[Man (Unix)|pagine man]] [[Unix]], [[e-book]], presentazioni, ecc.<ref name="ll" />

|nome = AsciiDoc

|icona = <!-- solo nome file -->

|estensione = .adoc

|magic_number =

|uniform_type_identifier =

|typecode =

|sviluppatore =

|proprietario =

|licenza =

|data_pubblicazione = {{data e tempo|||2002}}

|ultima_versione =

|data_ultima_versione =

|nota_ultima_versione =

|genere = [[Linguaggio di markup]]

|estensione_di =

|esteso_a =

|standard =

|aperto = sì

|sito = asciidoc.org

}}

'''AsciiDoc''' è un [[Formato di file|formato]] per [[File di testo|documenti di testo]], a [[markup|marcatori]], leggibile direttamente da [[Codice sorgente|sorgente]] e [[Semantica (informatica)|semanticamente]] equivalente a [[DocBook]] [[XML]], che usa convenzioni di testo semplice come marcatori. Documenti AsciiDoc possono essere creati usando un qualunque [[editor di testo]] semplice e letti “come stanno”, o trasformati in [[HTML]] o qualsiasi altro formato supportato dal gruppo di programmi di elaborazione di DocBook, come [[PDF]], [[TeX]], [[Man (Unix)|pagine man]] [[Unix]], [[e-book]], presentazioni, ecc.<ref name="ll" />

==Storia==

AsciiDoc è stato creato nel 2002 da Stuart Rackham, a cui si deve la pubblicazione degli strumenti ‘asciidoc’"asciidoc" e ‘a2x’"a2x", scritti in [[linguaggio di programmazione]] [[Python]] per convertire file di testo semplice, ‘umanamente"umanamente leggibili’leggibili", in formati [[Standard (informatica)|standard]] per la pubblicazione di documenti.<ref name="ll">{{cita web|url=http://www.linuxlinks.com/article/20130921024111314/AsciiDoc.html|titolo=AsciiDoc|accesso=12 aprile 2015|dataarchivio=3 marzo 2016|urlarchivio=https://web.archive.org/web/20160303232746/http://www.linuxlinks.com/article/20130921024111314/AsciiDoc.html|urlmorto=sì}}</ref>

Un'implementazione in [[Ruby (linguaggio di programmazione)|Ruby]] chiamata ‘Asciidoctor'"Asciidoctor", pubblicata nel 2013, viene usata da [[GitHub]]<ref>{{cita web|url=http://asciidoctor.org/news/2013/01/30/asciidoc-returns-to-github/|titolo=AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories}}</ref> e fornisce anche un metodo per l'uso di Asciidoc in [[Java (linguaggio di programmazione)|Java]].

Alcuni dei libri e [[ebook]] di [[O'Reilly Media]] sono generati partendo da sorgenti AsciiDoc.<ref>{{cita web|url=https://www.oreilly.com/authors/welcome/asciidoc.csp|titolo=O'Reilly Author Portal -- Welcome Kit: Writing in AsciiDoc }}</ref>

Riga 11 ⟶ 32:

==Esempio==

Il seguente testo mostra l'uso di marcatori AsciiDoc, e un risultato simile a quello prodotto da un elaboratore di AsciiDoc:

{| style="float: left; margin-right: 1em"

Riga 46 ⟶ 67:

|-

|

<div style="margin-top: 1em; border: 1pt solid lightgrey; padding: 1em">

<h1>Mio articolo</h1>

<div style="border-bottom: 1px solid #AAAAAA; font-size: 1.8em; margin-top:1em; margin-bottom: .25m; overflow: hidden;">Mio articolo</div>

<div class="details">

P. Rossi

<span id="author" class="author">P. Rossi</span><br />

</div>

<span style="font-family:serif">
[https://wikipedia.org Wikipedia] è un'enciclopedia on-line, disponibile in inglese e molte altre lingue..
</span>

<spandiv style="border-bottom: 1px solid #AAAAAA; font-size: 120%1.5em; margin-top:1em; margin-bottom: .25em; overflow: hidden;">Software</spandiv>

<span style="font-family:serif">

----

<span style="font-family:serif">You can install ''package-name'' using the <kbd>gem</kbd> command:
</span>

gem install package-name

<spandiv style="border-bottom: 1px solid #AAAAAA; font-size: 120%1.5em; margin-top:1em; margin-bottom: .25em; overflow: hidden;">Hardware</spandiv>

----

<div style="font-family:serif">

Metalli usati comunemente sono:

Riga 66 ⟶ 88:

* stagno

* piombo

</div>

</div>

|}

Riga 92 ⟶ 115:

{{Portale|software libero}}

[[Categoria:PythonLinguaggi di markup liberi]]