Document draft feature of the example themes

[DanielRuf]

Currently both example themes have a filter:

omitWhen(function (item) return item.draft or item.path == "site.lua" end),

So we can use the draft field in the frontmatter.
Maybe it makes sense to either document:

• how users can implement a draft feature in their own theme
• or what configuration options both example themes provide

[alunya-cat]

I don't know why, but that draft option didn't work for me, so I had to figure it out myself—well, not me, but Gemini, because I have no idea how to write code—and in the end, I decided that all .md files starting with an underscore should be ignored from the list of posts and also from feed.xml (feed.etlua also had to be modified).

Even though they are ignored from the list of posts, their .html files are still generated (e.g., https://alunya.cat/alan/_test.html).

[DanielRuf]

@alunya-cat hm, interesting.

Can you share, what your frontmatter looked like and which exact release / version you use?
Because I can not reproduce that.

[user@LAPTOP-D94G30R6 microblog]$ ./luasmith blog
[user@LAPTOP-D94G30R6 microblog]$ cat content/draft.md
---
title: Title of the post
description: Short description of the post (for the Atom feed).
date: 2025-04-22
draft: true
---
# Post heading
Content goes here. Note you can [link to other posts](foobar.md).

## abc
[user@LAPTOP-D94G30R6 microblog]$ file out/draft.html
out/draft.html: cannot open `out/draft.html' (No such file or directory)
[user@LAPTOP-D94G30R6 microblog]$ file out/index.html
out/index.html: HTML document, ASCII text

[DanielRuf]

Maybe the example in my comment helps you to see, what setting in the frontmatter actually works.

To be exact, the code does not check / evaluate the value (only if it is set), so these variants also work:

draft: 0
draft: foo
draft: 1
draft: false
draft: no

But draft: true at least makes the most sense for my head, so I chose this variant.

Any frontmatter without a draft: line and the bundled blog theme will yield this:

WARN: Broken link from "draft-2.html" to "foobar.html"

[alunya-cat]

@DanielRuf I can confirm that everything is working as expected and that I'm retarded. In my personal theme.lua I deleted the item.draft on omitWhen(function (item) return item.draft or item.path == "site.lua" end),.

[DanielRuf]

@alunya-cat no problem. As developer with 15+ years in the industry I also still learn new things every day and I definitely do not know everything.

Great, that it works now for you!
I also saw at alunya-cat/alunya-cat.github.io@d8817e1#diff-32fc1b49580705751eb7ee3aa32c100b4a17efcae72c201727409313cb26aa44, that you have implemented some footnote support.

Do you want to share that with us at #50?
A first working solution should be fine and can be further refined or improved if needed. It doesn't have to be perfect, a working solution is better than none.