Hispanopedia WikiAsciiDoc es un formato de documento legible por humanos , semánticamente equivalente a DocBook XML , pero que utiliza convenciones de marcado de texto plano . Los documentos AsciiDoc se pueden crear con cualquier editor de texto y leer "tal cual", o bien se pueden convertir a HTML o cualquier otro formato compatible con una cadena de herramientas DocBook, es decir, PDF , TeX , páginas man de Unix , libros electrónicos , presentaciones de diapositivas, etc. [ 2 ] Las extensiones de archivo comunes para archivos AsciiDoc son [ 3 ] e históricamente (como lo recomienda el creador de AsciiDoc). [ 4 ]adoctxt
El formato AsciiDoc está siendo estandarizado por la Fundación Eclipse . [ 5 ] [ 6 ]
Historia
Historia temprana
AsciiDoc fue creado en 2002 por Stuart Rackham, quien publicó herramientas ( asciidoc y a2x ), escritas en el lenguaje de programación Python para convertir archivos de texto plano legibles por humanos a formatos de documentos publicados de uso común. [ 2 ]
También existen implementaciones en Ruby (llamada Asciidoctor , lanzada en 2013), en el ecosistema Java a través de JRuby , en el ecosistema JavaScript a través de Opal.js, y en Haskell y Go .
Estandarización y primacía de Asciidoctor (2019-presente)
Desde el inicio del proceso de estandarización técnica en 2019, el proyecto Asciidoctor se ha propuesto producir una implementación independiente y compatible
de la especificación AsciiDoc en desarrollo, con el apoyo de Stuart Rackham, el autor original del lenguaje. [ 8 ] Desde entonces, el sitio web oficial del lenguaje AsciiDoc ha comenzado a enlazar con la documentación del lenguaje de Asciidoctor.
El inicio del proceso de estandarización en 2019 coincidió con el lanzamiento de Asciidoctor 2.0 y la obsolescencia de varias partes de la sintaxis , como las comillas simples ( ') para indicar cursiva. [ 9 ] La sintaxis heredada sigue estando disponible a través de un modo de compatibilidad. [ 10 ]
La implementación original de Python de Stuart Rackham continúa desarrollándose y se denomina AsciiDoc.py . Desde 2021, su documentación la describe como heredada
y se dirige formalmente a la versión anterior del lenguaje. [ 11 ]
Aplicaciones destacadas
La mayor parte de la documentación del proyecto Git está escrita en AsciiDoc. [ 12 ]
Algunos de los libros y libros electrónicos de O'Reilly Media se escriben utilizando el marcado AsciiDoc. [ 13 ]
La documentación de los productos de Red Hat está escrita en AsciiDoc .
Asciidoctor se puede usar dentro de GitHub [ 14 ] y GitLab . [ 15 ]
El ecosistema IDE de JetBrains admite la edición de AsciiDoc a través de complementos como AsciiDoc y AsciiDoc Pro , que proporcionan soporte para la documentación AsciiDoc, incluyendo vista previa en vivo, resaltado de sintaxis y exportación a PDF. [ 16 ]
Ejemplo
A continuación se muestra un texto que utiliza el marcado AsciiDoc, y una representación similar a la producida por un procesador AsciiDoc:
Herramientas
- Antora : generador de sitios de documentación multi-repositorio para redactores técnicos que utilizan Git.
- AsciiBinder – (obsoleto) sistema de documentación basado en Asciidoctor para personas que tienen muchos documentos que mantener y republicar con regularidad.
- awestruct – generador de sitios estáticos inspirado en Jekyll
- Asciidoc FX – Editor de libros AsciiDoc basado en JavaFX 18
- AsciiDocLIVE – editor AsciiDoc online gratuito
- DAPS – DocBook Authoring and Publishing Suite (DAPS) es un software de línea de comandos para publicar DocBook y AsciiDoc como HTML, PDF y EPUB.
Véase también
Referencias
- ↑ "Versión 2.0.26" . 24 de octubre de 2025. Consultado el 12 de noviembre de 2025 .
- 1 2 "AsciiDoc" . Linuxlinks.com . Archivado del original el 3 de marzo de 2016. Consultado el 18 de octubre de 2013 .
- ↑ "Prácticas recomendadas de AsciiDoc" . Asciidoctor.org . Consultado el 20 de marzo de 2020 .
- ↑ "Preguntas frecuentes de AsciiDoc" . asciidoc.org . Consultado el 20 de marzo de 2020 .
- ↑ "Lenguaje AsciiDoc" . Eclipse.org . 27 de julio de 2020.
- ↑ "Estatutos del Grupo de Trabajo de AsciiDoc" . Eclipse.org .
- ↑ "Versión 10.2.1" . 17 de julio de 2024. Consultado el 21 de julio de 2024 .
- ↑ White, Sarah; Allen, Dan (2019-01-07). "Comenzando el viaje de la especificación AsciiDoc" . Asciidoctor.org . Recuperado el 31 de marzo de 2025 .
- ↑ "Novedades de la versión 2.0: Documentación de Asciidoctor" . Asciidoctor.org . 22 de marzo de 2019. Consultado el 31 de marzo de 2025 .
- ↑ "Actualización de Asciidoctor 1.5.x a 2.0" . Consultado el 31 de marzo de 2025 .
- ↑ Peveler, Matthew (MasterOdin) (09/02/2021). "Añadir una breve nota sobre la naturaleza heredada de AsciiDoc.py" . GitHub . Consultado el 18/05/2025 .
- ↑ "Git wiki" . Git SCM.
- ↑ "AsciiDoc 101 (capítulo 4 de Introducción a Atlas)" . Kit de bienvenida para autores . O'Reilly Media. Archivado del original el 14 de octubre de 2017. Consultado el 19 de mayo de 2016 .
- ↑ Allen, Dan (30 de enero de 2013). "AsciiDoc, impulsado por Asciidoctor, regresa a GitHub y sus más de 5 millones de repositorios" . Recuperado el 31 de marzo de 2025 .
- ↑ "Asciidoc" . Documentación de usuario de GitLab . Archivado del original el 22 de julio de 2019. Consultado el 18 de mayo de 2025 .
- ↑ "AsciiDoc Pro - Complemento para IDEs de IntelliJ | Marketplace" . JetBrains Marketplace . Consultado el 20 de febrero de 2026 .
Enlaces externos
- Sitio web oficial
- Asciidoctor en GitHub
- Software libre programado en Python
- Lenguajes de marcado ligeros
- Software que utiliza la Licencia Pública General de GNU.