Em vaig ensenyar HTML fa molt de temps, en un programari anomenat HotDog (Pro?). No hi havia cap cosa com What You See Is What You Get capacitats en aquell moment. No obstant això, HotDog tenia una característica sorprenent: la barra d'eines tenia totes les etiquetes HTML (no hi havia tants en aquell moment) com a botons, i es podia aprendre fent clic en ells i veient els resultats. Després va arribar Dreamweaver. Va ser el primer editor WYSIWYG, i immediatament es va fer molt popular. Les persones que no tenien ni idea de l'HTML van començar a utilitzar-lo: el nombre de llocs web va créixer ràpidament. L'he utilitzat una vegada i vaig mirar l'HTML generat. Després d'aprendre a escriure l'HTML "per mà", el vaig trobar generat per Dreamweaver obertament verbosa. vaig continuar escrivint el meu HTML per mà o amb l'ajuda d'IDEs. HTML va anar més enllà dels llocs web per ser un format omnipresent que Sir Berners-Lee no hauria somiat que es convertiria en. Juntament amb els navegadors web, es va convertir en el mitjà per a les aplicacions web. Creació de HTML. Creació de HTML. Creació de HTML. Doctrina de Python Rubí RDOC Ruta de la Ruta Encara que puguis escriure fragments HTML, , en JavaDocs, escriure HTML per la línia es converteix en una borra bastant ràpid. No obstant això, la majoria de la documentació no necessita el poder complet de l'HTML, especialment el tipus portat per les seves versions més modernes. El g. <table> Per abordar aquest problema, John Gruber i Aaron Swartz van inventar Markdown el 2004. 
 
 
 Markdown és un llenguatge de marcatge lleuger per crear text formatat utilitzant un editor de text simple.John Gruber va crear Markdown el 2004 com un llenguatge de marcatge fàcil de llegir. El marcatge Markdown és un llenguatge de marcatge lleuger per crear text formatat utilitzant un editor de text simple.John Gruber va crear Markdown el 2004 com un llenguatge de marcatge fàcil de llegir. — — — Marcatge Markdown va prendre el món per tempesta. crec que és encara més popular que HTML, almenys en el món de la tecnologia. Ha estat disponible a GitHub des de fa segles. Java l'ha integrat en els seus JavaDocs en la versió 25. Limitacions de marcatge Markdown és increïble, però té fortes limitacions. vaig escriure el meu darrer llibre amb Markdown, en la tradició Doc-as-Code. Aquí teniu un extracte senzill de la meva experiència d'escriptura de llibres. Volia incloure fragments de codi per il·lustrar els meus punts. Tanmateix, volia que fossin vàlids: compilats i provats. vaig escriure un projecte, complet amb una configuració de construcció. No obstant això, Markdown no permet la inclusió de fitxers externs. Vaig haver de copiar i pegar els fragments requerits. pitjor, perquè escriure un llibre triga un temps, vaig mantenir actualitzada la versió de les dependències. Cada vegada que ho vaig fer, vaig haver de copiar i pegar el codi actualitzat en cada ocurrència. Interessantment, la documentació adreçada als desenvolupadors té el mateix cas d'ús. Una altra limitació estesa és voler cridar l'atenció a un article.Aquí hi ha una opció d'estil: L’Ajuntament no ofereix res semblant, per aquest motiu. Què passa amb altres idiomes? no ho sé; m'agradaria que fos part de Markdown. Python marcatge Encara que hi ha molts més, el meu punt final serà sobre les taules. Markdown gestiona les taules, fins a un punt, que és els encapçalaments de columnes. i , que no són compatibles. Afortunadament, HTML és vàlid Markdown. No obstant això, la formatació dins de la taula, el codi, etc., s'ha de transformar en HTML juntament amb ell. rowspan colspan Ascensió Asciidoc és la solució a les limitacions anteriors. 
 
 
 AsciiDoc és un llenguatge de marcatge de text simple per escriure contingut tècnic. Està ple d'elements semàntics i està equipat amb funcions per modularitzar i reutilitzar el contingut. El contingut d'AsciiDoc es pot compondre utilitzant un editor de text, gestionat en un sistema de control de versions, i publicat a múltiples formats de sortida. - Asciidoc AsciiDoc és un llenguatge de marcatge de text simple per escriure contingut tècnic. Està ple d'elements semàntics i està equipat amb funcions per modularitzar i reutilitzar el contingut. El contingut d'AsciiDoc es pot compondre utilitzant un editor de text, gestionat en un sistema de control de versions, i publicat a múltiples formats de sortida. — — — Ascensió Anem a veure com Asciidoc aborda les limitacions una per una: 
 
 
 
 
 
 
 : Include 
 
 An include directive imports content from a separate file or URL into the content of the current document. When the current document is processed, the include directive syntax is replaced by the contents of the include file. Think of the include directive like a file expander. 
 
 
 : Admonitions 
 
 There are certain statements you may want to draw attention to by taking them out of the content’s flow and labeling them with a priority. These are called admonitions. This page introduces you to admonition types AsciiDoc provides, how to add admonitions to your document, and how to enhance them using icons or emoji. 
 
 
 Cell span Asciidoc has a   as well as a  , both managed by the Eclipse Foundation. Note, though, that   is the sole implementation of Asciidoc. The Asciidoctor site is actually hosting the  . For most intents and purposes, you can treat them as one, as I do. specification TCK Asciidoctor Asciidoc documentation Una directiva inclou importa el contingut d'un arxiu separat o URL al contingut del document actual. Quan es processa el document actual, la sintaxi de la directiva inclou es reemplaça pel contingut del fitxer inclou. Hi ha certes declaracions a les quals pot ser que vulgueu cridar l'atenció eliminant-les del flux de contingut i etiquetant-les amb una prioritat. Aquestes s'anomenen advertències. Aquesta pàgina us presenta els tipus d'advertències que proporciona AsciiDoc, com afegir advertències al vostre document i com millorar-les utilitzant icones o emoji. He esmentat més amunt com Asciidoc resol tres limitacions que es troben regularment en Markdown, però ofereix molts més beneficis. Tones de característiques estan disponibles. 
 
 
 
 
 
 
 
 
 
 : Video embedding A sample is more descriptive than a complete description: [source]
----
video::RX9zwgHuNmA[youtube,width=840,height=473]
----
 
 
 
   , as seen above: Blockquotes with attribution [quote,'https://asciidoc.org/[Asciidoc^]']
____
AsciiDoc is a plain text markup language for writing technical content.
____
 
 
 
 . This one is of utmost importance when I write self-driven workshops: Collapsible blocks [%collapsible]
====
This content is only revealed when the user clicks the block title.
====
 
 
 
 Materializing   is another useful feature for workshops and technical documentation in general: menus and buttons 
 
 
 
 
 Click on the OK button. 
 
 Go to the   item. Text > Text Filters > JSON 
 
 Automatic table of contents Amb la cadena d'eines adequada, podeu generar HTML d'Asciidoc i publicar el resultat a GitHub/GitLab Pages. Aplicació Apache Hands-on Lab Ecosistema de l'Asciidoc Una eina només és tan útil com el seu ecosistema circumdant.Aquí hi ha un parell d'aquestes eines i beneficis: 
 
 
 
 
 
 
 GitHub renders Asciidoc as well as Markdown. Try using a   and watch the  . Here's a non-exhaustive list of  . README.adoc magic happen Asciidoc integration items with GitHub 
 
 Jekyll, the blog engine, has a seamless  . This blog runs on Jekyll with Asciidoc. Asciidoc integration 
 
 
 
 : Asciidoctor Diagram 
 
 Asciidoctor Diagram is a set of Asciidoctor extensions that enable rendering of plain text diagrams that are embedded in your AsciiDoc document as part of the Asciidoctor conversion process. I use it   with PlantUML. You might have noticed it on this blog already. a lot 
 
 
 : Reveal.js integration Asciidoc allows you to generate regular HTML documents, but Reveal.js enables the creation of slide-based presentations. When I taught at university, I used both regular HTML for seminar works and slides for courses. My old   is available as a GitHub Pages site (in French). Java EE course Icing on the cake, you can leverage the  . diagram integration Diagrama d'Asciidoctor és un conjunt d'extensió d'Asciidoctor que permet la rendició de diagrames de text simple que s'incorporen al document d'Asciidoctor com a part del procés de conversió d'Asciidoctor. Conclusió Markdown és a tot arreu, i estic més que feliç si satisfà les vostres necessitats. He tingut diverses experiències on no va satisfer les meves expectatives: documentació tècnica, tallers, cursos i escriptura de llibres. Espero que aquest post t'hagi donat prou arguments per provar-ho. To go further: 
 
 
 
 
 Documentació Asciidoctor Informació sobre Asciidoctor reveal.js Diagrama de l'Asciidòleg Jekyll AsciiDoc Plugin Originalment publicat a A Java Geek el 26 d'octubre de 2025 Una java geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Aquest àudio és produït a l'idioma original de la història!

Asciidoc: Quan el marcatge no està tallant

About Author

COMENTARIS

Etiquetes penjant

AQUEST ARTICLE VA SER PRESENTAT A

Related Stories

On Taxes

Startups of The Year: Meet the Education Industry

Startups of The Year: Meet the Healthcare Industry

Startups of The Year: Meet the Business Industry

On Taxes

Startups of The Year: Meet the Education Industry

Startups of The Year: Meet the Healthcare Industry

Startups of The Year: Meet the Business Industry

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps