Implementing JBake Categories Support

[manikmagar]

jbake-org#293

Implemented Categories Support for Posts.

Categories configuration controls -

• template.category.file=category.ftl (This is for rendering individual category page)
• template.categories.file=categories.ftl (This is for rendering all categories list page to prevent directory listing on {site.host}/categories/ url.
• categories.enable=true
• render.categories=true
• category.default=Uncategorized
• categories.path=categories
• categories.sanitize=false

Adding categories in content

Add an attribute categories=Category1, Category2

• If categories.enable is not false and no categories are provided for post then category.default is applied to post.
• First category is also available with primary_category key in model.
• If categories.enable is false and categories are still provided in content, then those are ignored with a warning in log.

Accessing categories in templates

• all_categories - All categories from all published content. This variable is available on templates.
• category_posts - On a single category page template.category.file, this variable is available and provides access to posts marked with category being displayed on page.

Extensionless Support

If uri.noExtension is set to true then all category pages are rendered without extension.

Test cases

Appropriate test cases have been added under src/test/java with its resources under src/test/resources.