I am always thrilled to receive pull requests, and I do my best to process them as fast as possible. Not sure if that typo is worth a pull request? Do it! I appreciate it.
If your pull request is not accepted on the first try, don't be discouraged. We can work together to improve the PR so it can be accepted.
All original contributions are licensed under the ASL - Apache License, version 2.0 or later, or, if another license is specified as governing the file or directory being modified, such other license.
All contributions are subject to the Developer Certificate of Origin (DCO). The DCO text is also included verbatim in dco.txt.
Take a moment to check that an issue doesn't already exist for the behavior or output you're seeing. If it does, please add a quick thumbs up reaction. This will help prioritize the most common problems and requests.
If there isn't an issue yet, open one! Be as specific as you can, and include the tool version.
Two maven tasks that will format code and sort imports to reduce whitespace/ordering churn in PRs and commits.
Make sure to run ./mvnw package
or ./mvnw process-sources
before you commit, and everything will be formatted correctly.
This project also has a .editorconfig
file that defines expected behavior for whitespace and line endings.
Most IDEs have an editorconfig plugin that will automatically format your code to match these settings.
If you want your IDE to format your code for you, the files in the src/ide-config
directory can help.
Open the Preferences window, and then navigate to Java -> Code Style -> Formatter.
- Click Import and then select
src/ide-config/eclipse-format.xml
. - Choose the
ttrpg-convert-cli
profile.
Next navigate to Java -> Code Style -> Organize Imports. Click Import and select src/ide-config/eclipse.importorder
.
A .vscode directory is included with the project that contains formatting and import settings.
Install Java. This project requires Java 17.
- Use maven:
./mvnw install
- Use the Quarkus CLI:
quarkus build
To test with actual/live data, clone 5eTools and/or PF2eTools into a sources directory:
mkdir sources
cd sources
git clone --depth 1 https://github.com/5etools-mirror-1/5etools-mirror-1.github.io.git
git clone --depth 1 https://github.com/Pf2eToolsOrg/Pf2eTools.git
- build css:
./mvnw sass-cli:run
- watch:
./mvnw sass-cli:watch
- package:
./mvnw sass-cli:run -Dsass.watch
I recommend that you sign your commits, always. For everything.
If you use SSH with Git, I have some tips that might help.