Template:Shortcut

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Created page with "<!-- Putting anchors on page: --><div style="position: relative; top: -3em;">{{#if:{{{1|}}}|<span id="{{{1|}}}"></span> }}{{#if:{{{2|}}}|<span id="{{{2|}}}"></span> }}{{#if:{{{3|...")
 
m
Line 4: Line 4:
 
<table class="shortcutbox noprint" style="float: right; border: 1px solid #aaa; background: #fff; margin: .3em .3em .3em 1em; padding: 3px; text-align: center;"><tr><th style="border: none; background: transparent;"><!--
 
<table class="shortcutbox noprint" style="float: right; border: 1px solid #aaa; background: #fff; margin: .3em .3em .3em 1em; padding: 3px; text-align: center;"><tr><th style="border: none; background: transparent;"><!--
 
Adding the shortcut links:
 
Adding the shortcut links:
--><small>[[Wikipedia:Shortcut|Shortcut{{#if:{{{2|}}}|s}}]]: {{#if:{{{1|}}}|<br> [[{{{1}}}]] }}{{#if:{{{2|}}}|<br> [[{{{2}}}]] }}{{#if:{{{3|}}}|<br> [[{{{3}}}]] }}{{#if:{{{4|}}}|<br> [[{{{4}}}]] }}{{#if:{{{5|}}}|<br> [[{{{5}}}]] }}</small></th></tr></table><!--
+
--><small>[[Opensim:Shortcut|Shortcut{{#if:{{{2|}}}|s}}]]: {{#if:{{{1|}}}|<br> [[{{{1}}}]] }}{{#if:{{{2|}}}|<br> [[{{{2}}}]] }}{{#if:{{{3|}}}|<br> [[{{{3}}}]] }}{{#if:{{{4|}}}|<br> [[{{{4}}}]] }}{{#if:{{{5|}}}|<br> [[{{{5}}}]] }}</small></th></tr></table><!--
 
Reporting if the first parameter is not a valid non-bracketed shortcut name:
 
Reporting if the first parameter is not a valid non-bracketed shortcut name:
 
-->{{#if:{{{1|}}}
 
-->{{#if:{{{1|}}}
 
| {{#ifexist:{{{1|}}}
 
| {{#ifexist:{{{1|}}}
 
   |  
 
   |  
   | [[Category:Wikipedia shortcut box first parameter needs fixing|{{PAGENAME}}]]
+
   | [[Category:sshortcut box first parameter needs fixing|{{PAGENAME}}]]
 
   }}
 
   }}
 
}}<noinclude>
 
}}<noinclude>

Revision as of 02:31, 21 October 2011

Shortcut:
[edit] [purge] Template documentation

This is the documentation for {{shortcut}} and its sister templates. 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.

Contents

Usage

The characteristics of the box graphic are determined by which of the family of shortcut templates are chosen. For example, the policy shortcut box has the word policy on it for use on policy pages. The graphic alignment of the box depends on the whether it's a shortcut or a shortcut-l:

This template is not normally used for articles in the main namespace, because the graphic produces an avoidable self-reference.

  1. Insert the shortcut template.
  2. Create a redirect page with the {{R from shortcut}} template suffixed to the redirect. Name the page after your shortcut name. Include the namespace name in both the shortcut name and the redirect page name. For example, substitute your own shortcut name as the title of the page, and substitute the proper namespace, then add the following as the top-line on your redirect page:
    #REDIRECT [[Namespace:Title of page with#Optional very long section name]] {{R from shortcut}}
  3. Verify operation. Note that shortcut templates should display in all capitals, but operate without all capitals.
Notes

These templates are mainly used 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 point of these templates is not to list every single redirect for a page (indeed, that's what "What links here" is for). Instead, they should list only one or two common and easily-remembered redirects.

The shortcut template can take up to five (5) shortcuts as parameters.

For policy pages, one can use the {{policy shortcut}} template, which takes up to ten (10) shortcuts as parameters. Be careful not to use a policy template on a guideline or essay.

Examples

Code Result
{{Shortcut|WP:SHORT}}
Shortcut:
WP:SHORT
{{Shortcut|WP:V|WP:VERIFY|WP:SOURCE}}
Shortcuts:
WP:V
WP:VERIFY
WP:SOURCE

Anchors

These templates automatically add anchors. 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.

For instance, try this link: #WP:SHORT

Thus, if you make a shortcut for a section of a page, then you can use the anchor in the shortcut redirect itself. Like this:

#REDIRECT [[Pagename#WP:SHORT]] {{R from shortcut}}

Positioning

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:

  • Placing the shortcut above the section header; a bit confusing when editing
  • Creating the redirect to the section header, not the shortcut; this would break if the section header was renamed
  • Placing an {{anchor}} in the section header that duplicated the shortcut

These fixes are no longer needed, but do not break the current implementation.

See also

  • {{Anchor}} – a way to overcome the otherwise permanent fact that section titles are the only way to link to a section
  • {{Ombox/Shortcut}} – for embedding into message boxes
  • {{Policy shortcut}} – for shortcuts to sections of policy pages
  • {{R from shortcut}} – for placement on the redirect page
  • {{Shortcut-l}} – for left aligned normal shortcuts
  • {{Template shortcut}} – used for shortcuts/redirects to a template page
Personal tools
General
About This Wiki