feat: drafts

[rochacbruno]

As a blog writer I want to be able to create drafts by simply

cd myblog

touch drafts/mydraft.md
# OR
marmite --new "my draft" --draft

• Drafts are posts that lives on input_folder/drafts
• Inside drafts folder there is a media/ that symlinks the content_dir/media if exists

When building the site, if --drafts is passed, then those posts are collected.

[neiesc]

Hi @rochacbruno , can I help this?

[rochacbruno]

Sure @neiesc

And I am thinking again, and we can do it simpler.

---

How to make a draft

To make a draft simply name your file with draft- prefix as in draft-2025-01-01-blog-post.md
or name the file whatever you want and put draft: true in the front matter.

How draft is set?

When draft is detected from name or front matter, the Content draft attribute is set to True, this by default is set to False.

How to preview a draft?

Run marmite with --preview argument and then the files matching draft: true will be included in the document collection and the prefix draft- if found in filename will be removed from final URL.

How to publish drafts to a different stream?

Set draftstream to True in the config and marmite will render a drafts.html and all drafts will be published to that stream, that stream will show the drafts fully rendered.

NOTES: Drafts are not included in the search index, drafts.html are excluded from search in the robots.txt, drafts stream does not generate feeds.

How to publish a draft?

• Run marmite input output --publish slug (this will simply rename the file or flip the draft: attribute)
• Or manually rename the file or remove the draft: true attribute from it

[neiesc]

perfect thx, I`ll do this