Skip to content

Latest commit

 

History

History
24 lines (19 loc) · 1.8 KB

README.md

File metadata and controls

24 lines (19 loc) · 1.8 KB

Starter templates

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.

Why there's no archetypes/ folder

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.