This directory contains hugo documentation to be published in Github pages.
hugo server -D
This will serve the docs on http://localhost:1313.
Changes to the main
branch will be deployed automatically with Github actions.
Javadoc are not checked-in to the Github repository. They are generated on the fly by Github actions when the docs are updated. To view locally, run the following:
# note that the 'compile' in the following command is necessary for Javadoc to detect the module structure
./mvnw clean compile javadoc:javadoc javadoc:aggregate
rm -r ./docs/static/api
mv ./target/site/apidocs ./docs/static/api
Github pages are in the /client_java/
folder, so we link to /client_java/api
rather than /api
.
To make JavaDoc work locally, create a link:
mkdir ./docs/static/client_java
ln -s ../api ./docs/static/client_java/api
The docs use the Geekdocs theme. The theme is checked in to Github in the ./docs/themes/hugo-geekdoc/
folder. To update Geekdocs, remove the current folder and create a new one with the latest release. There are no local modifications in ./docs/themes/hugo-geekdoc/
.
Here's how the initial docs/
folder was set up:
hugo new site docs
cd docs/
mkdir -p themes/hugo-geekdoc/
curl -L https://github.com/thegeeklab/hugo-geekdoc/releases/download/v0.41.1/hugo-geekdoc.tar.gz | tar -xz -C themes/hugo-geekdoc/ --strip-components=1
Create the initial hugo.toml
file as described in https://geekdocs.de/usage/getting-started/.