49 lines
1.4 KiB
ReStructuredText
49 lines
1.4 KiB
ReStructuredText
pelican-alias
|
|
====================
|
|
|
|
`Pelican <http://getpelican.com>`_ plugin for creating alias pages (useful for moving from a different URL scheme such as */<year>/<month>/<title>/* as used by Wordpress).
|
|
|
|
Inspired by `jekyll_alias_generator <https://github.com/tsmango/jekyll_alias_generator/>`_.
|
|
|
|
License: MIT
|
|
|
|
Installation
|
|
============
|
|
|
|
Simply run::
|
|
|
|
pip install pelican-alias
|
|
|
|
Usage
|
|
=====
|
|
|
|
* Add *pelican_alias* to *PLUGINS* in the pelican configuration file
|
|
* In each post or page that needs an alias, add an *:alias:* line to the metadata section. Example::
|
|
|
|
My Aliased Post
|
|
##############################################
|
|
:date: 2013-05-31 22:09
|
|
:category: Pelican
|
|
:slug: my-aliased-post
|
|
:alias: /2013/05/my-aliased-post/, /2013/even-older-post-address
|
|
|
|
My content goes here.
|
|
|
|
* Markdown example::
|
|
|
|
Title: Another Aliased Post
|
|
Date: 2013-06-01 21:10
|
|
Category: Pelican
|
|
Alias: /2013/06/another-aliased-post/
|
|
/2013/even-older-aliased-post-address
|
|
|
|
My content goes here.
|
|
|
|
This will create an additional HTML document at the path specified by *:alias:* that performs a canonical *meta* refresh to the new URL.
|
|
If the path ends in a slash (as in the above example) then the file actually created will be index.html so that this system will work with
|
|
Github pages.
|
|
|
|
Multiple aliases can be created for a single post. The delimiter for ReST
|
|
format may be changed by setting *ALIAS_DELIMITER* in the pelican
|
|
configuration file.
|