Template:DraftLink/doc View history

m (added some examples)
(added category)
Line 46: Line 46:
When that page is moved to the main space the template will produce {{pre2|<nowiki>{{Topic page/Specific detail}}</nowiki>}}
When that page is moved to the main space the template will produce {{pre2|<nowiki>{{Topic page/Specific detail}}</nowiki>}}


=== Categories ===
This template also includes a hidden category ([[:Category:Non user pages with DraftLinks]]) when it is displayed on any page not in the user namespace. This template smoothes the transition to publish a page, but after the page is published, the template can be replaced with proper wiki links. Using the hidden category these pages can be easily tracked.
To replace the template with proper links, simply edit the page, and (using find & replace) add <code>subst:</code> directly before the word "DraftLink" throughout the page. During the next save the templates will be substituted, and converted into their output.
<includeonly>
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
<!-- ADD CATEGORIES BELOW THIS LINE -->

Revision as of 18:57, 3 May 2015

This is a documentation subpage for Template:DraftLink.
It contains usage information, categories and other content that is not part of the original template page.

This template is designed to be used when creating a draft for new pages in the User namespace. It can produce a link (or transclusion) to a related page in the same namespace.

  • When it appears in the user namespace, the link will be preceded with the same User prefix as the page it is displayed on.
  • When it appears in the template namespace, the link will be preceded with Template:
  • When it is moved to a different (or main) namespace, the link will be used without a prefix.

Parameters

  • It accepts one unnamed parameter for the link text. If the parameter is not specified the BASEPAGENAME is used instead.
  • |template=link Use this parameter if you want to link to a template page, instead of transcluding it.

Example Usage

Location sensitive Variable Outputs
Space PAGENAME DraftLink Output
Main Road Names {{DraftLink}} Road Names
User User:PesachZ/Road Names {{DraftLink}} User:PesachZ/Road Names
Main Road Names {{DraftLink|Road Names/USA}} Road Names/USA
User User:PesachZ/Road Names {{DraftLink|Road Names/USA}} User:PesachZ/Road Names/USA
Template Template:DraftLink {{DraftLink}} DraftLink
Template Template:DraftLink {{DraftLink|template=link}} Template:DraftLink
Template Template:DraftLink {{DraftLink|Road Names/USA}} Road Names/USA


The template can be placed inside double square OR curly braces depending on the desired effect. You can also append subpages after the template.

For example use the following code:

[[{{DraftLink|Topic page}}/specific detail]]

When placed on a user page it will produce

[[User:PesachZ/Topic page/specific detail]]

When that page is moved to the main space the template will produce

[[Topic page/Specific detail]]

To use curly braces and transclude that same subpage use this code (notice the space between the sets of curly braces):

{{ {{DraftLink|Topic page}}/specific detail}}

When placed on a user page it will produce

{{User:PesachZ/Topic page/specific detail}}

When that page is moved to the main space the template will produce

{{Topic page/Specific detail}}


Categories

This template also includes a hidden category (Category:Non user pages with DraftLinks) when it is displayed on any page not in the user namespace. This template smoothes the transition to publish a page, but after the page is published, the template can be replaced with proper wiki links. Using the hidden category these pages can be easily tracked.

To replace the template with proper links, simply edit the page, and (using find & replace) add subst: directly before the word "DraftLink" throughout the page. During the next save the templates will be substituted, and converted into their output.