මම සෑහෙන කාලෙකට පෙර, HotDog (Pro) යන මෘදුකාංගය මත මම HTML ඉගෙන ගත්තා. ඒ කාලේ What You See Is What You Get හැකියාවන් වැනි දෙයක් තිබුණේ නැහැ. කෙසේ වෙතත්, HotDog පුදුමාකාර විශේෂාංගයක් තිබුණා: මෙවලම් පෙට්ටියේ සියලුම HTML ටැග් (මේ වෙලාවේ එතරම් ගණනක් තිබුණේ නැත) බොත්තම් ලෙස, ඔබ ඔවුන් මත ක්ලික් කිරීම හා ප්රතිඵල බලන්න ඔවුන් ඉගෙන ගත හැකි විය. ඉන්පසු Dreamweaver ආවා. එය පළමු WYSIWYG සංස්කරණය විය, එය වහාම ඉතා ජනප්රිය විය. HTML ගැන කිසිදු අදහසක් නැති අය එය භාවිතා කිරීමට පටන් ගත්තේය: වෙබ් අඩවි සංඛ්යාව skyrocketed. මම එය එක් වරක් භාවිතා කළ අතර නිර්මාණය කරන ලද HTML බැලුවා. HTML "මැත්තෙන්" ලිවීමට ඉගෙන ගත් පසු, මම එය Dreamweaver විසින් නිර්මාණය කරන ලදී විවෘතව verboose. වේගයෙන් ඉදිරියට වසර පහක්. HTML වෙබ් අඩවි වලට වඩා සර් බර්නර්ස්-ලි සිහින දකින්නට නොලැබෙන පුළුල් ආකෘතියක් බවට පත් විය. වෙබ් බ්රවුසරයන් සමඟ එක්ව, එය වෙබ් යෙදුම් සඳහා මැදිරිය බවට පත් විය. කෙසේ වෙතත්, එය එතනින් නැවතුනේ නැත. HTML ආකෘතිය HTML ආකෘතිය HTML ආකෘතිය Python Docstring භාවිතා කිරීම රොබෝ RDOC නිහතමානී HTML සංකේතය භාවිතා කළහොත්, , in JavaDocs, writing HTML by the line becomes a bore pretty quickly.It is easy to miss a slash in the closing tag, or to get a slash in the closing tag. කෙසේ වෙතත්, බොහෝ ලේඛන HTML සම්පූර්ණ ශක්තිය අවශ්ය නොවේ, විශේෂයෙන් එහි වඩා නවීන සංස්කරණය විසින් ගෙන ඇති ආකාරය. ජේ <table> මෙම ගැටලුව විසඳීමට, ජෝන් Gruber සහ Aaron Swartz 2004 දී Markdown සොයා ගත්තේය. 
 
 
 Markdown යනු සරල ලේඛන සංස්කරණය කිරීම සඳහා සරල ලේඛන සංස්කරණය කිරීම සඳහා සරල markup language ය.John Gruber විසින් 2004 දී Markdown නිර්මාණය කරන ලදී. Markdown Markdown යනු සරල ලේඛන සංස්කරණය කිරීම සඳහා සරල ලේඛන සංස්කරණය කිරීම සඳහා සරල markup language ය.John Gruber විසින් 2004 දී Markdown නිර්මාණය කරන ලදී. Markdown මම හිතන්නේ එය HTML ට වඩා ජනප්රිය බව, අවම වශයෙන් තාක්ෂණය ලෝකයේ. එය GitHub දී වසර ගණනාවක් තිස්සේ ලබා ගත හැකි විය. ජාවා එය JavaDocs අනුවාදය 25 ඇතුළත් කර ඇත. Markdown සීමාව Markdown පුදුමයක්, නමුත් එය ශක්තිමත් සීමාවන් ඇත. මම Markdown සමඟ මගේ නවතම පොත ලිව්වා, Doc-as-Code සම්ප්රදාය. මෙන්න මගේ පොත් ලිවීමේ අත්දැකීම් වලින් සරල පිටපතක්.මම මගේ ප්රශ්න විස්තර කිරීම සඳහා කේත පිටපතක් ඉදිරිපත් කිරීමට කැමැත්තෙමි.එහෙත්, මම අවශ්ය විය යුත්තේ ඒවා සැබෑ විය යුතුය: compiled and tested.I wrote a project, complete with a build configuration. කෙසේ වෙතත්, Markdown අභ්යන්තර ගොනු ඇතුළත් කිරීමට ඉඩ නොදෙයි. මම අවශ්ය ප්රතිපත්තිය සකස් කළ යුතුය. වඩාත් නරක, පොතක් ලිවීමට යම් කාලයක් ගත වන නිසා, මම ආකර්ෂණය අනුවාදය යාවත්කාලීන තබා ඇත. සෑම අවස්ථාවකදීම මම, මම සෑම අවස්ථාවකදී යාවත්කාලීන කේතය සකස් කළ යුතුය. තවත් පුළුල් සීමාව වන්නේ අංගයක් ගැන අවධානය යොමු කිරීමට අවශ්ය වීමයි.එසේ ස්ටයිල් විකල්පයක්: එවැනි දෙයක් නොලැබේ.මේ හේතුව නිසා, වෙනත් භාෂා ගැන කුමක්ද?මම දන්නේ නැහැ; මම කැමතියි එය Markdown කොටසක් විය හැකි. Python Markdown ගැන තවත් බොහෝ ඇත, මගේ අවසාන මාතෘකාව ටැබ්ල ගැන වනු ඇත. Markdown ටැබ්ලයක්, එක් ප්රශ්නය දක්වා, වන තැපැල් මාතෘකාව වේ. මගේ බ්ලොග් සටහන්, මම නිතර අවශ්ය සහ අවාසනාවකට, HTML සැබෑ Markdown වේ.එහෙත්, ටැබ්ලයේ ඇතුළත ආකෘති, කේතය, ආදිය, එය සමඟම HTML බවට පරිවර්තනය කළ යුතුය. rowspan colspan ඇසිඩොක් Asciidoc ඉහත සීමාවන් සඳහා විසඳුමක් වේ. 
 
 
 AsciiDoc යනු තාක්ෂණික අන්තර්ගතය ලිවීම සඳහා සරල පෙළ අකුරු භාෂාවක් වන අතර එය සංඥානීය අමුද්රව්යයන් සහිතව සහ අන්තර්ගතය modularize කිරීම සහ නැවත භාවිතා කිරීම සඳහා විශේෂාංග සහිතව සකස් කර ඇත.AsciiDoc අන්තර්ගතය Text Editor භාවිතා කිරීමෙන් සකස් කළ හැකිය, Version Control System හි කළමනාකරණය කළ හැකිය, සහ විවිධ ප්රතිඵල ප්රමාණයන් වෙත ප්රකාශ කළ හැකිය. ඇසිඩොක් AsciiDoc යනු තාක්ෂණික අන්තර්ගතය ලිවීම සඳහා සරල පෙළ අකුරු භාෂාවක් වන අතර එය සංඥානීය අමුද්රව්යයන් සහිතව සහ අන්තර්ගතය modularize කිරීම සහ නැවත භාවිතා කිරීම සඳහා විශේෂාංග සහිතව සකස් කර ඇත.AsciiDoc අන්තර්ගතය Text Editor භාවිතා කිරීමෙන් සකස් කළ හැකිය, Version Control System හි කළමනාකරණය කළ හැකිය, සහ විවිධ ප්රතිඵල ප්රමාණයන් වෙත ප්රකාශ කළ හැකිය. - - ඇසිඩොක් අපි බලමු Asciidoc සීමාවන් එක් එක් විසඳුම් කරන්නේ කෙසේද: 
 
 
 
 
 
 
 : 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 An include directive imports content from a separate file or URL into the contents 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 extender.එසේ නම්, ඔබගේ අදහස නම්, ඔබගේ අදහස අනුව, ඔබගේ අදහස අනුව, ඔබගේ අදහස අනුව, ඔබගේ අදහස අනුව, ඔබගේ අදහස අනුව. ඔබ අවධානය යොමු කිරීමට අවශ්ය සමහර ප්රකාශයන් අන්තර්ගත ප්රවාහයෙන් ඉවත් කිරීමෙන් සහ ප්රමුඛතාවයන් සමඟ ඒවා ලියාපදිංචි කිරීමෙන් ඇත. මෙම ප්රකාශයන් හඳුන්වනු ලැබේ. මෙම පිටුව ඔබට උපදෙස් වර්ග AsciiDoc සපයයි, ඔබගේ ලේඛනයට උපදෙස් එකතු කරන්නේ කෙසේද, සහ සංකේතයන් හෝ emojis භාවිතා කිරීමෙන් ඒවා වැඩි දියුණු කරන්නේ කෙසේද. මම ඉහත ලැයිස්තුගත කර ඇති Asciidoc මා නිතරම Markdown තුළ මුහුණ දෙන්නේ සීමා තුනක් විසඳන ආකාරය, නමුත් එය තවත් බොහෝ ප්රතිලාභ ලබා දෙයි. 
 
 
 
 
 
 
 
 
 
 : 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 නිවැරදි toolchain සමඟ, ඔබ Asciidoc සිට HTML නිර්මාණය කළ හැකි අතර, එහි ප්රතිඵල GitHub / GitLab Pages මත ප්රකාශ කළ හැකිය. Apache APISIX Hands-on Lab එක Asciidoc ආර්ථික පද්ධතිය මෙවලමක් එහි වටා ඇති පරිසර පද්ධතිය මෙන් පමණක් ප්රයෝජනවත් වේ. මෙන්න එවැනි මෙවලම් සහ ප්රතිලාභ කිහිපයක්: 
 
 
 
 
 
 
 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 යනු Asciidoctor පරිවර්තනය ක්රියාවලියක කොටසක් ලෙස ඔබේ AsciiDoc ලේඛනයට ඇතුළත් වන සරල ලේඛන ප්රදර්ශන ප්රදර්ශනය කිරීමට ඉඩ සලසන Asciidoctor ආකෘති එකතුවකි. ප් රතිඵල Markdown හැමතැනම තියෙනවා, ඔබගේ අවශ්යතා සපුරාලුවහොත් මම සතුටුයි.මම මගේ බලාපොරොත්තුවන්ට ගැලපෙන්නේ නැති අත්දැකීම් කිහිපයක් තිබුණා: තාක්ෂණික ලියාපදිංචිය, වැඩසටහන්, පාඨමාලා සහ පොත් ලිවීම.Asciidoc Markdown හි දෝෂ ඉටු කිරීමට පරිපූර්ණ මෙවලමක් වේ. මෙම ලිපිය ඔබට උත්සාහ කිරීමට ප්රමාණවත් සාධක ලබා දී ඇති බව මම බලාපොරොත්තු වෙනවා. To go further: 
 
 
 
 
 Asciidoctor ලේඛන ප් රදර්ශනය reveal.js ඇසිඩොක්ටර් Diagram Jekyll AsciiDoc ප්ලගිනය A Java Geek ඔක්තෝබර් 26th, 2025 හි මුල් පිටුව ජාවා Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

මෙම ශ්‍රව්‍යය කතාවේ මුල් භාෂාවෙන් නිෂ්පාදනය කර ඇත!

Asciidoc: When Markdown Just Isn't Cutting It (ඇස්සිඩොක්)

About Author

අදහස්

ටැග් එල්ලන්න

මෙම ලිපිය ඉදිරිපත් කරන ලදී

Related Stories

The Spacecoin Writing Contest by Spacecoin and HackerNoon: Round 1 ප්රතිඵල

Technology's 24 Most Important Social Networks for Content Distribution

My Six Years of Writing on HackerNoon in Numbers and Pictures

2025 Could See Tonga Become the Web3 Tech Hub of the Pacific

The Spacecoin Writing Contest by Spacecoin and HackerNoon: Round 1 ප්රතිඵල

Technology's 24 Most Important Social Networks for Content Distribution

My Six Years of Writing on HackerNoon in Numbers and Pictures

2025 Could See Tonga Become the Web3 Tech Hub of the Pacific

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps