Jekyll plugin that helps to generate tags and categories pages in wordpress style
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.md
categories.rb
tags.rb

README.md

jekyll-classify

Jekyll plugin that helps to generate tags and categories pages in wordpress style

DEMO

Inspiration: https://github.com/brousalis/jekyll-category-list then improved with categories pages.


Usage

Categories/Tags links

Add categories.rb and tags.rb to you _plugins directory (or the one that you like to use).

  • To list all the categories links use the helper:

      {% list_categories %}
    
  • To list all the tags links use the helper:

      {% list_tags %}
    

The previous Liquid Tag will generate an unordered list with class list-categories (and list-tags). Each a tag will have a data-num-of-posts attribute with the number of posts associated with the correspongind category (or tag).

Categories/Tags layouts

The pages will be generated automatically in your _site directory based on a chosen layout:

  • In the _layout folder create a file (default names: categories.html and tags.html) with the layout you wish for the categories and tags pages.

In the Category Layout: add the following to list all the post.

	{% for post in site.categories[page.category] %}
		# post properties
	{% endfor %}

In the Tag Layout: add the following to list all the post.

	{% for post in site.tags[page.tag] %}
		# post properties
	{% endfor %}

Optional configuration

It is possible to override the following variables in the _config.yml:

# default values
site.category_dir = 'categories'	# /categories/ as category pages directory
site.category_layout = 'categories'	# _layout/categories.html as category page layout 

# default values
site.tag_dir = 'tags'		# /tags/ as tag pages directory
site.tag_layout = 'tags'	# _layout/tags.html as tag page layout 

Contributing

Feel free to contribute or use the code, give me advice on my code, open issue or feature request. Cheers!

License

Available under the MIT license.