Skip to content
PDF

Contributing

Here are some ways that you can help contribute to this project.

New ideas or Bug Reports

Need something? Found a bug? Or just have a brilliant idea? Head to the Issues and create new one.

Contributing Code

If you know Java then take a look at open issues and create a pull request.

Do the following to build the code:

git clone https://github.com/Bundabrg/GeyserLink
cd GeyserLink
mvn clean package

Contributing Documentation

If you can help improve the documentation it would be highly appreciated. Have a look under the docs folder for the existing documentation.

The documentation is built using mkdocs. You can set up a hot-build dev environment that will auto-refresh changes as they are made.

Requirements

  • python3
  • pip3
  • npm (only if changing themes)

Install dependencies by running:

pip3 install -r requirements.txt

Dev Environment

To start a http document server on http://127.0.0.1:8000 execute:

mkdocs serve

Change PDF Theme

Edit the PDF theme under docs/theme/pdf. Rebuild by doing the following:

cd docs/theme/pdf
npm install
npm run build-compressed

This will update pdf.css under docs/css/pdf.css. Rebuilding the docs will now use the new theme.


Last update: