Roq 2.2.0
Oct 14, 2026
The Code theme, no-index-all key, HTML sitemap, configurable share links, and AsciiDoc improvements.
Highlights:
- The Code theme: a minimal, developer-focused theme with Tailwind v4, dark mode, syntax highlighting, TOC, and share links
no-index-allfrontmatter key: opt a page out of sitemap, llms.txt, search index, and robots in one go- HTML sitemap for visitors alongside the XML sitemap
- Configurable sitemap
lastmodsource with faster git lookup - Share links rewritten: configurable per-page with
share-xxxkeys, Twitter migrated to X, LinkedIn added sortvirtual method for sorting collections in templates- Dots preserved in URL placeholders (
:name,:slug) for versioned URLs like/releases/roq-2.1.0/ <html lang>from frontmatter instead of hardcoded "en"- Boolean AsciiDoc attributes with
=truesyntax (e.g.sectanchors=true) - AsciiDoc base dir and safe mode now configurable
asciidoc-l10nplugin renamed fromasciidoc-jruby-l10n(relocation POMs provided)- Nested AsciiDoc includes processing fixed
- Editor fixes: branch tracking for git sync, refresh race prevention, absolute image path handling
Migration guide
| Applies to | Before | After | Action |
|---|---|---|---|
| Theme users | brand template global (brand.get(...), brand.entrySet()) |
social:share(site.data) and social:contact(site.data) |
Update share link templates |
| Theme users | Share links always shown | Configurable with share-xxx: false to disable per platform |
Good to know |
| Theme users | social-twitter |
Still works (mapped to X) | No action needed |
| Theme developers | Web resources in web/ |
Moved to web/app/ |
Update resource paths |
| Plugin users | quarkus-roq-plugin-asciidoc-jruby-l10n |
quarkus-roq-plugin-asciidoc-l10n |
Update dependency (relocation POM handles the transition) |