Repository navigation
Move the website from Jekyll to Quarkus Roq - #135
Merged
Merged
Conversation
The site is now a Quarkus Roq project: content/ (the AsciiDoc posts and pages, unchanged apart from page titles and descriptions), templates/, public/ and config/. It builds with ./mvnw and the Roq GitHub Action, so Ruby, Bundler and the pinned Jekyll 4.0 / Ruby 2.6 toolchain are gone. Posts are rendered by Asciidoctor, as before. Every address the Jekyll site published still works: posts stay at /blog/<name>/, the feed at /feed.xml, the certification page and its zips at their old paths. Old blog page numbers beyond the new last page and /components.html redirect. The design keeps the brand (logo colours, Open Sans, the rye field) and adds a dark theme, a phone layout, a sitemap, robots.txt, canonical and Open Graph tags, structured data and per-page descriptions. The usage band shows each project's own light and dark logo (Quarkus and WildFly from commonhaus/artwork, Open Liberty from openliberty.io). Bylines show the author's photo, served from the site instead of Gravatar. Fonts are self-hosted; jQuery, Font Awesome and the 19 MB of hero image variants are gone. Red Hat analytics stays, loaded async. Deployment is unchanged: the workflow builds the Antora docs and the site and pushes them to main. The docs build first, because the Roq build leaves a node_modules/ in the repository root that npm would otherwise install Antora into. The on-demand workflow is folded into the main one as workflow_dispatch, and a daily run publishes future-dated posts.
Member
|
I wanted to do this as well, but I sure as hell wouldn't be able to improve the website design the way you did! :-) |
Ladicek
approved these changes
Oct 13, 2026
Ladicek
left a comment
Member
There was a problem hiding this comment.
I didn't review the changes themselves, but built the site locally and inspected the most important pages. LGTM!
radcortez
approved these changes
Oct 13, 2026
Member
Author
|
I'll leave the merge to you. If all works, merge will deploy the new version |
|
Ooooooh, it's beautiful. |
Member
|
It is! I'm not super thrilled about the weird violet gradient on the title image on the title page, but other than that, perfect! :-) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This moves smallrye.io from Jekyll to Quarkus Roq. The build is now
./mvnwand the Roq GitHub Action, replacing Ruby, Bundler and the pinned Jekyll 4.0 / Ruby 2.6 toolchain. The content stays as it is.What stays the same
content/posts/). Roq reads their:page-*headers directly, and they are rendered by Asciidoctor, as before.mainbranch, apart from/docs/and/assets/, against the new build. All of them exist. Posts stay at/blog/<name>/, the feed at/feed.xml, and the Health 3.1 certification page and its zips at their old paths. Old blog page numbers past the new last page (/blog/page/10/to/17/) and/components.htmlredirect./docs/exactly as before.main, using the same GitHub App token. No repository settings need to change.What changes
robots.txt, canonical and Open Graph tags, and schema.org data. Each post's synopsis becomes its meta description. Links use the canonicalsmallrye.io;_config.ymlsaidwww, which redirects.workflow_dispatch. A daily scheduled run publishes future-dated posts on their date, and skips the push when nothing changed.public/images/authors/(listed indata/authors.yml), so readers' browsers never contact Gravatar. An author without a photo gets their initial.Lighthouse (mobile)
Old: live smallrye.io. New: this branch, served locally.
Most of the remaining page weight is the Red Hat analytics script.
Screenshots
The usage band in both themes:
The blog list in the dark theme:
A post in the dark theme:
Trying it
The README covers the layout of the project and how to write a post. The header format for posts is the same as before.
Not yet verified
main: both are unchanged from the current workflow, but this PR's CI run is their first test with the new build. The PR run builds without deploying.