Template:For multi/doc
 | Uses Lua: |
{{For multi}} is a commonly used hatnote template on Wikipedia, recently imported to Commons. It should be placed at the top of an page, linking the reader to other pages with similar titles or concepts that they may have been seeking instead.
This template is meant as a version of {{For2}} for cases of multiple specific uses. It works similarly to {{About}}, but without the leading "about".
{{For multi}} is a hatnote template that produces a list of alternative uses for the title of the article and links to articles about those uses. It is similar to {{For2}} with the primary difference being this template allows multiple uses to be listed while still being able to link to multiple articles per use. It is essentially the same as {{About}} but without the "about" clause at the start.
Usage
[edit]0 parameters
[edit]When no parameters are provided, this template functions the exact same as {{Other uses}}. It is preferred to use that template as it more clearly explains the output of the function.
The output with zero parameter {{For multi}} is:
1 or 2 parameters
[edit]When one or two parameters are provided, this template functions the exact same as {{For2}}. It is preferred to use that template as the "multi" functionality of this template is not required.
1 Parameter
[edit]With one parameter, {{For multi|UseA}} yields:
This is identical to passing the same arguments to {{For2}}. For example, {{For2|UseA}} yields:
2 Parameters
[edit]With two parameters, {{For multi|UseA|ArticleA}} yields:
This is identical to passing the same arguments to {{For2}}. For example, {{For2|UseA|ArticleA}} yields:
3 or more parameters
[edit]When three or more parameters are provided, this template can be used. Functionally, it is the same as {{About}}, but without the about clause at the beginning.
With three parameters, the output of
- {{For multi|UseA|ArticleA|UseB}}
is:
The output of {{For multi|UseA|ArticleA|UseB}} is different from {{For2}} provided with three parameters where {{For2|UseA|ArticleA|ArticleB}} yields:
With four parameters, the output of
- {{For multi|UseA|ArticleA|UseB|ArticleB}}
is:
As one can see, this function is able to output multiple uses, unlike {{For2}}. {{About}} also produces the same output, but with an "about" clause at the beginning. For example, {{About|About|UseA|ArticleA|UseB}} yields:
Technically, {{About}} can be used by passing an empty first parameter, but this is not recommended as the wikitext {{((}}About||UseA|ArticleA|UseB}} does not clarify what the output will be and what the purpose of the template is since, in this case, the name of the template "About" is misleading. Using it this way would look like:
Multiple articles per use
[edit]Multiple articles can be used per use by putting a parameter with the content and between them. For example, the wikitext
- {{For multi|UseA|ArticleA|and|ArticleB|and|ArticleC|UseB|ArticleD|...}}
yields:
Last parameter
[edit]When the last parameter is a "use", the current article plus (disambiguation) will be linked to at the end of the template. For example,
- {{For multi|UseA|ArticleA|UseB}}
yields:
This also works if the last parameter is simply "other uses":
- {{For multi|UseA|ArticleA|UseB|ArticleB|other uses}}
which yields:
Both of the above examples produce a link to Template:For multi/doc (disambiguation) at the end.
See also
[edit]Templates linking contents
[edit]"1-N" means from one to many.
- Upwards links
- – "Main gallery" link from gallery or category to 1-N main galleries.
- – "Main category" link from gallery or category to 1-N main categories.
- – (box) Alternative "See category" boxed link from gallery to parent category, with explanation of the role of a gallery page.
- Downwards links
- – "Further information" link to 1-N detailed galleries or categories.
- Sideways page links
- – (box or inline) "See also" link to 1-N related pages.
- – "For" a single alternative page with explanation.
- - "For" 1-N alternative pages with one or more explanations.
- – As "For2" with an explanation of the current page.
- - As "For multi" with an explanation of the current page.
- – "Not to be confused with" link to 1-N related pages.
- – (box) Internationalized "See also" (or other caption) to related images.
- – (box) Internationalized with icon-links to related images of the same (medical) case.
- – "See" link from gallery to gallery.
- Sideways category links
- – (box or inline) "See also Categories" link to 1-N related categories.
- – (box or inline) "Not to be confused with categories" link from category with ambiguous names to 1-N unrelated categories.
- Interproject links
- – "Main Wikipedia article" link to 1 article (don't forget the purpose of interwiki links).
- – "See also Wikipedia article" link to 1-N articles (don't forget the purpose of interwiki links).
- Template:Multilingual link – allows to indicate names of versions of same Wikipedia article in many languages and displays one link in interface language.