AsciiDoc的安装和简单使用

使用场景

适用于多人协作的多个页面的文档编写，并且能生成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.关闭预览，重新打开就可以看见右侧预览区域背景成白色的；