Skip to content

Pelican plugin for creating alias pages (useful for moving from a different URL scheme such as /<year>/<month>/<title>/ as used by Wordpress)

License

Notifications You must be signed in to change notification settings

paulignari/pelican-alias

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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/
    

About

Pelican plugin for creating alias pages (useful for moving from a different URL scheme such as /<year>/<month>/<title>/ as used by Wordpress)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%