aboutsummaryrefslogtreecommitdiff
path: root/exampleSite/content/entry/writing-entries.md
diff options
context:
space:
mode:
authorNicholas Johnson <>2026-09-18 00:00:00 +0000
committerNicholas Johnson <>2026-09-19 20:39:04 -0400
commitb171d00ceba32cd9372f2c748884474584e21f456445d12363c184deed81ded1 (patch)
treefc9a12d15337d4e55005d7758d30bb6b9eef7930e322c617331df509ebe58e3a /exampleSite/content/entry/writing-entries.md
parent0703a10e2c97bdce5fe8c2d83ce977b015bc68b2368eb43c3b3bdbc21d588155 (diff)
downloadhugo-theme-journal-b171d00ceba32cd9372f2c748884474584e21f456445d12363c184deed81ded1.tar.gz
hugo-theme-journal-b171d00ceba32cd9372f2c748884474584e21f456445d12363c184deed81ded1.zip
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 <noreply@anthropic.com>
Diffstat (limited to 'exampleSite/content/entry/writing-entries.md')
-rw-r--r--exampleSite/content/entry/writing-entries.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/exampleSite/content/entry/writing-entries.md b/exampleSite/content/entry/writing-entries.md
new file mode 100644
index 0000000..8184c32
--- /dev/null
+++ b/exampleSite/content/entry/writing-entries.md
@@ -0,0 +1,36 @@
+---
+title: "Writing Entries"
+date: 2026-02-20T14:30:00+0000
+draft: false
+tags: ["journal"]
+---
+
+Create an entry with the "entry" archetype:
+
+```sh
+hugo new --kind entry entry/my-first-entry.md
+```
+
+Entries are Markdown. Headings, lists, blockquotes and preformatted
+blocks all survive into gemtext:
+
+> Gemtext has no nesting and no inline emphasis, so the theme flattens
+> what it can and drops the rest.
+
+Emphasis is a good example. *Italics* and **bold** are rendered on the
+web, and their asterisks are removed from the gemtext, so write in a way
+that still reads without them.
+
+## Adding An Audio Version
+
+Make the entry a page bundle and put the audio file beside it:
+
+```plaintext
+content/entry/my-first-entry/
+├── index.md
+└── my-first-entry.opus
+```
+
+The website gets an audio player and the capsule gets a download link.
+Include more than one encoding and browsers pick the format they
+support, while the capsule only links the most preferred one.