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