pelican-alias ==================== `Pelican `_ plugin for creating alias pages (useful for moving from a different URL scheme such as *////* 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.