使用場(chǎng)景

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

asciidoc的優(yōu)點(diǎn)

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

支持復(fù)雜豐富的純文本書寫格式。

一個(gè)完善的文本處理和轉(zhuǎn)換工具鏈，可以轉(zhuǎn)換為HTML,ePub,PDF,DocBook等.

安裝和使用

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

說明：安裝軟件后的x64代表操作系統(tǒng)的位數(shù)是64位的，x86代表32位操作系統(tǒng)，再下載軟件的時(shí)候要根據(jù)自己電腦時(shí)間的操作系統(tǒng)進(jìn)行選擇

本人電腦是64位操作系統(tǒng)這里選擇

?

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

• 方法一：點(diǎn)擊左下角的window開始圖標(biāo)——windows系統(tǒng)——命令提示符

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

?

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

? ? ?gem install asciidoctor

? ? ?命令符窗口出現(xiàn)以下提示，表示安裝成功

2. 把a(bǔ)doc轉(zhuǎn)換為pdf，需要安裝asciidoctor-pdf. 在命令符窗口輸入以下字符，直接按enter

? ? ?gem install asciidoctor-pdf

? ???命令符窗口出現(xiàn)以下提示，表示安裝成功

3.驗(yàn)證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

?命令符窗口出現(xiàn)以下提示

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

6. 點(diǎn)擊菜單上 文件—首選項(xiàng)—設(shè)置，取消如下圖勾選

7.關(guān)閉預(yù)覽，重新打開就可以看見右側(cè)預(yù)覽區(qū)域背景成白色的；

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。