terminus

A dark duotone retro theme for Zola

Author: Eyal Kalderon

This theme requires Zola version 0.20.0 and above

License: MIT

Homepage: https://github.com/ebkalderon/terminus

Live Demo: https://ebkalderon.github.io/terminus/

Tags:

• dark
• blog
• minimal
• personal
• responsive
• seo

Last updated: 2025-07-30T16:52:39-04:00

Terminus

An accessible Zola theme with a dark color scheme and retro computer terminal-like vibe, multi-language support, zero required JavaScript, pretty font ligatures, and a perfect baseline Lighthouse score.

Try the demo now: https://ebkalderon.github.io/terminus/

Terminus is largely a port of Radek Kozieł's Terminal Theme for Hugo but with several key differences. Credit to the zerm and tabi themes for inspiring some of these changes.

• Better accessibility (WCAG 2.2 Level AA minimum target)
• Mobile-first design with improved responsiveness
• Social media icons in footer
• Support for GitHub-style alerts
• SEO friendly (better OpenGraph support, will add Schema.org eventually)
• No post image previews for a cleaner look

Features

• Perfect baseline Lighthouse score (Performance, Accessibility, Best Practices and SEO).
• Social media icons in footer
• Custom shortcodes
• Copy button on code blocks
• Comprehensive documentation (still working on it!)
• Searchable archive page
• Projects portfolio page
• Site navigation submenus
• Customizable color schemes
• KaTeX support for mathematical notation

Getting Started

Manual Installation

1. Initialize a Git repository in your Zola project directory, if you haven't already:

   git init
   

2. Add the theme as a Git submodule:

   git submodule add https://github.com/ebkalderon/terminus.git themes/terminus
   

3. Enable the theme in your config.toml:

   theme = "terminus"
   

4. Set a website title in your config.toml:

   title = "Your Site Title"
   

5. Create a text file named content/_index.md. This file controls how your home page looks and behaves. Choose exactly one of the following options:
   1. Serve blog posts from /:

      +++
      title = "Home"
      paginate_by = 5  # Show 5 posts per page.
      +++
      

   2. Serve posts from a different path, e.g. blog/:

      +++
      title = "Home"
      
      [extra]
      section_path = "blog/_index.md"  # Where to find your posts.
      max_posts = 5  # Show 5 posts and a link to blog section on home page.
      +++
      

Updating Terminus

To update the Terminus theme as a Git submodule, run:

git submodule update --remote themes/terminus

License

This project is licensed under the terms of the MIT license.