使用場景

適用于多人協作的多個頁面的文檔編寫，并且能生成PDF或者docx格式方便閱讀

asciidoc的優點

支持include外部的.adoc文件,這樣就可以分章節寫書。比如寫復雜的需求文檔，寫一個操作手冊或語言總結。

支持復雜豐富的純文本書寫格式。

一個完善的文本處理和轉換工具鏈，可以轉換為HTML,ePub,PDF,DocBook等.

安裝和使用

1.下載Ruby的Windows版本.
ruby Windows安裝包

說明：安裝軟件后的x64代表操作系統的位數是64位的，x86代表32位操作系統，再下載軟件的時候要根據自己電腦時間的操作系統進行選擇

本人電腦是64位操作系統這里選擇

?

ruby軟件安裝成功后打開命令提示符；

• 方法一：點擊左下角的window開始圖標——windows系統——命令提示符

• 方法二：點擊左下角的搜索框，輸入cmd-點擊命令提示符

?

1. 安裝asciidoctor,安裝完Ruby之后新打開一個命令行窗口輸入以下字符，然后按enter

? ? ?gem install asciidoctor

? ? ?命令符窗口出現以下提示，表示安裝成功

2. 把adoc轉換為pdf，需要安裝asciidoctor-pdf. 在命令符窗口輸入以下字符，直接按enter

? ? ?gem install asciidoctor-pdf

? ???命令符窗口出現以下提示，表示安裝成功

3.驗證asciidoctor-pdf安裝完成，在命令符窗口輸入以下字符，直接按enter
C:\Users\apple>asciidoctor-pdf -v
Asciidoctor PDF 1.5.3 using Asciidoctor 2.0.10 [https://asciidoctor.org]
Runtime Environment (ruby 2.6.6p146 (2020-03-31 revision 67876) [x64-mingw32]) (lc:GBK fs:GBK in:UTF-8 ex:UTF-8)

4. 安裝源碼語法高亮支持；在命令符窗口輸入以下字符，直接按enter

gem install rouge

?命令符窗口出現以下提示

5. 安裝VSCode的asciidoc文檔擴展編輯支持，打開Visaual studio code軟件，再擴展里搜索AsciiDoc插件,點擊安裝，作者是asciidoctor.

6. 點擊菜單上 文件—首選項—設置，取消如下圖勾選

7.關閉預覽，重新打開就可以看見右側預覽區域背景成白色的；

總結

以上是生活随笔為你收集整理的AsciiDoc的安装和简单使用的全部內容，希望文章能夠幫你解決所遇到的問題。

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