This is the template sandbox page for Template:Shortcut (diff). See also the companion subpage for test cases. |
This template is used on approximately 19,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
Related pages |
---|
|
This is the documentation for ((shortcut)) and its sister templates. Template ((shortcut)) renders a box, informing editors which shortcuts are available for linking to a page or a section of a page.
The shortcut family of templates is put into context here, but they each have their own documentation pages, see below. A shortcut template is similar to the ((anchor)) template, but it adds a visual box graphic to the rendered page, as well as providing an alternative name. Creating a redirect page is a requirement to fulfill the shortcut mechanism.
In templates, it is put in the documentation page.
This template should not be used for articles in the main namespace, because the graphic produces an unavoidable self-reference.
#REDIRECT [[Namespace:Title of page with#Optional and possibly very long section name]]
((R from shortcut))
Notes Shortcuts are used mainly on user pages and talk pages in reference to the Wikipedia, Help, and Portal namespaces. These templates inform about the shortcuts available to the page they are on. For example, WP:SHORT redirects to Wikipedia:Shortcut and therefore, Wikipedia:Shortcut renders a shortcut box listing WP:SHORT. It is a self-reference that is normally avoided in the main article namespace.
The purpose of these templates is not to list every single redirect for a page (that's what Special:WhatLinksHere is for), but to list the most common and easily remembered redirects.
((shortcut)) takes the following parameters:
1
, 2
, 3
... – the shortcut links.float
– if set to left
, the box floats to the left.clear
– if set to right
, (or left
if |float=left
is set), the box appears beneath, not beside, another floating element preceding it (infobox, thumbnail etc.).msg
– an unlinked message that goes after the shortcut links.category
– set to "no", "n", "false" or "0" to suppress error categories.Code | Result |
---|---|
((Shortcut|WP:SHORT))
|
|
((Shortcut|WP:V|WP:VERIFY|WP:SOURCE))
|
|
((Shortcut|WP:V|WP:VERIFY|msg=A message))
|
These templates automatically add an anchor for each shortcut name parameter. For example, if a shortcut box with the shortcut WP:SHORT is placed on the page Wikipedia:Shortcut, then the link Wikipedia:Shortcut#WP:SHORT will take you to the position in the page where that shortcut box is placed.
Examples: #WP:SHORT, and MOS:MATH#TONE
This makes it easier to create a shortcut for a section of a page, because you can refer to the anchor when creating the shortcut redirect itself. Like this:
#REDIRECT [[Pagename#WP:SHORT]] ((R from shortcut))
This template is usually placed below the section header or at the top of a page.
Before July 26, 2010, when the anchor was inside the box, this caused the section header to scroll above the page window. Fixes for this issue included:
These fixes are no longer needed, but do not break the current implementation.
TemplateData for Shortcut
This template displays one or more of a template's shortcuts.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Template? | template | Whether this is a list of shortcuts for a Template. <p><!--nostrip-->'''See also:''' <code><!--nostrip-->(([[Template:Template shortcut|Template shortcut]]))</code></p>
| Boolean | optional |
Redirect? | redirect | Whether to refer to the “shortcut/s” as “redirect/s” instead.
| Boolean | optional |
Target? | target | Whether to omit the <code><!--nostrip-->redirect=no</code><!--nostrip--> URL parameter.
| Boolean | optional |
Float | float | The CSS <code><!--nostrip-->float</code><!--nostrip--> property value.
| String | optional |
Clear | clear | The CSS <code><!--nostrip-->clear</code><!--nostrip--> property value.
| String | optional |
Categorize | category | Whether to add pages to the error category if no alias or <code><!--nostrip-->msg</code><!--nostrip--> is specified.
| Boolean | optional |
Message | msg | An unlinked message that goes after the shortcut links. | Content | optional |
Shortcut 1 | 1 | Page/section shortcut 1 | Page name | required |
Shortcut 2 | 2 | Page/section shortcut 2 | Page name | optional |
Shortcut 3 | 3 | Page/section shortcut 3 | Page name | optional |
Shortcut 4 | 4 | Page/section shortcut 4 | Page name | optional |
Shortcut 5 | 5 | Page/section shortcut 5 | Page name | optional |
Shortcut 6 | 6 | Page/section shortcut 6 | Page name | optional |
Shortcut 7 | 7 | Page/section shortcut 7 | Page name | optional |
Shortcut 8 | 8 | Page/section shortcut 8 | Page name | optional |
Shortcut 9 | 9 | Page/section shortcut 9 | Page name | optional |