Template:Glossary link/doc

Usage
The template ' and its variant ' ( for short) are templates for creating structured links to particular entries in topical glossaries (e.g. the template).

is a meta-template for creating templates for specific major glossary articles; it is not usually used directly in an article. is usually used directly in the glossary article itself. Please categorize any derived, topical glossary link templates that use this meta-template into Category:Glossary link templates (this is usually done at the bottom of the template's /doc page, so that the category is not inside the template itself and it not accidentally transcluded into the articles that use the template).

The documentation below explains how to use them for your topic's template-structured glossary. Like the wrapper, and the glossary  template, it uses the  HTML element properly. (Note that necessarily does not use it;  should only be used once per term on a single page, at the defining appearance of it.)

creates a normal blue link. To prevent the "sea of blue" effect, uses the light dashed underline style that has become a de facto Web standard for definitional markup.

Tech detail: By using an internal with its own independent   attribute for a tool tip, it sets this up in a way that does not violate the very geeky and backasswards HTML5 specs on the handing of the   attribute of, which is the exact term defined, not its definition.

Due to lack of what would be a pretty sophisticated facility in the MediaWiki parser, there is no way to have the definition in the glossary be pulled into a pop-up tooltip on mouseover, which would be really cool. Maybe someday. For now, it shows the glossary article title (if on another page) and what the entry's name is, as specified by the template, which is where the reader will go if they click on the glossary link. This replaces the default Wikipedia tooltip for such a link, which would only give the article title.

Syntax (basic use cases)

 * Linking from regular article prose to glossary entries:
 * Use a term as it appears in a separate glossary article: – gives:
 * Use an alternative term, linking to the related term in a separate glossary article: – gives:
 * Use a partially piped link:  – gives: s
 * Link targets are converted to lower case by this template and the corresponding in the glossary (the original version as specified in, even if it is "uTriCle", will also work):  – gives:  (note the link target). In other words,   is not necessary.

Normally this is done with a derived, glossary-specific template. For example, can be done simply with.
 * Use a term as it appears in the glossary section of the same article: – gives:
 * Same but less visually intrusive: or  – gives:
 * Use an alternative term, linking to a related term in the glossary section of the same article: – gives:
 * Same but less visually intrusive: or  – gives:

We use the (short name: ) variant to not plaster the page with blue links; ones that go to full articles on terms will thus stand out from links to other short definitions in the same glossary:
 * Linking between glossary entries on the same page:
 * Use a term as it appears within the same glossary page: – gives:
 * Use an alternative term, linking to the related term within the same glossary page: – gives:

Normally this is done with the shortcut;  and  are equivalent. However, in an especially long page, if you run into the parser functions limit, you can use the full-length name to cut down on the count of parser actions, by skipping the redirect translations and going directly to the template.
 * Use a term as it appears on a different page of the same multi-page glossary: – gives:
 * Use an alternative term, linking to the related term on a different page of the same multi-page glossary: – gives:

Syntax (geeky version)

 * results in:
 * results in:
 * results in:
 * results in:
 * results in:
 * results in:

The variant works exactly the same, but is used inside the glossary itself to provide cross-references between entries, and is also used when the same term is linked twice in other articles (e.g. because the article is very long). Its only difference from is that it does not use, since it is only supposed to be used once per page per term, and it does not blue-link the link, since we don't want to create a "sea of blue" link mess.
 * results in:
 * results in:

Parameters
Each version of the template takes up to three case-sensitive, parameters for its data:


 * the title of the glossary article to be linked to
 * This is part of the URL to be generated; it
 * the term entry in the glossary to be linked to (or any  for it)
 * This is part of the URL to be generated; it
 * Glossary-specific templates based on this meta-template need to mention this prominently in their documentation.
 * This parameter can also be done as 1 or the first unnamed parameter. It must not be unnamed when creating a glossary-specific template from the meta-template, because you cannot guarantee that input will not contain a = character.
 * the actual text in the article to be linked from, if different from the term linked to
 * This parameter can be styled, templated, etc. (though cannot contains links – it's going to become the link). Styling can also be applied before and after the entire template, of course.

Limitations : The glossary and term parameters cannot have any HTML or wiki markup; they are basically parts of URLs (namely ).

A color parameter allows the color of the text to be changed. This should only be done when the rest of the text is also another color for some reason, e.g. because of white text in a dark-background table cell in a navbox or infobox. The parameter will accept established HTML/CSS color names (e.g. ) and hex values (e.g.  ), and is spelled " " since this is the spelling used by HTML and CSS.

Some little-used parameters that are there just in case:


 * an_ID – an anchor ID (no spaces, must begin with alphabetic letter) for #linking and possibly other purposes
 * arbitrary:css; – CSS directives for custom-styling the instance
 * css_class – a CSS class or classes (separated by spaces not commas if more than one); by default it already include  or   (in the template with the respectively matching name) for custom user CSS.

Example code
The template for cue sports:

The variant is used  such an article as Glossary of cue sports terms:

For real-world application, see Template:Cuegloss/doc, the Glossary of cue sports terms article, and articles like Nine-ball that use the template to link to terms in the glossary.