Project

minduim

0.0
No release in over 3 years
Minduim is a charming blog theme for Jekyll based on the classic Posterous default theme. It offers a two-column layout with support for pagination, archives, SEO tags, and customizable sidebar widgets.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

>= 1.16

Runtime

 Project Readme

Minduim

A charming Jekyll blog theme inspired by the classic Posterous default theme. Named after the Brazilian translation of the Peanuts comic strip, Minduim offers a clean two-column layout with subtle homages to Charlie Brown.

Minduim Theme Preview

Features

  • Responsive design: Clean two-column layout that adapts to all screen sizes
  • Customization: Easily customize colors and typography
  • SEO-ready: Built-in support for SEO tags, sitemaps, and feeds
  • Archiving: Automatic archives for dates and tags
  • Pagination: Built-in pagination support for blog listings
  • Sidebar widgets: Custom sidebar widgets using includes
  • Multilingual: Fully translatable using theme configuration
  • Multiple author support: Flexible author information system

Quick Start

Option 1: Remote Theme (Recommended)

Add to your site's Gemfile:

gem "jekyll-remote-theme"

Add to your _config.yml:

remote_theme: arthrfrts/minduim@latest

plugins:
  - jekyll-remote-theme

Then run:

bundle install
bundle exec jekyll serve

Option 2: Gem-based Theme

Add to your Gemfile:

gem "minduim"

Add to your _config.yml:

theme: minduim

Then run:

bundle install
bundle exec jekyll serve

Configuration

Create or update your _config.yml with these settings:

title: Your Site Title
description: Your site description
tagline: A short tagline

lang: en
logo: /path/to/logo.svg

# Build settings
permalink: "/:year/:month/:day/:title.html"
slug_mode: latin

# Theme settings
minduim:
  date_formats:
    day: "%v"
    month: "%B, %Y" 
    year: "%Y"
  translations:
    jump_to_navigation: "Go to navigation"
    jump_to_content: "Go to content"
    archive_date_title: "Posts from %s"
    archive_tag_title: "Posts with the tag %s"
    post_tagged_with: "Tagged with:"
    blog_pagination_title: "Blog Pagination"
    blog_pagination_next_page: "Older posts"
    blog_pagination_prev_page: "Newer posts"

# Navigation menus
main_menu:
  title: Navigate
  items:
    - label: About
      url: /about/
    - label: Archive
      url: /archive/

footer_menu:
  title: Links
  items:
    - label: RSS Feed
      url: /feed.xml
    - label: JSON Feed
      url: /feed.json

Customization

Colors and Styling

Create /assets/css/theme.css to customize the theme.

Copy the default theme.css, and uncomment and modify the CSS variables you want to change.

This is the ideal place to customize your site, since it's the last stylesheet loaded. Just add your custom styles at the end of the file and it'll overwrite the theme style rules accordingly.

Sidebar widgets

Create /_includes/sidebar.html to add custom widgets. For example:

{% assign widget_title = "About Me" %}
{% capture widget_content %}
  <p>Welcome to my blog! I write about web development and design.</p>
{% endcapture %}
{% include widget.html title=widget_title content=widget_content %}

{% assign widget_title = "Recent Posts" %}
{% capture widget_content %}
  <ul>
  {% for post in site.posts limit:5 %}
    <li><a href="{{ post.url }}">{{ post.title }}</a></li>
  {% endfor %}
  </ul>
{% endcapture %}
{% include widget.html title=widget_title content=widget_content %}

This will create two widgets: an about me and a recents posts widget. You can add as many widgets you want!

Author Information

Set up author information in multiple ways:

In post front matter:

---
title: My Post
author:
  name: Charlie Brown
  url: https://charliebrown.blog
---

In _data/authors.yml:

charlie:
  name: Charlie Brown
  url: https://charliebrown.blog
lucy:
  name: Lucy Van Pelt
  url: https://thedoctoris.online

In _config.yml:

author:
  name: Snoopy
  url: https://snoopy.as

If no authors object is set in any of these places, the post will show the post.author value as is.

Plugins

Minduim adds support for pagination, archives, feeds and SEO tags, so you can configure the settings following these plugins docs:

Please refer to the full _config.yml for the default plugin settings.

Development

Local Development

# Install dependencies
bundle install

# Start development server
bundle exec jekyll serve

# Build for production
bundle exec jekyll build

Project Structure

minduim/
├── _layouts/          # Page layouts
├── _includes/         # Reusable components
├── assets/           # CSS, images, and other assets
├── _config.yml       # Site configuration
└── about.md         # Theme documentation

Contributing

Bug reports and pull requests are welcome at https://github.com/arthrfrts/minduim.

Please note that this theme is primarily maintained for my own personal use, so not all feature requests may be implemented. Feel free to fork and customize for your needs!

License

This theme is available under MIT License.