Update README.md
1 file changed
tree: 5e0162ebed5f4d373b6054be31614889d8739a69
  1. docs/
  2. src/
  3. .asf.yaml
  4. .gitattributes
  5. .gitignore
  6. .htaccess
  7. LICENSE.txt
  8. pom.xml
  9. README.md
README.md

db-jdo-site

Sources for the Apache DB JDO web site

The website is mirrored under https://apache.github.io/db-jdo-site/

This repository contains the JDO website source.

  • The ASCIIDOC sources can be found in src/main/asciidoc
  • The website menu is defined in src/main/template
  • The converter for migrating the old html files to asciidoc can be found in src/main/java

How to build the website:

  • Use git pull to get the latest version from the repository.
  • Use git branch MyBranchName and git checkout MyBranchName to create a branch and check it out.
  • Adapt the asciidoc files in src/main/asciidoc or the website menu in src/main/template
  • Call mvn clean compile. This generates html files in target/site.
  • Copy all files from target/site into the docs folder, do not forget subfolders.
  • Verify the generated website by viewing it locally with a web browser.
  • Commit changes with git commit -m 'my commit message' .
  • Push changes to the repository with git push.
  • Go to Github.com and create a PR for your branch
  • Once the PR is accepted, the changes should be visible on the website (you may have to refresh the browser).

How to add javadoc

  • Create the javadoc jar (e.g. jdo-api-3.2-javadoc.jar) in the db-jdo repository by calling mvn clean install -Papache-release in the api submodule.
  • Create a new folder under docs e.g. docs/api32.
  • Copy the javadocs jar info the new folder: e.g. cp jdo-api-3.2-javadoc.jar docs/api32.
  • Create a new subfolder docs/api32/jdo-api-3.2-javadoc
  • Unpack the javadoc jar in the subfolder
  • Edit javadoc.adoc under src/main/asciidoc and create a new section ‘JDO 3.2 javadoc’.
  • Add two links: one referring index.html in the subfolder and one referring the javadoc jar.

TODO

  • If you find any issues please provide a PR or ticket here