Template:C/doc

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:C.

---

Links to a category, either within the Commons or to another Wikipedia

Usage

{{C |1= |2= |3= }}

Template parameters

Parameter	Description		Default	Status
1	category name, with or without a namespace		empty	required
2	link text to display (instead of category name)		param. #1	optional
3	The 3rd parameter establishes either interwiki access, with any language code, or a link to a category not on Commons, always with check for existence existing categories are linked and displayed non-existing categories are not linked, but displayed (not specified): text is displayed in black color if 3=x (lower case): text is displayed in red color if 3=X (upper case): display with red background		empty	optional

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

Localization

This template is not intended to be localized.

Usage

The template will display {{{2}}}, or just the category name given as {{{1}}}.

The text string in parameter 1 or 2 is displayed as-it-is, with namespace if any was specified.

The function is different for internal access within the commons, and for interwiki access.

Addressing categories within the commons

First of all, always a check for existence is performed.

When the category exists, code is implemented as:

[[:Category:{{{1}}}|{{{2|{{{1}}}}}}]]

When the category does not exist but has elements assigned, a "red link" will be generated:

[[:Category:{{{1}}}|{{{2|{{{1}}}}}}]]

Otherwise if the category {{{1}}} does not exist no link will be generated;

[[Category:{{{1}}}]] or [[Category:{{{2}}}]] is displayed

[[Category:{{{1}}}]] or [[Category:{{{2}}}]] is displayed when {{{3}}} = x

{{{1}}} or {{{2}}} will get background color when {{{3}}} = X

example

• {{C|Internal link templates}} produces Internal link templates
• {{C|Internal link templates|}} produces Internal link templates
• {{C|Internal link templates|C:''display''text}} produces C:displaytext

(difficult to find an example, try one of Special:WantedCategories)

• {{C|Redes}} produces Redes
• {{C|redes|Red_Link}} produces Red_Link

• {{C|Not-existing-cat}} produces Not-existing-cat
• {{C|Not-existing-cat|display}} produces display
• {{C|Not-existing-cat|3=x}} produces [[Category:Not-existing-cat]]
• {{C|Not-existing-cat|display-cat|x}} produces [[Category:display-cat]]
• {{C|Not-existing-cat|3=X}} produces Not-existing-cat
• {{C|Not-existing-cat|displayname|X}} produces displayname

Interwiki access

It is not possible to check for existence in other Wikipedias.
The link is always established, whether the category exists or not.

• {{C|Main||en}} or {{C|Main|3=en}} produces Main
• {{C|Wikipedia:Hilfe|German help pages|de}} produces German help pages
• {{C|Accueil|Catégorie:Accueil|fr}} produces Catégorie:Accueil
• {{C|Kangxi radicals||wiktionary}} produces Kangxi radicals
• {{C|Wikcionario:Apéndices|Categoría:Apéndices|wiktionary:es}} produces Categoría:Apéndices