Tinkering about moving from JBake to Roq

[Riduidel]

Hello all,
long ago, I started a lifestream project (accumulating 1000 Goodreads books, 10000 links and roughly 1000 Wordpress articles). I currently have one generator using JBake, but it is too damn slow. So I envision migrating to Roq (because I'm quite sure I'll have massive performance gains). However, my content isn't in src/main/resources but in target\site\input (because it come from generated content that I don't want to add to my GitHub commits).
So, how can I change the generation source?
Is there somewhere a reference about frontmatter content to use?

[ia3andy]

That's awesome!

Even if Roq is already in a pretty good shape, there still might be things I haven't thought of... or gaps in the doc. Please, let me know if you need help or are struggling figuring something out!

For your question, this should help: https://docs.quarkiverse.io/quarkus-roq/dev/index.html#quarkus-roq_quarkus-roq-dir

[Riduidel]

oh thanks!
It would be good to have

• The initial template list used by Roq
• The list of frontmatter variables used by Roq

documented somewhere

[ia3andy]

By default, Roq is using title, layout, image, pagination other variables are for plugins or templates.
Are you talking about the default-theme? We could probably add some documentation for it.

[Riduidel]

Yeah, it would very cool (an easy trick would be to define an annotation for frontmatter variables, this way each template defining variables would add this annotation and would have documentation generated.

[Riduidel]

What are values for layout ?

[ia3andy]

If you are using the default theme, here are the available layouts (use the filename without the extension):
https://github.com/quarkiverse/quarkus-roq/tree/main/roq-theme/default/src/main/resources/templates/theme-layouts/roq-default

You can also add your own layouts in your templates/layouts and use the name in layout

[Riduidel]

Furthermore, I have a strange bug (which may be related to my pre-existing frontmatter)

2025-03-23 20:46:27,595 INFO  [io.qua.dep.dev.IsolatedDevModeMain] (main) Attempting to start live reload endpoint to recover from previous Quarkus startup failure
2025-03-23 20:46:28,135 ERROR [io.qua.dep.dev.IsolatedDevModeMain] (main) Failed to start quarkus: java.lang.RuntimeException: io.quarkus.builder.BuildException: Build failure: Build failed due to errors
        [error]: Build step io.quarkus.qute.deployment.QuteProcessor#processTemplateErrors threw an exception: io.quarkus.qute.TemplateException: Found incorrect expressions (2):
        [1] partials/roq-series.html:3:1 - {cdi:series}: @Named bean not found for [series]
        [2] partials/roq-series.html:4:1 - {cdi:series.get(page)}: @Named bean not found for [series]

Have you got any idea where it could come from?

[ia3andy]

You are probably using a template which use the https://quarkus.io/extensions/io.quarkiverse.roq/quarkus-roq-plugin-series/ without the plugin in your pom.xml (I guess)? Did you start from the Roq blog?

[Riduidel]

Oh, and I think it would be a good idea to have a way (whatever it is) to debug processing

[ia3andy]

In Dev-Mode, if you have Roq sources opened, you can easily debug. Another option is to enabled debug logs:
quarkus.log.category."io.quarkiverse.roq.frontmatter.deployment".level=DEBUG