Roq 2.2.0

Highlights:

  • The Code theme: a minimal, developer-focused theme with Tailwind v4, dark mode, syntax highlighting, TOC, and share links
  • no-index-all frontmatter 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 lastmod source with faster git lookup
  • Share links rewritten: configurable per-page with share-xxx keys, Twitter migrated to X, LinkedIn added
  • sort virtual 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 =true syntax (e.g. sectanchors=true)
  • AsciiDoc base dir and safe mode now configurable
  • asciidoc-l10n plugin renamed from asciidoc-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)