https://github.com/Nitron/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)
https://github.com/Nitron/pelican-alias

Last synced: 30 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/Nitron/pelican-alias
• Owner: Nitron
• License: mit
• Created: 2013-06-01T01:53:46.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2020-08-10T23:02:59.000Z (over 4 years ago)
• Last Synced: 2024-11-08T03:16:18.635Z (about 1 month ago)
• Language: Python
• Size: 13.7 KB
• Stars: 18
• Watchers: 4
• Forks: 12
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
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 `_.

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/