pelican-plugins/custom_article_urls/README.md

#Custom Article URLs#

Adds support for defining different default urls for different categories, or different subcategories if using the subcategory plugin.

##Usage##

After adding custom_article_urls to your PLUGINS add a CUSTOM_ARTICLE_URLS setting, which is a dictionary of rules. The rules are also a dictionary, consisting of the URL and the SAVE_AS values.

For example, if you had two categories, Category 1 and Category 2 and you would like Category 1 saved as category-1/article-slug/ and Category 2 saved as /year/month/article-slug/ you would add:

CUSTOM_ARTICLE_URLS = {
    'Category 1': {'URL': '{category}/{slug}/,
        'SAVE_AS': '{category}/{slug}/index.html},
    'Category 2': {'URL': '{date:%Y}/{date:%B}/{slug}/,
        'SAVE_AS': '{date:%Y}/{date:%B}/{slug}/index.html},
    }

If had any other categories they would use the default ARTICLE_SAVE_AS and ARTICLE_URL

If you are using the subcategory plugin, you can define them the same way. For example if Category 1 had a subcategory Sub Category you could define it's rules with

'Category 1/Sub Category`: ...

##Other Usage: Article Metadata##

If you define a url and save_as in your articles metadata, then this plugin will not alter that value. So you can still specify special one off urls as normal.