当前位置: 首页 > 面试题库 >

使JavaDocs在GitHub和Sonatype Maven存储库中可用

江阳夏
2023-03-14
问题内容

尽管Github为Java开源项目提供了一个不错的家,但与更成熟的开源托管场所相比,仍有一些地方缺少。到目前为止,我已经发现Sonatype为开源项目提供了Maven存储库访问权限,从而解决了一个问题。用户/开发邮件列表有很多解决方案。

但是我现在要解决的一件事是发布自动生成的javadocs进行在线浏览。尽管通过Maven发布源jar可以帮助IDE有所帮助,但我仍然喜欢无需下载或导入项目即可在线浏览javadocs的功能。有人知道在Github托管的项目中实现此目标的好方法吗?(不一定是Github提供的功能,但理想情况下,可以在发布时自动进行操作)


问题答案:

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

  1. 提交发布pom.xml
  2. 将JavaDocs生成到一个.gitignore‘d目录(以便在分支更改时将其保留)。
  3. 结帐gh-pages分支。
  4. 将工作目录中的所有文件替换为JavaDocs复制到的目录中的所有文件
  5. 承诺
  6. 签出原始分支。
  7. 继续发布…

我仅用两天的时间就可以在一些项目中使用Maven,所以这超出了我的能力范围。我很想看到使用现有插件或自定义插件实现的方法。



 类似资料:
  • 我还要做什么吗? 我在shell中使用的命令是: 现在,当我键入时,它显示: 我如何让这个标签出现在GitHub上?我的标签呢?

  • 问题内容: 我正在寻找一种将 javadocs 从我的开源项目(在 Eclipse中 生成)转换为 GitHub MarkDown的方法 ,或者想出一些其他简单的解决方案在 GitHub上 显示我的文档(避开简单地添加目录)。有一个简单的解决方案吗?我可以简单地将 GitHub 指向我的目录吗?还有更优雅的东西吗?我一直在 Google 上 大放异彩 。 问题答案: 我认为用MarkDown制作一

  • 我有一个小型开源图书馆的分叉,我正在github上工作。我想通过maven让其他开发人员可以使用它,但是我不想运行我自己的Nexus服务器,因为它是一个分叉,所以我不能轻松地将它部署到oss.sonatype.org. 我想做的是将它部署到github,这样其他人就可以使用maven访问它。最好的方法是什么?

  • 我开发了几个电子商务网站,最近我注意到了axonframework。我正在考虑如何用AxonFramework实现一个新的电子商务站点。 null 提前谢了。

  • 我想在我新创建的GitHub存储库中添加一个新文件夹,而不安装用于(Mac、Linux和Windows)的Git设置。有可能这样做吗? 当我在不同的系统/机器上工作时,我不能让Git一直陪伴在我身边。我知道如何在上的存储库中直接添加文件。我们也可以创建一个文件夹吗?

  • 我想在GitHub资源库中创建一个文件夹,并想在该文件夹中添加文件。我如何实现这一点?