Ramme

Ramme is a simple, retro-styled Jekyll theme for blogs and personal websites, created by Taylan Tatlı and distributed via GitHub. It focuses on readable content presentation with a nostalgic, terminal-inspired design.

What is Ramme?

Ramme is a Jekyll theme that turns Markdown posts into a static blog with a retro visual style. It takes standard Jekyll content as input and outputs a responsive HTML site that can be hosted on GitHub Pages or any static web host. The theme is authored by Taylan Tatlı and is marked as a work in progress, with the author inviting pull requests to fix or improve the design.

Key Features

• Retro design — The visual style is modeled after a screenshot of a terminal-based interface, giving blogs a distinctive old-school look.
• Built-in table of contents — Ramme includes a TOC component for longer posts, a feature borrowed from the Minimal Mistakes theme.
• Sample posts — The theme ships with sample posts that demonstrate how to structure content and use the TOC.
• Responsive layout — The author states the theme works and looks acceptable for different screen sizes, so it adapts to mobile and desktop viewports.
• GitHub Pages ready — A live demo is hosted at taylantatli.github.io/Ramme, showing the theme running directly from a GitHub repository.
• Setup guide — A dedicated setup page at taylantatli.me/Ramme/ramme-theme/ explains how to install and configure the theme.

Who is it for?

Ramme is for bloggers who want a minimalist, retro-themed site without building a custom design from scratch. It also suits Jekyll users who need a quick starting point for a personal site or portfolio, and developers who enjoy the old-school terminal aesthetic and want to contribute improvements via pull requests.

What can you do with Ramme?

• Personal bloggers: Publish Markdown posts and get a clean, retro-styled blog with automatic table of contents for longer articles.
• Developers: Fork the GitHub repository, customize the layout and styles, and submit improvements upstream to help the project evolve.
• Portfolio owners: Build a simple personal page that highlights projects or writing, hosted free on GitHub Pages.

How does Ramme work?

Ramme works like a standard Jekyll theme: you install it, add your posts as Markdown files, and run Jekyll to generate a static site. The theme's layouts control the HTML structure, and the TOC component automatically reads heading levels from each post to build a clickable navigation list.

Pros and cons

• Pros: Free to use; responsive design; includes TOC and sample content; easy to host on GitHub Pages.
• Cons: The theme is a work in progress, so some polish may be missing; aesthetics are limited to the retro style; documentation is hosted on a separate site.

FAQ

Is Ramme free to use?

Yes, Ramme is a free Jekyll theme distributed on GitHub. You can download, fork, and use it for personal projects without cost, as it is publicly available in the author's repository.

Does Ramme work with GitHub Pages?

Yes, the live demo is hosted on GitHub Pages, and because it is a standard Jekyll theme, you can publish your own site by adding the theme to a Jekyll project and pushing to GitHub.

Does Ramme include a table of contents?

Yes, Ramme includes a table of contents feature for posts, which was incorporated from the Minimal Mistakes theme. Sample posts show how to structure headings for the TOC to work.

Can I customize the theme?

Yes, the theme's source code is on GitHub, and the author invites pull requests. You can edit the layout files, styles, and content to fit your needs.

Is Ramme still under development?

The README describes the theme as a work in progress (WIP). The author notes it is not perfect and encourages contributions to improve the design and code.