使用GitHub,Sonatype Maven repo提供JavaDocs

尽管Github为Java开源项目提供了一个很好的家,但与更成熟的开源托管位置相比,仍有一些东西仍然缺失.到目前为止,我已经发现Sonatype为开源项目提供了Maven存储库访问,这解决了一个问题; 用户/ dev邮件列表有很多解决方案.

但我现在要解决的一件事是发布自动生成的javadocs用于在线浏览.虽然通过Maven发布源代码jar对IDE有所帮助,但我仍然希望能够在线浏览javadoc而无需下载或导入项目.对于在Github上托管的项目,是否有人知道实现这一目标的好方法？(不一定是Github提供的东西,但理想情况下,当发布被削减时可以自动化的东西)

1> Jake Wharton..：

---

GitHub提供gh-pages位于您的repo分支中的静态HTML文件http://your_username.github.com/your_repo/.从理论上讲,Maven可以做到以下几点:

提交发布pom.xml.

将JavaDocs生成到.gitignore'd目录(因此它将在分支更改中保留).

结帐gh-pages分支.

将工作目录中的所有文件替换为JavaDocs复制到的目录中的文件

承诺

签出原始分支.

继续发布......

我只有两天时间使用Maven来完成我的一些项目,所以这超出了我的能力范围.我很想看到现有的插件或自定义插件实现这一点.

---

仅供参考,我现在正在使用http://khuxtable.github.com/wagon-gitsite/,它可以自动将站点部署到`gh-pages`分支.

---

我很抱歉这个偏离主题但出于安全考虑,GitHub不允许在`gh-pages`网络服务器中进行框架.但是,javadocs视图包含3个帧.你找到了解决方法吗？

2> Gewthen..：

---

现在有一个Maven插件可以将目录推送到githib上的特定分支:http://github.com/github/maven-plugins .