Template:R from alternative language/doc

Purpose
This template exists to help track useful redirects from foreign-language terms and redirects to other languages from English words and phrases. It is not a license to create redirects between arbitrary terms in any language – generally, foreign-language titles are considered appropriate only when there is a strong connection between the language and the topic. For example, Vienna makes sense, because German is the official language of Austria; however, these three redirects:,  and , would be deleted if they existed, because there is no real connection between the city of Vienna and Mandarin, Western Punjabi, or Macedonian, respectively. See Redirects in languages other than English for details.

Usage

 * This redirect category (rcat) template should only be used with its first and second language parameters as described below. If applied without language parameters, the redirect will populate both  and .  Entries in those categories should be placed into more specific language categories when the "from" and "to" languages are known by using ISO 639 codes or appropriate IETF language tags, such as "en" for English, "la" for Latin, "en-au" for Australian English (see code list).  If help is needed to determine the language of the redirect or target, then editors who monitor the undetermined-language categories will help determine the language and code needed to move the redirect to the more specific category(ies).
 * Add this rcat to a redirect in the following manner:
 * The Redirect category shell (shortcut Rcat shell) may be used to add as many appropriate rcats as needed, usually from one to seven, along with their parameters, to a redirect. For more information see the documentation on its template page.  This rcat may also tag a redirect individually:


 * This and the following are in accord with instructions found at REDCAT.


 * Use this rcat on redirects in main article space from a page title that are:
 * in English to a title in another language. These are almost always printworthy.
 * Example: 
 * in a non-English language to a title in English.
 * Example: and  (only the latter is printworthy)
 * in a non-English language to a title in another non-English language. These may be printworthy or unprintworthy.
 * Example:  (printworthy)
 * in a non-English language to a title in the same non-English language. These are almost always unprintworthy.
 * Example:
 * in an undetermined language (code "und") to a known language.
 * in a known language to an undetermined language.
 * in an undetermined language to an undetermined language.
 * in an undetermined language to an undetermined language.
 * in an undetermined language to an undetermined language.


 * When the redirect and its target differ only in use of diacritical marks, use R from diacritics or R to diacritics instead.

Example: the redirect page titled
The first unnamed parameter, 1 (or the named parameter, from), is used for the ISO 639 code of the source (the redirect title's) language.


 * or:


 * or:


 * The above three examples all work exactly the same way.
 * Usually, the redirect populates a specific "from" category, in this case.
 * If the language code in the first or "from" parameter is not recognized, or is recognized but has no more-specific category, the redirect populates.

Example: the redirect page titled
The second unnamed parameter, 2 (or the named parameter, to), will sort the ISO 639 code of the target title's language.


 * or:


 * or:


 * The three examples above all work exactly the same way.
 * Usually, the redirect populates a specific "to" category, in this case.
 * If the language code in the second or "to" parameter is not recognized, or is recognized but has no more-specific category, the redirect populates.

Example: the redirect page titled
When these parameters are combined, the redirect will go into two categories, "from" and "to" language terms:


 * or:


 * or:


 * The above three examples all work exactly the same way.
 * The redirect will populate both and.

Undetermined language code
If the language code in the first or second parameter is not known, then the "und" language code (for "undetermined") may be used. Then the redirect will populate either or  or both if "und" is used in both the first and second parameters.


 * or:


 * or:


 * One or both of the undetermined-language categories ("from" and "to") will be automatically populated if either or both of the parameters are left empty.
 * One or both of the non-English language categories ("from" and "to") will be automatically populated if either or both of the parameters are an unrecognized value.

Editors who monitor those categories will help apply the correct language codes that will make the redirect populate a more specific language category(ies).

Titles of works
In the case of the redirect title, that title is just a language translation and is not tagged with the rcat – because both the French and English versions have the French title Les Misérables. In the case of the redirect title "Annales des empereurs du japon", that is actually the title of a French translation of the Japanese work, and is tagged with.

Multiple usage

 * If the redirect (from) or the target (to) title is found in more than one language, then this rcat may be used more than once. For example,, is found in both the Czech and Slovak languages.  There is no restriction on how many times this rcat may be used on a redirect.

Aliases

 * [ Also known as...] – list of templates that redirect here and may also be used
 * – transcludes this template with "en" as the second parameter value

Printworthiness
In 2003, efforts were begun to support the Wikimedia Foundation's goal of increasing access and availability of Wikipedia articles in. It was recognized that only some kinds of page are useful in printed form: in editors' jargon, whether they are wp:printworthy.

Some rcats automatically populate either or  by default. Others, like this one, often do not, which leaves editors to decide whether redirects are Printworthy or Unprintworthy.


 * In main-article namespace only, redirects from English-language terms are printworthy by default.
 * The specialized template defaults to categorizing redirects as unprintworthy.
 * All other alternative-language redirects in main-article namespace must be manually sorted as either printworthy or unprintworthy.

Two rcats can be used to populate these categories:
 * and

Template (or its shortcut, ) will accept these rcats just like any other:


 * Note: this template supports the printworthy parameter only when the language of the redirect title is in English (en). So if the code in the first parameter is "en", and it is decided that the redirect is not printworthy, then the parameter can be set to no, which will sort the redirect to . If any other language code is used in the first parameter, then the printworthy parameter is disabled. Those are the times when editors will have to choose between using R printworthy or R unprintworthy.

Language codes
The following links are to pages that show the two-, three- or four-letter language codes that this rcat has used and uses now to sort redirects to specific-language categories. For complete lists of language codes, see the navbar below.


 * Listings in ALPHABETICAL order by...
 * LANGUAGE
 * Language CODE

Language codes are also usually found in the infoboxes at the top of language articles in Wikipedia.

TemplateData
{	"params": { "1": {			"aliases": [ "from", "lang" ],			"label": "Current language", "description": "The redirect title's language ISO 639 code or IETF language tag.", "example": "fr", "type": "string", "default": "und" },		"2": {			"aliases": [ "to" ],			"label": "Target language", "description": "The redirect target's language ISO 639 code or IETF language tag.", "example": "en", "type": "string", "default": "und" },		"printworthy": { "label": "Printworthy", "description": "A yes/no value indicating whether this redirect is printworthy (only valid when the current title's language is \"en\").", "type": "string" }	},	"format": "inline" }