Template:Redirect category shell/doc

This template is similar to {{WikiProject banner shell}} in that it may be used to add one or more appropriate redirect category (rcat) templates, along with their parameters, to redirects. Additionally, this template automatically senses, describes, categorizes and changes protection levels when appropriate. A third important function is to help editors learn more about redirect categorization by use of the manifold sort.

Purpose

Like the This is a redirect template, this shell template is also able to help newer contributors learn the redirect category system. Details of this part of the purpose of this shell template may be found in the When used alone section below.

Protection levels are automatically detected by this template by use of {{pp-protected}} and {{pp-move}}. When edit protection or move protection (or both) is applied to a redirect that has been tagged with this template, the protection level is automatically detected, and the redirect will be tagged with a protection rcat and sorted to the appropriate protection-related category(ies). When protection is altered or removed, then the protection-related rcats and category(ies) will also be (automatically) changed or removed from the redirect.

Usage

Used by itself with no parameters, for example, {{Redirect category shell}} (and its alias {{Rcat shell}}), the template will appear as it does at the top of this page, and the redirect will populate Category:Miscellaneous redirects. That category will also be populated if the first parameter is left empty while rcats occupy the second parameter. This is useful when an editor adds rcats and yet feels unsure that there may be at least one other rcat with category that may be used to tag the redirect. Monitors of the Miscellaneous redirects category will then help decide if another rcat(s) is needed. Then the empty first parameter may be excluded by removing either the first or second pipe. That will remove the redirect from Category:Miscellaneous redirects. See below for more information.

This template may hold any number of different redirect category (rcat) templates, usually from one to seven. The choices for editors are listed at BattleTechWiki:Template index/Redirect pages both alphabetically and by function. Any of those rcats may be used either with their full template name, e.g., R from alternative language, or with an alias (shortcut redirect), which may be found in each rcat's documentation.

An unnamed parameter, |1=, has been introduced in this template and works as follows:

{{Redirect category shell|1=
{{rcat 1}}
{{rcat 2}}
{{rcat 3}}
{{rcat N}}
}}

or the 1= may be omitted:

{{Redirect category shell|
{{rcat 1}}
{{rcat 2}}
{{rcat 3}}
{{rcat N}}
}}

As with all templates that have unnamed (numbered) parameters, the numbers and equal signs may be omitted.

"N" represents the highest number of rcats that can be used in this template, and at this point the only limit would be any wiki markup ceiling that may exist. Usually, from one to seven rcats suffice; however, more rcats can be used if required.

The actual sequence of rcats is left to editors – there is no priority as to which rcat should be "first" and which rcats should "follow" in any particular order.

A second unnamed parameter, |2=, has also been introduced. This gives this template the same "help" functionality that is used in the This is a redirect template. If the first parameter is left "empty", then Category:Miscellaneous redirects will be populated:

{{Redirect category shell|1=|2=
{{rcat 1}}
{{rcat 2}}
{{rcat N}}
}}

or if a second pipe is placed directly after the first pipe, then that will accomplish the same manifold sort:

{{Redirect category shell||
{{rcat 1}}
{{rcat 2}}
{{rcat N}}
}}

Note the double pipe after the word "shell" above, which indicates an empty first parameter. Editors who monitor the Miscellaneous redirects category will come to the redirect and check, add or remove rcats as needed.

Also, when used by itself this template will appear as it does at the top of this page and populate the Miscellaneous redirects category:

{{Redirect category shell}}

This template may be added to a redirect page in the following manner:

#REDIRECT [[(target page name)]]

{{Redirect category shell||
{{R from short name}}
{{R unprintworthy}}
}}

It can be noted here that the rcats can also go on the same line as the Redirect category shell template:

#REDIRECT [[(target page name)]]

{{Redirect category shell||{{R from short name}}{{R unprintworthy}}}}

Again, note the double pipe after "shell" above, which indicates an empty first parameter. Leave the first parameter empty to sort a redirect to Category:Miscellaneous redirects in addition to the categories of the rcats that are used. In this case the Redirects from short names and Unprintworthy redirects categories will also be populated. Monitors of the "Miscellaneous redirects" category will help editors when needed.

Generally for good readability on the edit screen, this template is placed beginning on the third line of that screen as follows:

Line 1: #REDIRECT [[(target page name)]]

Line 2: (please leave this line blank for emphasis and ease of reading by editors)

Line 3: {{Redirect category shell|{{R from move}}{{R to section}}{{R printworthy}}}}

See also: section titled Mbox note below.

Parameters

In addition to the unnamed |1= and |2= parameters, there is a "hatnote" parameter, |h=, which provides an italicized TOP note when needed.

When used alone

This template is designed to help contributors who are unfamiliar with categorizing redirects by enabling them to sort redirects into the monitored Miscellaneous redirects category. Do not hesitate to use this important function to help with sorting redirects to correct and appropriate categories.

See also

• BattleTechWiki:Protection policy, for questions related to this template's ability to detect protection levels
• BattleTechWiki:Template index/Redirect pages, a functional and an alphabetical index of rcats

Tracking categories

• Category:Redirect category shell without parameters (0)

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools.

TemplateData for Redirect category shell

This template may be used to add one or more appropriate redirect category (rcat) templates, along with their parameters, to redirects. Additionally, this template automatically senses, describes, categorizes and changes protection levels when appropriate.

Template parameters

Parameter		Description	Type	Status
Redirect categories	1	1 or more redirect category templates. Example {{R from alternative name}}	Content	suggested
Redirect categories (more needed)	2	Same as Redirect categories, except that the redirect is also added to Category:Miscellaneous redirects.	Content	optional
Hatnote	h	A hatnote to display above the redirect categories.	Line	optional
No category	nocat	Don't add this redirect to Category:Miscellaneous redirects, even if Redirect categories has been left empty.	Boolean	optional
Category	category	The category to add this redirect to if the Redirect categories parameter is empty. Defaults to Category:Miscellaneous redirects. Example [[Category:Miscellaneous redirects]]	Line	optional