AsciiDoc

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	?

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]​

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

AsciiDoc fue creado en 2002 por Stuart Rackham, quien publicó unas herramientas (‘asciidoc’ y ‘a2x’) escritas en Python para convertir texto plano, en un formato "legible para humanos" a alguno de los formatos comúnmente utilizados en la publicación.[1]​

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
My Article J. Smith 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

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.

Véase también

• DocBook

Referencias

1. «AsciiDoc». Archivado desde el original el 3 de marzo de 2016. Consultado el 18 de octubre de 2013. 
2. «AsciiDoc Frequently Asked Questions». asciidoc.org (en inglés). Consultado el 23 de febrero de 2024. 
3. «AsciiDoc Recommended Practices | Asciidoctor». asciidoctor.org (en inglés). Consultado el 23 de febrero de 2024. 
4. «AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories». Asciidoctor (en inglés). 
5. «Asciidoc». GitLab User Docs (en inglés). Archivado desde el original el 22 de julio de 2019. Consultado el 6 de febrero de 2020. 
6. «AsciiDoc 101 (chapter 4 of Getting Started with Atlas)». Author Welcome Kit (en inglés). O'Reilly Media. Archivado desde el original el 14 de octubre de 2017. Consultado el 19 de mayo de 2016. 
7. «Git wiki» (en inglés). Git SCM. Consultado el 23 de febrero de 2024. 
8. «AsciiDoc Language». 27 de julio de 2020. Consultado el 23 de febrero de 2024. 
9. «AsciiDoc Working Group Charter». Consultado el 23 de febrero de 2024. 

Enlaces externos

• Sitio web oficial
• Using AsciiDoc and Asciidoctor to write documentation - An AsciiDoc Tutorial (en inglés)

• Datos: Q723030