From b171d00ceba32cd9372f2c748884474584e21f456445d12363c184deed81ded1 Mon Sep 17 00:00:00 2001 From: Nicholas Johnson <> Date: Fri, 18 Sep 2026 00:00:00 +0000 Subject: Add an example site The theme shipped no runnable site and documented no configuration, so every setting it reads had to be discovered by reading the templates, and there was nothing to build against when changing them. The build failure that unset RSS limits caused would have been caught immediately by an example site. The two configuration files are the separate website and capsule configurations the readme asks for, annotated with what each setting does and which are optional. The content demonstrates entries, tags, references, a standalone page and the front matter keys that control them. Also ignore build output, which no rule previously covered. Co-Authored-By: Claude Opus 5 --- exampleSite/content/entry/welcome.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 exampleSite/content/entry/welcome.md (limited to 'exampleSite/content/entry/welcome.md') diff --git a/exampleSite/content/entry/welcome.md b/exampleSite/content/entry/welcome.md new file mode 100644 index 0000000..614a490 --- /dev/null +++ b/exampleSite/content/entry/welcome.md @@ -0,0 +1,26 @@ +--- +title: "Welcome To The Journal Theme" +date: 2026-01-15T09:00:00+0000 +draft: false +tags: ["journal", "hugo"] +--- + +This entry is written once and published twice: as HTML for the web and +as gemtext for the [Gemini protocol](https://geminiprotocol.net/). + +By default, links are collected into a reference section at the foot of +the gemtext version, because gemtext has no inline links. The same entry +keeps its inline links in the HTML version. Set "makerefs" to false in +an entry's front matter to render links in place on both instead. + +## What The Theme Gives You + +* An entry list on the homepage, and one per tag +* Atom feeds for the homepage, each tag and the tag list +* Publication date and reading time on every entry +* Optional audio versions of entries +* No JavaScript and no analytics + +Which Markdown features survive the trip to gemtext, and which are +flattened or dropped, is documented in full in the +[gemtext compatibility reference guide](https://git.nicholasjohnson.ch/hugo-theme-journal/tree/GEMTEXT-COMPATIBILITY-REFERENCE-GUIDE.md). -- cgit v1.2.3