The FileVault documentation lives as Markdown files in src/site/markdown
such that it easy to view e.g. from GitHub. Alternatively the Maven site plugin can be used to build and deploy a web site as follows:
From the reactor build the site with javadoc:
$ mvn site
Review the site at target/site
Deploy the site to http://jackrabbit.apache.org/filevault-package-maven-plugin
using:
$ mvn site-deploy
Finally review the site at http://jackrabbit.apache.org/filevault-package-maven-plugin-archives/${project.version}/index.html
.
Note: To skip the final commit use -Dscmpublish.skipCheckin=true
. You can then review all pending changes in target/scmpublish-checkout
and follow up with svn commit
manually.
Note: Every committer should be able to deploy the site. No fiddling with credentials needed since deployment is done via svn commit to https://svn.apache.org/repos/asf/jackrabbit/site/live/filevault-package-maven-plugin
.
Switch to release tag
Adjust the links to the site versions in src/site/site.xml
(don't yet commit)
Deploy the site of the released version with mvn site-deploy
Copy the released site version to the root site:
$ svn rm https://svn.apache.org/repos/asf/jackrabbit/site/live/filevault-package-maven-plugin -m "Remove old website version" $ svn cp https://svn.apache.org/repos/asf/jackrabbit/site/live/filevault-package-maven-plugin-archives/${project.version} \ https://svn.apache.org/repos/asf/jackrabbit/site/live/filevault-package-maven-plugin -m "Add new website version"
Switch to master branch
Commit the changes from 1.
Deploy the snapshot site