AsciiDoc
AsciiDoc este un format pentru documente text , cu markere , lizibil direct de la sursă și semantic echivalent cu DocBook XML , care folosește convenții de text simplu ca markeri. Documentele AsciiDoc pot fi create folosind orice editor de text simplu și citite „ca atare”, sau transformate în HTML sau în orice alt format acceptat de grupul DocBook de programe de procesare, cum ar fi PDF , TeX , pagini man Unix , cărți electronice , prezentări, etc. [1]
Istorie
AsciiDoc a fost creat în 2002 de Stuart Rackham, care a fost responsabil pentru publicarea instrumentelor „asciidoc” și „a2x”, scrise în limbajul de programare Python pentru a converti fișierele de text simplu, „lizibil uman”, în formate standard pentru publicare. documente. [1]
O implementare Ruby numită „Asciidoctor”, lansată în 2013, este utilizată de GitHub [2] și oferă, de asemenea, o metodă de utilizare a Asciidoc în Java .
Unele dintre cărțile și cărțile electronice ale O'Reilly Media sunt generate din surse AsciiDoc. [3]
O mare parte din documentația Git este scrisă în AsciiDoc. [4]
Exemplu
Următorul text prezintă utilizarea markerilor AsciiDoc și un rezultat similar cu cel produs de un procesor AsciiDoc:
Textul sursă AsciiDoc |
---|
= Articolul meu P. Rossi http://wikipedia.org [Wikipedia] este o enciclopedie online, disponibilă în Engleză și multe alte limbi. == Software Puteți instala „pachet-nume” folosind comanda + gem +: gem instalează numele pachetului == Hardware Metalele utilizate în mod obișnuit sunt: * cupru * iaz * conduce |
Rezultat redat HTML |
---|
Articolul meu Wikipedia este o enciclopedie online, disponibilă în engleză și în multe alte limbi. Software Puteți instala numele pachetului folosind comanda gem : gem instalează numele pachetului Hardware Metalele utilizate în mod obișnuit sunt:
|
Notă
- ^ a b AsciiDoc , pe linuxlinks.com . Adus la 12 aprilie 2015 (arhivat din original la 3 martie 2016) .
- ^ AsciiDoc, dezvoltat de Asciidoctor, revine la GitHub și la peste 5 milioane de depozite , pe asciidoctor.org .
- ^ O'Reilly Author Portal - Welcome Kit: Writing in AsciiDoc , on oreilly.com .
- ^ Git wiki , la git.wiki.kernel.org , Git SCM.
Elemente conexe
Limbi similare pentru marcaje ușoare:
- creol
- Markdown
- Modul de organizare
- Documentație veche simplă , utilizată pentru documentația Perl
- ReStructuredText , utilizat pentru documentarea Python
- Setext
- Textile
- txt2tags
- Wikitext
linkuri externe
- Ghid de referință Asciidoc „cheat-sheet” , la powerman.name .
- MPLW - Filtru grafic Matplotlib pentru AsciiDoc , pe volnitsky.com . Adus la 12 aprilie 2015 (arhivat din original la 3 aprilie 2015) .
- RTextDoc. Editor cu suport AsciiDoc. , pe jwork.org .
- AsciidocToGo. Frontend pentru a converti fișiere txt AsciiDoc , pe dbcb.github.io .