Everything you need to start a new piece of content, in one place. Copy the file you need, fill it in, open a pull request.
| File | Copy it to | For |
|---|---|---|
author.md |
content/authors/<your-slug>/_index.md |
Your author profile — needed once, before your first article. |
post.md |
draft/<your-article-slug>/index.md |
An article. Start here — rename it to index.md. |
post.adoc |
draft/<your-article-slug>/index.adoc |
An article, in AsciiDoc. Same frontmatter as post.md; use it when you want block captions, source callouts, admonitions or spanning tables. |
categories.md |
(nowhere — read it) | The list of categories already in use. Reuse one where it fits. |
page.md |
content/pages/... |
A static site page. Maintainers only, not article contributors. |
board-member.md |
content/pages/board/<slug>.md |
An Advisory Board member. Maintainers only. |
event.yaml |
data/events/<event-slug>.yaml |
A conference, workshop or other one-off for /calendar/. (A JUG's own meetups need nothing here — they sync from the group's calendar.) |
ad.md |
content/ads/<ad-slug>/index.md |
A sponsored banner on the home page, creative in the same folder. Maintainers only — one folder per campaign, not per sponsor. |
Full walkthrough: How To Submit Your Next Article On Foojay.io.
Hugo's archetypes/ exists to feed hugo new content .... Nothing here uses
that command — contributors copy a file and open a PR — so keeping a second set
of starter files under a Hugo-specific name meant two places to look and two
places to keep in step. These templates are the single source now.