什么是 Asciidoc

• 1. 什么是 Asciidoc
• • 1.1. luikore
  • 1.2. weakish
  • 1.3. xx
  • 1.4. nolanzz

1. 什么是 Asciidoc

1.1. luikore

類似于 wikipedia 編輯語法的文檔生成 / 寫作語言輸出格式支持 html, epub(當然 epub 就是包著的 html…), pdf(當然 pdf 就是打印…), deck.js, docbook, man, latex 等可以用于注釋用來生成文檔, 例如 doclet, rdoc 都可以選擇 asciidoc 安裝容易, 源文件易讀, 功能比 markdown 豐富很多, 容易擴展 (markdown 的解析器很難擴展, 擴展了也經常有莫名奇妙的 bug, 但 asciidoc 的語法設計就很容易擴展, asciidoctor 的擴展點也非常簡單)

1.2. weakish

有些人覺得 DocBook XML 不直觀, 因此開發了 AsciiDoc. 不過 AsciiDoc 的語法很復雜, 當然比 DocBook XML 簡短, 但未必簡單。就好像 Perl 比 Java 簡短多了, 但未必比 Java 簡單。不過貌似 DocBook XML 不像 Java 一樣有很多強大的 IDE, 所以還是有不少人偏好 AsciiDoc. 最初是用 Python 實現的。后來又有人用 Ruby 實現了, 叫 Asciidoctor.Asciidoctor 一邊在文檔里抨擊 MarkDown 有太多方言, 互相不兼容, 一邊又改了 AsciiDoc 的語法。(不僅加了很多新語法, 還去掉了一些語法, 各 MarkDown 方言至少極少去掉始祖 MarkDown 的語法。)

1.3. xx

不回答是什么, 在 java 社區里, 使用 asciidoc 的還是很多的, 包括 spring 社區的很多項目都采用 asciidoc 來寫文檔。

有個使用 java 編寫的 asciidoc gui 也挺不錯

asciidocfx/AsciidocFX · GitHub

1.4. nolanzz

簡單看了下文檔, 感覺可以解決 2 個 markdown 的痛點:

原生支持修改圖片大小
表格支持合并單元格

總結

以上是生活随笔為你收集整理的什么是 Asciidoc的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。