Logbuch docs
Set up Logbuch for your dev blog, changelog or homelab journal, from upload to the last setting.
Logbuch is for people who write about what they build and run: a developer blog with tutorials in chapters, the release notes and incident reports of a small product, a homelab journal. Every entry runs in order with its date, time and type, so readers see what changed and when. Code gets as much care as the text around it, with highlighting, line numbers and a copy button, in three colour schemes of the theme's own, light and dark.
These pages assume you're setting up Ghost for the first time. If you already run a Ghost site, start with post types and series, because releases, incident reports, TIL notes and tutorials in chapters are where Logbuch differs from other themes.
The quickest way in
- Install the theme and activate it.
- Pick what you write under Presets: Dev blog, Changelog or Homelab.
- Import the demo content of your preset to see every list filled, or write your first entry straight away.
See it running
Each preset has its own demo site:
- Dev blog, the blog of a backend developer with a tutorial series, TIL notes and the release log of her side project
- Changelog, the release notes and incident reports of a small self-hosted uptime monitor
- Homelab, the journal of three mini PCs and a NAS in a loft
What you need
Ghost 6 or newer, on Ghost(Pro) or on your own server. The theme is tested on Ghost 6.75.0. Members, newsletters and comments are optional, and the theme hides the ones you leave off.
All chapters
- Installation: download, upload, activate, and update without losing your settings.
- Presets: Dev blog, Changelog and Homelab, and what each one sets.
- Post types: releases, incident reports, TIL notes, letters, series and the pages for authors and tags.
- Custom settings: every setting with its default, your own colours and fonts.
- Members and comments: sign-in, sign-up, account and pricing pages, Portal and comments.
- Navigation: the header and footer menus, and a structure for each preset.
- Translations: the languages the theme ships and how to switch.
- Demo content: importing the demo images and entries of your preset.
- Customising: what you can change without a rebuild and how to rebuild.
- Self-hosting: what the theme and Ghost load, and how to serve it all from your own server.
- Troubleshooting: the problems people run into first, and their fixes.
- Changelog: what changed in each version.
Chapters
- InstallationDownload Logbuch, upload it in Ghost Admin and activate it. Update it later without losing your settings.
- PresetsChoose the preset for what you write: Dev blog, Changelog or Homelab.
- Post types, series and codeA release, an incident note or a TIL is a Ghost post with a template and an internal tag, a series is a tag whose slug starts with series-, and code options go after the language in the code card.
- Custom settingsEvery Logbuch setting with its default, and how to set your own colours and fonts.
- Members and commentsReaders sign up through Ghost's Portal or four pages Logbuch adds, the signup and paywall boxes look like a command line, and comments sit at the end of every entry.
- NavigationFill the header and footer menus, add submenus, and copy a structure that works for a dev blog, a changelog or a homelab journal.
- TranslationsLogbuch ships in five languages. Switch the site language or add your own.
- Demo contentImport the demo of your preset to see every post type filled in, then replace it with your own entries.
- CustomisingWhat you can change without a rebuild, what the code highlighting loads, and how to rebuild the theme's CSS when you need to.
- Self-hostingLogbuch loads nothing from other servers. Ghost does, and here is how to serve its tools yourself.
- TroubleshootingProblems you might hit while setting up Logbuch, and how to fix them.
- ChangelogEvery release of Logbuch, newest first.