Although Github provides a nice home for Java open source projects, there are some things that are still missing compared to more mature open source hosting places. I have so far figured out that Sonatype offers Maven repository access for open source projects, which solves one issue; and there are many solutions for user/dev mailing lists.
But one thing I am now trying to resolve is that of publishing automatically generated javadocs for online browsing. Although publishing source jars via Maven helps a bit with IDEs, I still like ability to browse javadocs online without downloading or importing a project. Does anyone know of a good way to achieve this, for projects hosted at Github? (need not be something Github offers, but ideally something that can be automated to happen when release is cut)
GitHub serves static HTML files that are in the gh-pages branch of your repo at http://your_username.github.com/your_repo/. In theory, Maven could be made to do the following:
- Commit the release
pom.xml. - Generate the JavaDocs to a
.gitignore'd directory (so it would be preserved across branch changes). - Checkout the
gh-pagesbranch. - Replace all of the files in the working directory with that of the directory the JavaDocs were copied to
- Commit
- Checkout the original branch.
- Continue with release...
I'm only two days in to using Maven for a few of my projects so this is way beyond my capabilities. I'd be eager to see this implemented either with existing plugins or a custom plugin.
There is now a Maven plugin that can push a directory to a particular branch on githib at: http://github.com/github/maven-plugins.
You can use a shell script to do the git checkout/add/commit/checkout/push as Jake Wharton suggested, and configure Ant or Gradle to run the shell script after it generates the javadoc. I'm not sure this would work with Maven. Here's an example shell script.
You can use the github pages, creating a static web site then you put your javadoc in a directory and commmit to gh-pages branch.
see the Git hub pages, its simple and useful.
see
http://readwrite.com/2013/11/27/github-pages-explained#awesm=~oII5EQELsqV6S7
来源：https://stackoverflow.com/questions/3939595/making-javadocs-available-with-github-sonatype-maven-repo