37 lines
1.3 KiB
Markdown
37 lines
1.3 KiB
Markdown
#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.
|