HotDog- ის ფუნქციონირება, როგორც ჩვეულებრივი ფუნქციონირება, შეიცავს ყველა HTML ტაქსები (მაგაც არ იყო ბევრი ამ დროს), და თქვენ შეგიძლიათ ისწავლოთ მათ და შეამოწმოთ შედეგებს. ერთადერთი უარყოფითი ფუნქციონირება იყო, რომ თქვენ უნდა დააჭირეთ სხვა ღილაკს, რათა დახუროთ ტაქს. Dreamweaver. ეს იყო პირველი WYSIWYG რედაქტორი, და იგი დაუყოვნებლივ გახდა ძალიან პოპულარული. ადამიანები, რომლებიც არ შეხვდა HTML დაიწყო გამოიყენოთ იგი: რაოდენობა ვებგვერდიები გაჩერდა. მე გამოიყენე იგი ერთხელ და შეამოწმოთ გენერირებული HTML. მას შემდეგ, რაც გაიგო, რომ წაიკითხოთ HTML "თეით", მე აღმოაჩინეს, რომ Dreamweaver- ის გენერირებული ღრმად verbose. მე წაიკითხა ჩემი HTML- ის მხრივ ან IDEs- ის დახმარებით. HTML გააგრძელდა, ვიდრე ვებგვერდიები, რათა იყოს ყველაფერს ფორმატში, რომ სერ Berners-Lee არ გსურთ, რომ ეს იქნება. ერთად ვებ ბრაუზერები, ეს გააგრძელდა, რათა იყოს მედიის ვებ პროგრამები. თუმცა, ეს არ დასრულდა. მაშინაც კი, მე შეუზღუდავი, რომ JavaDocs იწვევს HTML. HTML მოწყობილობა. HTML მოწყობილობა. HTML მოწყობილობა. Python დოკუმენტები Ruby დოკუმენტი Rust დისკები მიუხედავად იმისა, რომ თქვენ შეგიძლიათ წაიკითხოთ HTML snippets, , in JavaDocs, წერილი HTML by the line იბორება ძალიან სწრაფად. ეს არის ადვილად შეუწყოს slash დახურვის ტაქტი, ან მიიღოთ თუმცა, ყველაზე დოკუმენტაცია არ სჭირდება სრული ძალა HTML, განსაკუთრებით ის ტიპი, რომელიც მოიცავს უფრო თანამედროვე ვერსია. E. ი. <table> John Gruber და Aaron Swartz შეიმუშეს Markdown 2004 წელს. 
 
 
 Markdown არის მარტივი markup ენა შექმნა ფორმატებული ტექსტი გამოყენებით მარტივი ტექსტის რედაქტორი. John Gruber შექმნა Markdown 2004 წელს, როგორც მარტივი წაიკითხვის markup ენა. და Markdown Markdown არის მარტივი markup ენა შექმნა ფორმატებული ტექსტი გამოყენებით მარტივი ტექსტის რედაქტორი. John Gruber შექმნა Markdown 2004 წელს, როგორც მარტივი წაიკითხვის markup ენა. - - - MarkDown მე ვფიქრობ, რომ ეს კიდევ უფრო პოპულარულია, ვიდრე HTML, მინიმუმ ტექნოლოგიური მსოფლიოში. ეს უკვე ხელმისაწვდომია GitHub- ში წლების განმავლობაში. Java ინტეგრირებული იგი JavaDocs- ში 25 ვერსია. და დღეს, LLM-ები გამოიყენებენ Markdown- ს input და output! Markdown შეზღუდვა Markdown არის შესანიშნავი, მაგრამ მას აქვს ძლიერი შეზღუდვები. მე წაიკითხე ჩემი უახლესი წიგნი Markdown, Doc-as-Code ტრადიციში. გამოცდილება იყო ძალიან ტკივილი, რომ მე დაპირებული ვარ, რომ არ გააკეთოთ იგი კიდევ ერთხელ. აქ არის მარტივი გამოხატვა ჩემი წიგნის წერილის გამოცდილება. მე გინდა, რომ მოიცავს კოდი სექციები, რათა იმიტომ, რომ ჩემი ნაბიჯები. თუმცა, მე გსურთ, რომ ისინი valid: კომპიუტერული და ტესტირება. მე წაიკითხე პროექტი, სრული ერთად build კონფიგურაცია. მიუხედავად იმისა, რომ Markdown არ საშუალებას გაძლევთ მოიცავს გარე ფაილი. მე უნდა გადაიხადოს და შეესაბამება მოთხოვნილი ნაგულისხმები. უკეთესი, იმიტომ, რომ წიგნის შექმნა იღებს ზოგიერთი დრო, მე შენარჩუნება ვერსია დამოკიდებულებები განახლებული. ყოველდღიურად, როდესაც მე გააკეთე, მე უნდა გადაიხადოს და შეესაბამება განახლებული კოდი ყოველდღიურად. საინტერესო, დოკუმენტაცია განკუთვნილია განვითარებლები აქვს იგივე გამოყენების შემთხვევაში. კიდევ ერთი პოპულარული შეზღუდვა არის გსურთ ყურადღებას მოვუწოდოთ ელემენტი. აქ არის სტილის ვარიანტი: Markdown არ გთავაზობთ არაფერი მსგავსი. ამ მიზეზით, რა თქმა უნდა, სხვა ენები? მე არ ვიცი; მე გსურთ, რომ ეს იყო ნაწილი Markdown. Python მარკეტინგი მიუხედავად იმისა, რომ ბევრი მეტია, ჩემი ბოლო მიმოხილვა ტაბლეების შესახებ იქნება. Markdown შეასრულებს ტაბლეებს, სანამ ერთი მიმოხილვა, რომელიც არის ფოლადის სახურავი. ჩემი დღიურში, მე რეგულარულად უნდა და , რომელიც არ არის მხარდაჭერა. ბედნიეროდ, HTML არის valid Markdown. თუმცა, ფორმატიზაციის შიდა მაგიდა, კოდი და ა.შ., უნდა შეცვალოს HTML ერთად მას. rowspan colspan Asciidoc Asciidoc არის გადაწყვეტილება ზემოთ შეზღუდვები. 
 
 
 AsciiDoc არის მარტივი ტექსტის მარკირების ენა ტექნიკური შინაარსი წერილებისთვის. იგი შეფუთულია სამანტიკური ელემენტები და მოწყობილობები მოდულარებს და აღჭურვილობა შინაარსი. AsciiDoc შინაარსი შეიძლება დააკმაყოფილოს ტექსტის რედაქტორი, მართულია ვერსია კონტროლის სისტემაში და გამოქვეყნდა მრავალჯერადი გამოცემის ფორმატებში. Asciidoc AsciiDoc არის მარტივი ტექსტის მარკირების ენა ტექნიკური შინაარსი წერილებისთვის. იგი შეფუთულია სამანტიკური ელემენტები და მოწყობილობები მოდულარებს და აღჭურვილობა შინაარსი. AsciiDoc შინაარსი შეიძლება დააკმაყოფილოს ტექსტის რედაქტორი, მართულია ვერსია კონტროლის სისტემაში და გამოქვეყნდა მრავალჯერადი გამოცემის ფორმატებში. - - - Asciidoc ვხედავ, თუ როგორ 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 შეიცავს დირექტორია ინტეგრირებული შინაარსი სხვადასხვა ფაილი ან URL- ის შინაარსი ამჟამად დოკუმენტის შინაარსი. როდესაც ამჟამად დოკუმენტის დამუშავება, შეიცავს დირექტორიის სინთაქცია შეიცავს ფაილი შინაარსი. ვფიქრობ, რომ შეიცავს დირექტორია, როგორც ფაილი გაფართოება. არსებობს გარკვეული შეტყობინებები, რომ თქვენ შეიძლება გსურთ, რათა შეამოწმოთ, იღებს მათ სინამდვილეში შინაარსი და აღინიშნა მათ უპირატესობა. ეს მოუწოდა შეტყობინებები. ეს გვერდზე გთავაზობთ შეტყობინებები ტიპის 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 სწორი ინსტრუმენტების ქსელის გამოყენებით შეგიძლიათ აწარმოოთ HTML from Asciidoc და გამოქვეყნოთ შედეგს GitHub/GitLab Pages- ში. აქ არის არა მინიმალური მაგალითია, რომელიც აჩვენებს რამდენიმე ფუნქციებს: Apache APISIX Hands-on ლაბორატორიები 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 არის set of Asciidoctor გაფართოების, რომელიც საშუალებას გაძლევთ rendering მარტივი ტექსტური დიაგრამები, რომლებიც შეფუთულია თქვენი Asciidoctor დოკუმენტი, როგორც ნაწილი Asciidoctor კონვერტაციის პროცესი. კონტაქტი Markdown არის ყველა ადგილას, და მე ვიდრე ბედნიერი, თუ ეს შეესაბამება თქვენი საჭიროებებს. მე იყო რამდენიმე გამოცდილება, სადაც ეს არ შეესაბამება ჩემი მოთხოვნებს: ტექნიკური დოკუმენტაცია, სემინარები, კურსები და წიგნები. Asciidoc არის სრულყოფილი ინსტრუმენტი შეავსოს Markdown. მე ვფიქრობ, რომ ეს პოსტი გთავაზობთ საკმარისი arguments, რომ გააკეთოთ. To go further: 
 
 
 
 
 Asciidoctor დოკუმენტაცია ASCIIDOCTOR REVIEW.JS საიტზე Asciidoctor დიაგრამა Jekyll AsciiDoc პლაჟი ორიგინალური გამოქვეყნდა A Java Geek on ოქტომბერი 26, 2025 Java Geek კავშირი

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

ეს აუდიო დამზადებულია სიუჟეტის ორიგინალურ ენაზე!

Asciidoc: როდესაც Markdown უბრალოდ არ ჭრის იგი

About Author

კომენტარები

დაკიდეთ ტეგები

ეს სტატია იყო წარმოდგენილი

Related Stories

Karma: Love on the Blockchain and the Gamification of Helping Others

Media Moves: Katy Koob Joins Dastan to Drive Decentralized Growth

How to Not Lose 97.8% of Your Newsletter Subscribers

Unhinged and Overstrained: The Mind of a Harassed Woman

Karma: Love on the Blockchain and the Gamification of Helping Others

Media Moves: Katy Koob Joins Dastan to Drive Decentralized Growth

How to Not Lose 97.8% of Your Newsletter Subscribers

Unhinged and Overstrained: The Mind of a Harassed Woman

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps