AsciiDoc
lenguaje de marcado ligero
From Wikipedia, the free encyclopedia
AsciiDoc es un lenguaje de marcado de documentos ligero, semánticamente equivalente a DocBook, pero usando sintaxis de texto plano en vez de XML. Los documentos en AsciiDoc pueden ser creados usando cualquier editor de textos, y leídos de la misma forma; y también renderizados a HTML o cualquier otro formato soportado por una toolchain de DocBook: PDF, TeX, o páginas del manual, por ejemplo.[1]
| AsciiDoc | ||
|---|---|---|
| https://asciidoc.org/ | ||
| Información general | ||
| Extensión de archivo | txt, adoc y asciidoc | |
| Tipo de MIME | text/asciidoc | |
| Lanzamiento inicial | 2002 | |
| Formato abierto | ? | |
Las extensiones de archivo más comunes para un documento AsciiDoc son txt (que es la que el creador de AsciiDoc recomienda) y adoc.[2][3]
Historia
Asciidoctor
Una implementación escrita en Ruby, llamada "Asciidoctor", publicada en 2013, es la más popular de las implementaciones, y es usada por GitHub[4] y GitLab.[5] Esta implementación también está disponible en el ecosistema de Java, usando JRuby, y en el de JavaScript mediante Opal.js.
Algunos de los libros, físicos y electrónicos, de O'Reilly Media fueron escritos usando marcado AsciiDoc.[6]
La mayor parte de la documentación de Git está escrita usando AsciiDoc.[7]
El formato AsciiDoc está actualmente bajo un proceso de estandarización dirigido por la Eclipse Foundation.[8][9]
Ejemplo
La siguiente tabla muestra un texto formateado en AsciiDoc, y un renderizado similar al que produciría un procesador de AsciiDoc:
| Texto en AsciiDoc |
|---|
= My Article
J. Smith
https://wikipedia.org[Wikipedia] is an
on-line encyclopedia, available in
English and *many* other languages.
== Software
You can install 'package-name' using
the `gem` command:
gem install package-name
== Hardware
Metals commonly used include:
* copper
* tin
* lead
|
| Resultado renderizado |
|---|
|
J. Smith Wikipedia is an on-line encyclopedia, available in English and many other languages. You can install package-name using the gem command: gem install package-name Metals commonly used include:
|
Herramientas
- Antora – un generador de sitios de documentación multirepositorio que usa git.
- awestruct – un generador de sitios estáticos inspirado en Jekyll.
- Asciidoc FX – un editor de libros en AsciiDoc que usa JavaFX 8.
- AsciiDocLIVE – un editor de AsciiDoc en línea.
- DAPS – DocBook Authoring and Publishing Suite (DAPS) un sistema de línea de comandos para publicar documentos DocBook y AsciiDoc como HTML, PDF, y EPUB.
