This project uses Quarkus, the Supersonic Subatomic Java Framework.

If you want to learn more about Quarkus, please visit its website: https://quarkus.io/.

You can run your application in dev mode that enables live coding using:

./mvnw quarkus:dev

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

The application can be packaged using:

./mvnw package

It produces the quarkus-run.jar file in the target/quarkus-app/ directory. Be aware that it’s not an über-jar as the dependencies are copied into the target/quarkus-app/lib/ directory.

The application is now runnable using java -jar target/quarkus-app/quarkus-run.jar.

If you want to build an über-jar, execute the following command:

./mvnw package -Dquarkus.package.jar.type=uber-jar

The application, packaged as an über-jar, is now runnable using java -jar target/*-runner.jar.

You can create a native executable using:

./mvnw package -Dnative

Or, if you don't have GraalVM installed, you can run the native executable build in a container using:

./mvnw package -Dnative -Dquarkus.native.container-build=true

You can then execute your native executable with: ./target/roq-with-blog-1.0.0-SNAPSHOT-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.

• Roq (guide): Hello, world! I’m Roq — a fun little SSG (Static Site Generator) with a Java soul and Quarkus energy.

This project is configured for automatic deployment to GitHub Pages via GitHub Actions.

Setup Requirements:

1. Enable GitHub Pages in your repository settings
2. Set Pages source to "Deploy from a branch" with branch gh-pages and folder / (root)
3. Push to the master branch to trigger deployment

Workflow Details:

• Location: .github/workflows/deploy.yml
• Triggers: Push to master or manual workflow dispatch
• Output: Static site deployed to gh-pages branch

The workflow automatically builds the site and deploys it to the gh-pages branch whenever changes are pushed to the master branch.

Pull requests from trusted contributors automatically get preview deployments at:

https://pesse.github.io/pejsam-website/preview/pr-<PR-NUMBER>/

Features:

• Automatic preview build and deployment when PR is opened or updated
• Preview URL posted as a comment on the PR
• Automatic cleanup when PR is closed
• Trusted contributor restriction for security
• Isolated /preview/ directory prevents accidental deletions

See docs/PR_PREVIEW.md for detailed documentation.