Chapters
  1. Overview
  2. Installation
  3. Presets
  4. Post types, series and code
  5. Custom settings
  6. Members and comments
  7. Navigation
  8. Translations
  9. Demo content
  10. Customising
  11. Self-hosting
  12. Troubleshooting
  13. Changelog

Troubleshooting

Problems you might hit while setting up Logbuch, and how to fix them.

Find your problem by its symptom. If it isn't here, write to [email protected] and send a description and a link to your site.

Releases, incidents and series

A release shows no version mark

Cause: the theme takes the version from the start of the title, up to a colon. A title without a version, or with the version somewhere else, shows no mark.

Fix: write the version first, then a colon, then the title: v1.4.0: Links that expire or 1.4.0: Links that expire. Check that the post has the template Changelog in its settings and the internal tag #changelog in Tags, so it looks like a release on its own page and in every list.

The sections of a release show as plain headings

Cause: the theme only recognises a heading whose whole text is one of the names of Keep a Changelog, such as Added, Changed or Fixed, with a list right after it. A heading such as "New features", "Added:" or "Fixes" stays a plain heading, and so does a section with a paragraph between the heading and its list.

Fix: name the heading exactly Added, Changed, Deprecated, Removed, Fixed or Security, or the same name in German, Spanish, French or Italian (Translations). Put the bulleted list directly below it, and anything else you want to say above the heading or after the list.

The incident timeline isn't drawn

Cause: the theme draws the first list in the post whose items all start with a time and whose first item also has a date. If one item starts with words, or the first item has a time but no date, the list stays a plain list. Started, Resolved and Duration stay empty for the same reason.

Fix: start the first item with the date and the time, 2026-11-06 04:00 restic fails., and every other item with at least a time, 09:52 Identified: Disk full. An item with a time only takes the date of the item before it. Write dates as 2026-11-06 and times on the 24-hour clock. For Resolved and Duration, the last item needs the status, 11:10 Resolved: Backups run again. Check that the post has the template Incident and the internal tag #incident.

A series isn't recognised

The chapters show no series rail, the tag page lists posts instead of the course, or the home page layout Tutorials first shows the latest entries without course cards.

Cause: the theme treats a tag as a series when its slug starts with the setting Series prefix, series- by default. The tag's name doesn't count, so a tag named "A tiny HTTP server" with the slug a-tiny-http-server isn't a series.

Fix: open Tags → the tag → Slug and change it to start with the prefix, for example series-tiny-http-server. If you changed Series prefix, every series tag needs the new prefix instead. The chapters follow each other by publication date, so change a post's publish date to move it in the series.

A reader's progress in a series is gone

Cause: progress stays in the browser where the reader ticked "Remember the chapters I have read". Another browser, another device or a private window doesn't have it. A private window forgets it when it closes. Unticking the box deletes it, and so does clearing the browser's data for your site.

Fix: there's nothing to fix on your site, because nothing is stored there. The reader ticks the box again in the browser they read in, and a chapter counts as read once they reach its end.

Code isn't highlighted

Cause: the language isn't one of the 29 that Logbuch highlights, or it's misspelt in the code card's language field. The first word in that field is the language, and everything after it is an option, so file=src/router.ts ts reads file=src/router.ts as the language. A reader's browser without JavaScript also shows plain code.

Fix: open the code card and write the language first, then the options: ts file=src/router.ts. Check the spelling against the list of languages. A language that isn't on the list stays plain code with its band and copy button.

The note on old posts is missing, or shows where you don't want it

Cause: the note "Written 3 years ago. Versions and commands may have moved on." appears on posts, releases, incidents and TIL notes that are older than the setting Age warning, 2 years by default. Letters and pages never get it, and neither does a post with the internal tag #evergreen. The reader's browser works out the age, so a browser without JavaScript shows no note.

Fix: choose the age in Settings → Site → Design & branding → Customize → Theme, under Post, with Age warning, or set it to Off. To keep the note off a post that is still correct, such as a guide you keep up to date, add #evergreen in its Tags. To show it on a post that has the tag, remove #evergreen.

Installation and updates

After an update, the theme is there twice

Cause: the file had another name when you uploaded it, such as logbuch (1).zip, which browsers create when a file of that name already exists in your downloads. Ghost names the theme after the file.

Fix: rename the file to logbuch.zip and upload it again, then choose Overwrite. Delete the extra copy in Settings → Site → Theme → Change theme → Installed.

After an update, a setting is back to its default

Cause: the update removed or renamed one of the choices in that setting, and Ghost resets a choice it no longer knows.

Fix: choose again. The changelog of that version says which setting is affected.

Demo content

The about page has the address about-2

Cause: Ghost's own sample page about was still there during the import.

Fix: delete Ghost's sample page with the URL about under Pages, then open the imported page's settings and change its URL to about.

Images in the demo look blurry or load slowly

Cause: the images and the content were imported together, or in the wrong order. Ghost then makes no smaller sizes of the images.

Fix: start again with an empty site: delete all content, import the -demo-uploads.zip first, then the -demo-content.json on its own (Demo content).

Look and settings

The fonts differ from the demo

Cause: a font is picked under Brand → Typography in Ghost. It replaces the theme's heading or body font.

Fix: set both to Theme default and choose fonts in the Theme tab (Fonts).

The buttons of the sign-up window are hard to read

Cause: Ghost's accent colour is light, and Ghost writes white on it.

Fix: set Brand → Accent color to a dark colour, such as your preset's own: #C20826 for Dev blog, #B8103B for Changelog, #B12A06 for Homelab.

There are no comments under posts

Cause: comments are off, or members are off. Only members can comment.

Fix: in Settings → Membership → Access, set "Who can comment on posts?" to All members or Paid-members only (Members).

The authors or tags page shows nothing but a title

Cause: the page's URL isn't exactly authors or tags.

Fix: open the page's settings and set the URL (Post types).

A class I added to a template has no effect

Cause: the stylesheet only contains classes the theme used when it was built.

Fix: rebuild the stylesheet as described under Customising, or add the CSS through Code injection.