Swagger使用（三）—— 解决swagger2markup生成的离线pdf接口文档中的乱码问题

上一篇：Swagger使用（二）—— 利用swagger2markup生成离线的html和pdf接口文档 

        生成的pdf接口文档之所以会有乱码问题，是由于asciidoctorj-pdf包中使用的字体不全，有些中文字体无法正常显示。所以，要解决这个问题我们只需要将asciidoctorj-pdf包中的字体替换掉就可以了。有两个方法，下面来看一下详细的步骤：

目录

一、直接使用已经处理好的asciidoctorj-pdf包

1、下载已处理好的asciidoctorj-pdf包

2、将asciidoctorj-pdf包安装到自己的maven仓库

3、在pom中修改asciidoctorj-pdf包的属性配置

二、自己替换字体来处理asciidoctorj-pdf包

1、查看asciidoctorj-pdf包的主题配置文件和字体文件

2、查看default-theme.yml文件

3、下载所需要的字体

4、将下载的字体放到asciidoctorj-pdf包的fonts目录下

---

一、直接使用已经处理好的asciidoctorj-pdf包

如果闲麻烦没有时间自己搞的，可以直接去csdn下载资源的地方下载一个已经处理好的asciidoctorj-pdf包来用，然后再将其用mvn install命令安装到自己的maven仓库即可。

1、下载已处理好的asciidoctorj-pdf包

下载地址：https://download.csdn.net/download/lihuaijun/10313631

2、将asciidoctorj-pdf包安装到自己的maven仓库

使用cmd执行命令：mvn install:install-file -Dfile=E:\asciidoctorj-pdf-1.5.0-alpha-zh.16.jar -DgroupId=org.asciidoctor -DartifactId=asciidoctorj-pdf -Dversion=1.5.0-alpha-zh.16 -Dpackaging=jar -DgeneratePom=true

Dfile参数指向下载的asciidoctorj-pdf包地址，记得修改一下，其他可以保持不变。

3、在pom中修改asciidoctorj-pdf包的属性配置

由于别人处理的asciidoctorj-pdf包是通过新添加一个主题配置文件来实现的，所以我们需要在asciidoctorj-pdf包的配置属性中将默认的主题配置文件修改成新添加的主题配置文件。如下：

二、自己替换字体来处理asciidoctorj-pdf包

1、查看asciidoctorj-pdf包的主题配置文件和字体文件

2、查看default-theme.yml文件

3、下载所需要的字体

之前使用的是Noto Serif，现在我们使用KaiGenGothicCN字体，这个字体可以去网上去下载，都是.ttf后缀的字体文件，需要下载四个分别是粗体、斜体、粗斜体、正体。

推荐下载地址：字客网

4、将下载的字体放到asciidoctorj-pdf包的fonts目录下