asciidoc html java_如何使用AsciiDoclet从.java文件中的javadoc注释生成asciidoc文件
我是asciidoc的新手.我想在
java文件中從注釋的
javadoc(asciidoc格式)生成HTML文檔.
例如java文件
/**
* = Asciidoclet
*
* Sample comments that include `source code`.
*
* [source,java]
* --
* public class Asciidoclet extends Doclet {
* private final Asciidoctor asciidoctor = Asciidoctor.Factory.create();
*
* @SuppressWarnings("UnusedDeclaration")
* public static boolean start(RootDoc rootDoc) {
* new Asciidoclet().render(rootDoc);
* return Standard.start(rootDoc);
* }
* }
* --
*
* @author https://github.com/johncarl81[John Ericksen]
*/
public class Asciidoclet extends Doclet {
}
我可以從.ad文件生成html文件,但我不知道如何從javadoc生成.ad(或任何asciidoc格式文件).
所以我想生成.ad(asciidoc文件),我用它來生成使用asciidoctor-maven-plugin的html文檔. asciidoctor-maven-plugin將檢查sourceDirectory中的.ad文件并在outputDirectory中生成html文件.
org.asciidoctor
asciidoctor-maven-plugin
${asciidoctor.version}
output-html
generate-resources
process-asciidoc
asciidocs
asciidocs-output
html
book
org.apache.maven.plugins
maven-javadoc-plugin
2.9
1.7
org.asciidoctor.Asciidoclet
org.asciidoctor
asciidoclet
${asciidoclet.version}
src/main/java/overview.adoc
--base-dir ${project.basedir}
--attribute "name=${project.name}"
--attribute "version=${project.version}"
--attribute "title-link=http://example.com[${project.name} ${project.version}]"
依賴
1.5.0
1.5.0
org.asciidoctor
asciidoctorj
1.5.2
我提到asciidoclet,但我無法得到任何有用的信息.所有示例項目都用于生成html,pdf,epub等.
謝謝…
更新
我改變了我的maven-javadoc-plugin配置,如下所示并執行了mvn org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar但是它生成正常的html java文件應該生成.adoc文件.
誰能幫助我,我做錯了什么?謝謝…
org.apache.maven.plugins
maven-javadoc-plugin
2.9
javadoc-jar
package
jar
true
commons-cli:*
1.7
org.asciidoctor.Asciidoclet
org.asciidoctor
asciidoclet
${asciidoclet.version}
src/main/java/overview.adoc
--base-dir ${project.basedir}
--attribute "name=${project.name}"
--attribute "version=${project.version}"
--attribute "title-link=http://example.com[${project.name} ${project.version}]"
我正在使用以下依賴項.
總結
以上是生活随笔為你收集整理的asciidoc html java_如何使用AsciiDoclet从.java文件中的javadoc注释生成asciidoc文件的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: ECC加密算法C简单实现
- 下一篇: 腾讯微搭小程序获取微信用户信息