Naučio sam HTML davno, na softveru pod nazivom HotDog (Pro?). Nije bilo takve stvari kao što je What You See Is What You Get mogućnosti u to vrijeme. Međutim, HotDog je imao nevjerojatnu značajku: toolbar je imao sve HTML oznake (tada nije bilo toliko) kao dugmad, a možete ih naučiti klikom na njih i gledanjem rezultata. Jedini nedostatak je bio da ste morali kliknuti na drugo dugme da biste zatvorili oznaku. Zatim je došao Dreamweaver. To je bio prvi WYSIWYG urednik, i odmah je postao vrlo popularan. Ljudi koji nisu imali pojma o HTML-u počeli su ga koristiti: broj web stranica porastao. Koristio sam ga jednom i pogledao generisani HTML. Nakon što sam naučio da pišem HTML "ručno", našao sam da je generisan od strane Dreamweaver-a otvoreno verbose. Nastavio sam da pišem svoj HTML ručno ili uz pomoć IDEs-a. Brzo napredovanje petnaest godina. HTML je otišao izvan web stranica da bude sveprisutan format koji Sir Berners-Lee ne bi sanjao da će postati. U kombinaciji sa web pretraživačima, on je nastao da postane medij za web aplikacije. Kreirajte HTML. Kreirajte HTML. Kreirajte HTML. Python doktrina Ruski RDOC Uslovi korišćenja Rustdoc Iako možete napisati HTML snippete, , u JavaDocs, pisanje HTML po liniji postaje bore prilično brzo. lako je propustiti slash u tag zatvaranja, ili dobiti Međutim, većina dokumentacije ne treba punu moć HTML-a, pogotovo onaj koji donose njegove modernije verzije. U pitanju je g. <table> Za rješavanje ovog problema, John Gruber i Aaron Swartz izmislili su Markdown 2004. godine. 
 
 
 Markdown je lagan znakovni jezik za stvaranje oblikovanog teksta pomoću urednika jednostavnog teksta. John Gruber stvorio je Markdown 2004. godine kao lak za čitanje znakovni jezik. Značenje: Markdown Markdown je lagan znakovni jezik za stvaranje oblikovanog teksta pomoću urednika jednostavnog teksta. John Gruber stvorio je Markdown 2004. godine kao lak za čitanje znakovni jezik. – – – Markizovanje Mislim da je još popularniji od HTML-a, barem u svetu tehnologije. Bio je dostupan na GitHub-u godinama. Java ga je integrisao u svoje JavaDocs u verziji 25. Markdown ograničenja Markdown je neverovatan, ali ima snažna ograničenja. Napisao sam svoju najnoviju knjigu s Markdownom, u tradiciji Doc-as-Code. Iskustvo je bilo tako bolno da sam se zakleo da ga nikada više neću raditi. Ovde je jednostavan izvadak iz mog iskustva pisanja knjiga. Želeo sam da uključim odlomke koda kako bih ilustrirao svoje točke. Međutim, želio sam da budu valjani: kompilirani i testirani. Napisao sam projekat, kompletiran s konfiguracijom izgradnje. Ipak, Markdown ne dozvoljava uključivanje spoljnih datoteka. Morao sam kopirati i umetnuti potrebne odlomke. Još gore, jer pisanje knjige traje neko vrijeme, držao sam verziju ovisnosti ažuriran. Svaki put kada sam to učinio, morao sam kopirati i umetnuti ažurirani kod u svakoj pojavi. Zanimljivo je da dokumentacija usmjerena na programere ima isti slučaj upotrebe. Još jedno široko rasprostranjeno ograničenje je želja da privuče pažnju na stavku. Markdown ne nudi ništa slično. Što je sa drugim jezicima? ne znam; volio bih da je to dio Markdown. Python Markdown aplikacije Iako ima mnogo više, moja konačna tačka će biti o tablicama. Markdown rješava tabele, do točke, što je glave kolona. i , koji nisu podržani. Srećom, HTML je validan Markdown. Međutim, oblikovanje unutar tabele, koda itd., mora se pretvoriti u HTML zajedno s njim. rowspan colspan Ascidoc Asciidoc je rješenje za gore navedena ograničenja. 
 
 
 AsciiDoc je jednostavan jezik za označavanje teksta za pisanje tehničkog sadržaja. Opremljen je semantičkim elementima i opremljen je funkcijama za modularizaciju i ponovnu upotrebu sadržaja. AsciiDoc sadržaj se može sastaviti pomoću uređača teksta, upravljati sistemom kontrole verzija i objavljivati u više formata izlaza. Asciidoc AsciiDoc je jednostavan jezik za označavanje teksta za pisanje tehničkog sadržaja. Opremljen je semantičkim elementima i opremljen je funkcijama za modularizaciju i ponovnu upotrebu sadržaja. AsciiDoc sadržaj se može sastaviti pomoću uređača teksta, upravljati sistemom kontrole verzija i objavljivati u više formata izlaza. Asciidoc Pogledajmo kako Asciidoc rješava ograničenja jedan po jedan: 
 
 
 
 
 
 
 : 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 Uključivanje direktive uvozi sadržaj iz zasebne datoteke ili URL-a u sadržaj trenutnog dokumenta. Kada se obrađuje trenutni dokument, sintaza uključivanja direktive zamjenjuje se sadržajem uključivanja datoteke. Postoje određene izjave na koje ćete možda želeti da skrenete pažnju tako što ćete ih ukloniti iz toka sadržaja i označiti prioritetom. To se zove upozorenja. Ova stranica predstavlja vrste upozorenja koje pruža AsciiDoc, kako dodati upozorenja u dokument i kako ih poboljšati pomoću ikona ili emoji. Spomenuo sam gore kako Asciidoc rješava tri ograničenja s kojima se redovno susrećem u Markdown, ali pruža mnogo više prednosti. Tone funkcija su dostupne. Evo nekoliko njih, koje redovno koristim: 
 
 
 
 
 
 
 
 
 
 : 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 Uz pravi lanac alata, možete generisati HTML iz Asciidoc i objaviti rezultat na GitHub/GitLab Pages. Apache APISIX Hands-on laboratorij Asciidoc ekosustav Alat je samo tako koristan kao njegov okolni ekosistem. Evo nekoliko takvih alata i prednosti: 
 
 
 
 
 
 
 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 Asciidoctor Diagram je skup Asciidoctor proširenja koje omogućuju renderiranje diagrama jednostavnog teksta koji su ugrađeni u dokument Asciidoctor kao dio procesa konverzije Asciidoctor. Zaključak Markdown je svugdje, a ja sam više nego srećan ako zadovoljava vaše potrebe. Imala sam nekoliko iskustava gde to nije ispunilo moja očekivanja: tehnička dokumentacija, radionice, kursevi i pisanje knjiga. Nadam se da vam je ovaj post dao dovoljno argumenata da ga isprobate. To go further: 
 
 
 
 
 Asciidoktor dokumentacija Asciidoctor otkriva.js Asciidoktor dijagram Jekyll AsciiDoc dodatak Prvotno objavljeno na A Java Geek 26. oktobra 2025. Javni geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Ovaj audio je proizveden na originalnom jeziku priče!

Asciidoc: Kada Markdown jednostavno nije rezanje

About Author

KOMENTARI

HANG TAGS

OVAJ ČLANAK JE PREDSTAVLJEN U

Related Stories

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps