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