pelican-plugins/subcategory

#Subcategory Plugin#

Adds support for subcategories in addition to article categories.

Subcategories are heirachial. Each subcategory has a parent, which is either a regular category or another subcategory. Subcategories with the same name but different parents are not the same. Their articles won't be grouped together under that name.

##Usage##

Subcategories are an extension to categories. Add subcategories to an article's category metadata using a / like this:

Category: Regular Category/Sub-Category/Sub-Sub-category

then create a subcategory.html template in your theme similar to the category.html or tag.html

In your templates article.category continues to act the same way. Your subcategories are stored in a list aricles.subcategories. To create a breadcrumb style navigation you might try something like this:

<nav class="breadcrumb">
<ol>
    <li>
        <a href="{{ SITEURL }}/{{ arcticle.categor.url }}">{{ article.category}}</a>
    </li>
{% for subcategory in article.subcategories %}
    <li>
        <a href="{{ SITEURL }}/{{ category.url }}>{{ subcategory }}</a>
    </li>
{% endfor %}
</ol>
</nav>

##Settings##

Consistent with the default settings for Tags and Categories, the default settings for subcategoris are:

'SUBCATEGORY_SAVE_AS' = os.path.join('subcategory', '{savepath}.html')
'SUBCATEGORY_URL' = 'subcategory/(fullurl).html'

savepath and fullurl are generated recursively, using slugs. So the full url would be:

category-slug/sub-category-slug/sub-sub-category-slug

with savepath being similar but joined using os.path.join