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 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 2 is always displayed as-it-is, with namespace if any is specified.

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

Addressing categories within the commons

The standard inclusion is without any prefix and without a namespace. No test occurs, redlinks can result.

When parameter 3 is either X or x, or when a namespace is encountered, a check for existence is performed.
When the category exists either with or without namespace the following is the existing category.

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}} produces [[:Category:|]]
• {{C||error}} produces [[:Category:|error]]

• {{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

• {{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

Not-existing category with elements (difficult to find an example, try one of Special:WantedCategories)

• {{C|Redes||X}} produces Redes
• {{C|redes|Red_Link|x}} produces [[Category:Red_Link]]

Single and double namespace prefix:

• {{C|Commons:Multimedia Features/MediaViewer}} produces Commons:Multimedia Features/Media Viewer
• {{C|Category:Commons:Multimedia Features/Media Viewer}} produces Category:Commons:Multimedia Features/Media Viewer

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