Monoholic

A minimal, monochrome dark Jekyll theme🧪

• Minimalist Dark Aesthetic: Sleek, high-contrast monochrome design out of the box.
• Data-Driven Menu: Easily configure your site navigation via _data/menu.yml.
• Developer Friendly: Code syntax highlighting and monospace typography (JetBrains Mono).
• Responsive Design: Mobile-first layout with smooth fluid scaling using modern CSS.
• Customizable: Centralized CSS variables for fast theming.
• SEO & RSS Ready: Built-in support for jekyll-seo-tag and jekyll-feed.
• Per-Page Scripts: Add specific JavaScript to individual pages seamlessly.

1. Add this line to your Jekyll site's Gemfile:

gem "monoholic"

2. Add this line to your Jekyll site's _config.yml:

theme: monoholic

3. Execute:

$ bundle install

If you're running Jekyll without RubyGems or prefer to use GitHub Pages remote themes, update your _config.yml:

remote_theme: stiermid/monoholic

Or, simply fork this repository, adapt the _config.yml according to your needs, and you're good to go!

Once installed, build your site using the provided layouts (default, home, page, post).

Override the default settings in your _config.yml. Key theme configuration options:

theme_config:
  back: ".." # Text for backlink on post pages
  date_format: "%Y%m%d" # Date format for post metadata

Monoholic uses a data-driven approach to its menu. Create or edit _data/menu.yml to define your site's navigation structure.

Example _data/menu.yml:

entries:
  - title: about
    content: |
      <p>Your about me text here.</p>

  - title: all posts
    post_list: true

• title: The section header.
• content: Custom HTML or text for the menu section.
• post_list: Set to true to auto-generate a list of your Jekyll posts under this section.

Bug reports and pull requests are welcome on GitHub at https://github.com/stiermid/monoholic. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

This theme is available as open source under the terms of the GNU General Public License v3.0 only (GPL-3.0-only).