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

Referencias

  1. 1 2 «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

Este artículo ha sido escrito por Wikipedia. El texto está disponible bajo la licencia Creative Commons Attribution-Share Alike 4.0. Pueden aplicarse cláusulas adicionales a los archivos multimedia.