我已经在GitHub上创建了一个存储库,并使用Netbeans 7.3成功地向其中推送了几个类。
然而,我想把这些类的javadoc生成的HTML文档推送到GitHub,以便它们显示为项目页面(在GitHub上)的访问者可浏览的页面。
我在网上看到(少量)指南提供了使用命令行实现这一目标的方法(例如这个博客),但它们似乎需要控制台。
是否有一种优雅的方式来使用Netbeans接口来生成JavaDoc页面,然后将它们推送到GitHub上的项目的高页面分支,以便文档与实际类文件的每次推送保持最新?
是否有一种优雅的方法来使用Netbeans接口来生成JavaDoc页
Netbeans在幕后使用Apache Ant,所以你应该在你的项目目录中找到一个build.xml
。
build.xml
导入了更大的蚂蚁脚本nbproject/build-impl.xml
,但提供了许多钩子,让您可以在更大的脚本中实现的默认操作中添加行为。
例如,如果您正在创建一个jar,您可以在build.xml
中添加一个目标,该目标在创建jar之前生成javadoc:
<target name="-pre-jar">
<javadoc sourcepath="${source.dir}" destdir="apidocs"/>
</target>
如果你想要一个更复杂的自动化级别,你应该考虑Maven或Gradle:它们让你生成任何你想要的工件,生成一个站点,将站点部署到远程服务器。