alias - Atlassian Plugins

add-page-form

Macros

attachment-data

{alias}

Plugin: Redirection Plugin

This will create a page which is an alias for the current page.

Description

More than one alias macro may exist on a single page.

Usage

{alias:[Alias]|parent=[@self,@parent,Page]}

Parameters

Name	Required	Default	Description
[default]			The name for the alias. This must be a valid page name.
parent		no parent	Specifies what the parent page will be for alias. This may be any page in the current space, or one of the following: @self - The current page. @parent - The current page's parent.

Examples

In my 'Pets' space, I have a 'Dog' and a 'Cat' page describing what each animal is. However, when referring to them in text on other pages, I often use the plural form (eg. 'dogs' or 'cats'). Linking to them with the plural means labeling each link manually (eg. [dogs|dog] or [cats|cat]). Instead, I use the {alias} macro on the 'Dog' page. Eg:

{alias:Dogs}
Dogs are man's best friend.

I can now refer to dogs in the plural form without annoying labeling (eg. [dogs]). I can even give a page more than one alias. For example, on the 'Cat' page:

{alias:Cats}
{alias:Feline}
{alias:Felines}
Cats are not man's best friend, unlike [dogs].

Notes

You can only specify an alias within the current space.
If a page already exists with the alias' name, the page will be left unchanged.
If the alias specified is already an alias for a different page, an error message will be displayed and the alias will be unchanged.
If you rename a page with aliases, the alias pages will continue to work.
If you change the alias name on the original page, the old alias will still exist. It must be deleted manually.
To edit or delete an alias, add '?redirect=false' to the URL manually.