Skip to content

Latest commit

 

History

History
55 lines (38 loc) · 1.59 KB

README.rst

File metadata and controls

55 lines (38 loc) · 1.59 KB
Raw

pelican-alias

Pelican 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.

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.

  • Redirect to external URLs:

    Title: Pelican-Alias on PyPi
Date: 2013-06-01 21:10
URL: https://pypi.python.org/pypi/pelican-alias
Alias: /pypi/