1,使用Swagger2Markup、asciidoctor-maven-plugin和asciidoctorj-pdf插件生成PDF格式的API文档中文问题解决html
二、asciidoc最佳实践-maven插件git
三、Asciidoctor Maven插件使用github
四、Asciidoctor Maven 插件apache
AsciiDoc是一种轻量型的标记语言,语法简单易用,兼容Markdown的同时,提供了更丰富的标记功能,很是适用于写电子文档,Asciidoctor Maven 插件是一种官方支持的方式,它能够在 Apache Maven 构建过程当中使用 Asciidoctor 转化你的 AsciiDoc文档(.adoc)
文件格式转化为PDF、HTML、EPUB等文件格式。segmentfault
POM.xmruby
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <maven.compiler.encoding>UTF-8</maven.compiler.encoding> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> <asciidoctorj.version>1.5.6</asciidoctorj.version> <asciidoctorj.diagram.version>1.5.4.1</asciidoctorj.diagram.version> <jruby.version>1.7.26</jruby.version> </properties>
执行mvn命令maven
mvn clean process-asciidoc