我是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}]"

我正在使用以下依赖项.