An article titled _Prohomelab_index

#

tags: [moc, prohomelab]

#

✍️ Overview — Prohomelab

#

Two-level structure (Hugo page bundle):

• <Category>/ — branch bundle, category page on the site
  • _index.md — category frontmatter, “Category Index (ProHomelab)” template (still being refined)
  • featured.jpg/png — category cover
  • <article slug>/ — leaf bundle, the article itself
    • index.md — “Article Draft (ProHomelab)” template, must be named index.md
    • featured.png — article cover
    • 0.png, 1.png… — remaining screenshots

Categories are sections like Proxmox/, Opnsense/, Selfhosting/, Traefik/, Single Sign On/, etc. One category groups several articles on the same topic.

Creating a new article

#

1. If the category doesn’t exist yet — create the <Category>/ folder and inside it _index.md (constant frontmatter — copied from an existing category, not from the template).
2. Inside the category, create a subfolder <article slug>/.
3. Inside it — create a note based on the Article Draft (ProHomelab) template, rename the file to index.md.
4. Put the cover in the same place as featured.png/.jpg.

Exporting to the site

#

When the article is ready (draft: false) — copy the entire article subfolder (index.md + images) into content/self-hosting/<slug>/ of the Hugo repository. The category’s _index.md is touched separately and rarely — only when creating a new category.

Full article catalog

#

By cover

#

There is no real multi-stage status (idea → draft → review) in the frontmatter, and there won’t be — only a binary draft: true/false (the draft column in the table above). Track the “in progress but still rough” stage through the draft text itself or the publication checklist below.

✅ Publication checklist

#

• categories/series/tags set
• draft: false before uploading to the site

Future ideas (backlog)

#