Tale

Overview

TaleGem is a minimal Jekyll theme designed specifically for storytellers. It offers easy installation options, compatibility with GitHub Pages, responsive design, syntax highlighting, pagination of posts, sticky posts, tags, excerpt management, and Disqus comments. This theme provides a sleek and visually appealing platform for creators to showcase their stories.

Features

• Easy installation: Three installation methods available including Ruby Gem, GitHub Pages, and Fork
• Compatible with GitHub Pages: Can be used with GitHub Pages hosted sites
• Responsive design: Theme is optimized for mobile devices
• Syntax highlighting: Utilizes Pygments for syntax highlighting in code snippets
• Markdown and HTML text formatting: Allows for flexible formatting of text content
• Pagination of posts: Pages posts to allow for easier navigation and browsing
• Sticky posts: Option to make selected posts stick to the top of the page
• Tags: Ability to categorize posts using tags
• Excerpt management: Control over the excerpts displayed on post previews
• Disqus comments: Option to enable comments using the Disqus platform

Installation

There are three methods for installing the TaleGem theme depending on the hosting environment:

Ruby Gem Method

1. Add the following line to your Gemfile:

gem 'tale', '~> 0.1.2'

2. Install the theme’s gems and dependencies.
3. In _config.yml, add the following lines:

theme: tale

4. Rename index.md to index.html to ensure jekyll-paginate gem works correctly.
5. In about.md, change the layout field to post.

GitHub Pages Method

1. Add the following lines to your Gemfile:

gem 'github-pages', group: :jekyll_plugins
gem 'jekyll-remote-theme'

2. Install the newly added gems.
3. In _config.yml, add the following lines:

plugins:
  - jekyll-remote-theme

4. Remove any other theme or remote_theme lines.
5. Rename index.md to index.html to ensure jekyll-paginate gem works correctly.
6. In about.md, change the layout field to post.

Fork Method

1. Fork the TaleGem repository.
2. Delete unnecessary files/folders: CODE_OF_CONDUCT.md, LICENSE, README.md, tale.gemspec.
3. Remove the baseurl line in _config.yml.

Summary

TaleGem is a minimal Jekyll theme designed for storytellers. It offers easy installation options, compatibility with GitHub Pages, responsive design, syntax highlighting, pagination of posts, sticky posts, tags, excerpt management, and Disqus comments. The theme provides a visually appealing and user-friendly platform for creators to share their stories effectively.