Template:Birdgloss/doc

The template is used to easily create a link from a word or phrase in any article to a corresponding entry in the Glossary of bird terms, a stand-alone glossary list article. Example:.

Using is a more concise way of doing. and provides a mouse-hover tooltip indicating that the link goes to a glossary entry (this does not interfere with page previews or navigation popups). The template takes one or two parameters, as detail below.

The template makes proper use of the  HTML element (as documented at the parent meta-template, ). For linking between entries inside the glossary itself, use, which does not use that element (it is reserved for term entries in the glossary). It can also be used in other articles where the same term is linked twice because of article length ( should only be used once per term per page, as it means "this is the defining instance of this term on this page").

Usage
Syntax: From an article to the glossary: If the text being linked matches the name of (or an anchor present at) the glossary entry, regardless of upper or lower case, you can simply do:

It will also handle suffixes like plurals, etc., added onto it:

From inside Glossary of bird terms itself, to link from one entry to another:

Parameters
The first parameter is the name of the term to be linked to in Glossary of bird terms (or any alias of the term as defined in the glossary with or ). displays as. This will be automatically converted to all-lowercase (as is done by the template being linked to in the glossary); thus  and  and  are functionally equivalent. For cases where this might not be desirable, see no, below.

The second parameter is the visible text string to be wikilinked from in the article ( displays as: ). This parameter is optional, used when this displayed text needs to be different from what is put in the first parmeter (which is displayed by default if the second parameter is absent): and  are functionally equivalent, so prefer the shorter version. Using a capitalized will display as:. But its link goes to the same lowercase "glossary term" target as.

The parameter no (or any other value like n, false) can be used to turn off the automatic lower-casing of the link target, for a case in which the glossary entry is upper-case and someone doesn't want to link to a lower-cased anchor for it (e.g. for a proper name). The upper case anchor must exist in the glossary's code.

Limitations
The first parameter contain wikimarkup, link code, or anything else other than plain text; it is part of a URL.

The second parameter contain wikimarkup, but  contain link code; it is the second half of a piped wikilink.

Examples

 * One parameter:
 * The appearance of a indicates a female bird has entered nesting season.
 * The appearance of a indicates a female bird has entered nesting season.


 * Two parameters:
 * The onset of indicates a female bird has entered nesting season.
 * The onset of indicates a female bird has entered nesting season.


 * Add a suffix (works exactly the same as with a regular wilklink like ) :
 * The appearance of es indicate that female birds have entered nesting season.
 * The appearance of es indicate that female birds have entered nesting season.


 * Capitalize displayed term:
 * es indicate that female birds have entered nesting season.
 * es indicate that female birds have entered nesting season.


 * Link to uppercase glossary term explicitly:
 * The system for plumage nomenclature was not widely adopted.
 * (The template in the glossary will provide a lowercase anchor automatically, so this is not necessary, but can be done if you prefer it.)
 * (The template in the glossary will provide a lowercase anchor automatically, so this is not necessary, but can be done if you prefer it.)