The second Roq plugin is for redirecting your page to a better place!
We introduced a way to declare aliases in FrontMatter. It is now easy create redirections to your blog posts!
2024, Oct 09 — 1 minute(s) readRoq allows to easily create a static website or blog using Quarkus super-powers.
In this video, we initialise the repository and set up GitHub Pages, discover a few basics and create a new blog post.
👉 Install the Quarkus CLI.
🚀 Generate the starter app using the CLI (you can change the name), or via code.quarkus.io
quarkus create app roq-with-blog -x=io.quarkiverse.roq:quarkus-roq
🎮 start dev-mode:
cd roq-with-blog
quarkus dev
💻 Your site is available on localhost for dev
🍾 Time to Roq the basics!
☀️ If you found some happiness with Roq, please support us:
Knowing that you don’t need to learn Quarkus or Java to use Roq, consider the following advantages:
Quarkus-based: Since Roq is just a very thin layer on top of Quarkus, it ensures that the tool stays up to date and benefits from the robust support provided by the Quarkus ecosystem.
For everyone: It is very easy to use with any level of knowledge. You can start with an existing theme (as a dependency) and only write Markdown or Asciidoc content, or customize everything.
Reproducibility Across Platforms: Unlike some other SSG, Roq offers better reproducibility across multiple platforms, ensuring more consistent and predictable results when building or deploying.
Easy to maintain: Managing dependencies and updates is easier with Roq thanks to Maven and Gradle. Other systems such as Go or Ruby can be difficult to maintain and make reproducible across environments.
Speed: Roq is using Quarkus for dev and build. Quarkus is famous for being supersonic and subatomic, with one example showing a Roq site build in just 20 milliseconds, greatly reducing build times compared to traditional generators.
Type Safety (via Qute templates): Roq leverages Quarkus Qute’s type safety in templates and posts, making it easier to handle links, data injection, and other dynamic content with confidence.
Local Development Experience: Roq provides a smoother local development experience without the need to "test in production," as is often necessary with other SSGs due to its difficulties in running locally.
Code Completion (coming soon): Thanks to Qute, Roq offers code completion, which is beneficial when working in templates, helping to reduce errors and improve developer productivity.
You may find a few interesting things in there, here are 3 random articles from our blog.
We introduced a way to declare aliases in FrontMatter. It is now easy create redirections to your blog posts!
2024, Oct 09 — 1 minute(s) readOne of the most overlooked aspects when choosing a Static Site Generator (SSG) is how easy it is to keep your project up to date. Many developers have struggled with complex upgrade processes, dependency conflicts, and breaking changes when using traditional SSGs like Jekyll or Hugo.
2025, Mar 24 — 1 minute(s) readRoq SSG introduces a new feature that allows you to hide or show draft and future articles using simple Quarkus configurations. This update gives developers greater control over which content is visible, improving content management and workflow.
2024, Sep 19 — 1 minute(s) read