Maven 2 GroovyDoc作为Maven插件

是否有一个maven插件可以利用，最好是作为报告

我想这应该是一个值得一看的地方，但是文档是古老的（1.0，而当前的版本是1.3），而且GMaven插件没有任何适合您的mojo：

mvn help:describe -DgroupId=org.codehaus.gmaven -DartifactId=gmaven-plugin

此插件有9个目标：

groovy:compile
说明：编译 Groovy源代码

groovy:console
说明：发射 Groovy GUI控制台

groovy:execute
描述：执行 Groovy脚本

groovy:generateSubs
说明： 从Groovy生成Java存根 来源

groovy:generateTestStubs
描述：从生成Java存根 Groovy测试源代码

groovy:help
说明：显示 gmaven插件的帮助信息。
呼叫

mvn groovy:help-Ddetail=true-Dgoal=

以显示参数详细信息

groovy:providers
说明： 显示有关Groovy的信息 运行时提供程序 已配置和选择

groovy:shell
说明：发射 Groovy外壳（又称groovysh）

groovy:testCompile
说明： 编译Groovy测试源代码

---

那么，有人有指向maven groovydoc插件的指针吗？谷歌没有提出任何有意义的东西。

我认为Groovydoc没有Maven插件，但你可以使用。GMaven采用了一种不同的方法：

generateStubs

为Groovy类创建Java存根，然后由常规的Javadoc插件处理。然而，我不知道这种方法在实践中的效果如何，特别是因为GMaven的较新版本使用了Groovy编译器的存根生成器，它不是为了生成正确的Javadoc而创建的。

尽管没有任何与Groovydoc maven兼容的插件，使用Maven为groovy类生成文档非常容易。这是我们在项目中的做法：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-antrun-plugin</artifactId>
  <version>1.7</version>
  <executions>
    <execution>
      <id>groovydoc</id>
      <phase>site</phase>
      <goals>
        <goal>run</goal>
      </goals>
      <configuration>
        <target>
          <taskdef name="groovydoc"
            classname="org.codehaus.groovy.ant.Groovydoc" 
            classpathref="maven.compile.classpath"
          />
          <groovydoc destdir="${project.reporting.outputDirectory}/groovydoc"
            sourcepath="${basedir}/src/main/groovy" use="true"
            windowtitle="${project.name}"
            doctitle="${project.name}"
          >
            <link packages="java.,org.xml.,javax.,org.xml."
              href="http://download.oracle.com/javase/6/docs/api" />
            <link packages="org.apache.tools.ant." 
              href="http://evgeny-goldin.org/javadoc/ant/api" />
            <link packages="org.junit.,junit.framework."
              href="http://kentbeck.github.com/junit/javadoc/latest" />
            <link packages="groovy.,org.codehaus.groovy."
              href="http://groovy.codehaus.org/api/" />
            <link packages="org.codehaus.gmaven."
              href="http://evgeny-goldin.org/javadoc/gmaven" />
          </groovydoc>
        </target>
      </configuration>
    </execution>
  </executions>
</plugin>

org.apache.maven.plugins
maven antrun插件
1.7
groovydoc
网站
跑

Groovydoc Maven插件为我工作：

你想要gmavenplus插件：

org.codehaus.gmavenplus
gmavenplus插件
1.5
org.codehaus.groovy
groovy all
2.4.7

---

然后运行：

mvn gplus:generateStubs gplus:groovydoc

我会接受它，因为它似乎可以工作，即使我不再需要它。为什么你不再需要它？你找到另一种解决方案了吗？GMaven的作者不久前试图重写插件（）。其中的一个目标是为GroovyDoc提供支持，但在撰写本文时，它还没有发布。@sworis很高兴知道，thanks@sean-patrick floyd我计划在这个月发布测试版。我现在正在建立Maven存储库。对我来说太晚了，但希望它能帮助其他人。谢谢它正在为我生成空文档。我还缺什么吗？@ParameshKorrakuti你在跑什么目标？您确实将javadocs/groovydocs添加到了实际的源文件中，对吗？@SeanPatrickFloyd添加了groovydics并执行

mvn gplus:generateStubs gplus:groovydoc

命令。它正在创建带有空文档的框架。@ParameshKorrakuti我不确定如果您在代码中实际编写了javadoc sytle注释，并且正在使用如上所示的maven插件，为什么会有空文档。如果你分享到github或类似网站的链接，我很乐意四处看看，看看我是否能帮上忙。

<project>
  <build>
    <plugins>
      <plugin>
        <groupId>org.codehaus.gmavenplus</groupId>
        <artifactId>gmavenplus-plugin</artifactId>
        <version>1.5</version>
      </plugin>
    </plugins>
  </build>
  <dependencies>
    <dependency>
      <groupId>org.codehaus.groovy</groupId>
      <artifactId>groovy-all</artifactId>
      <!-- any version of Groovy \>= 1.5.0 (except 1.6 RC 1) should work here -->
      <version>2.4.7</version>
    </dependency>
  </dependencies>
</project>