Alistair Magee 2e98bd8bdf remove uneeded imports 10 years ago
..
README.md 1f8b7e0f87 Support for custom urls for different categories of article 10 years ago
__init__.py 1f8b7e0f87 Support for custom urls for different categories of article 10 years ago
custom_article_urls.py 2e98bd8bdf remove uneeded imports 10 years ago

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.