Document draft posts and future posts

[paulrobinson]

When working on drafts of posts it would be good to be able to commit them to the source repo without them going live. That way you have version control and can collaborate with others during the creation process.

This could be achieved by treating posts named "draft-<title>" as drafts (as opposed to files name "-<title" which are not drafts). Drafts will be generated in Quarkus dev mode (thus viewable during local development), but not on the published site.

Does this sound useful? I could have a go at contributing this feature.

[ia3andy]

@paulrobinson you are right that it's not documented but you can do it:

---
...
draft: true
---

then quarkus dev -Dsite.draft=true to show them in dev mode (they won't be visible in prod mode)

[paulrobinson]

Even better! Maybe my contribution is to document it...

[ia3andy]

Here is the place: https://github.com/quarkiverse/quarkus-roq/tree/main/blog/content/docs/getting-started

Using -Dsite.future=true will disable the date-based cut-off, most of the time you need both together, they can also be in the config:

config/application.properties

%dev.site.future=true
%dev.site.draft=true