ထာမ်ပလိက်:Glossary/doc
 | This is a documentation subpage for Template:Glossary and Template:Glossary end. It contains usage information, categories and other content that is not part of the original ထာမ်ပလိက် page. |
Usage
ပလေဝ်ဒါန်The template {{glossary}} (a.k.a. {{glossary start}} or {{glossary begin}}) is used with {{glossary end}} to explicitly bracket a glossary or glossary-like description list (also called a definition list or association list), especially in a template-structured glossary, although such lists can be used more generally. This is required (as a technical matter) for template-structured glossaries, and is good practice anywhere description/definition lists are used for glossaries. The template pair invoke the <dl>...</dl> description list HTML element. Unfortunately, the "{{dl}}" mnemonic is not available as a redirect as of this writing.
The pair of templates incidentally prevent Wikipedia's MediaWiki software engine from auto-creating redundant definition list code (<dl>...</dl>) around terms and definitions if they have blank lines between them, as they often do, especially in non-structured glossaries.
Typical usage:
{{glossary}} {{term}} {{defn}} {{glossary end}}
Parameters
|id=can be used to assign a one-word ID name to the glossary. This can be used as a#idlink target, and could have other metadata uses.|style=will pass CSS styling on to the<dl>element. I.e., this styles the definition list itself, as a container, not the individual terms and definitions with it. There is rarely any reason to do this.|class=will pass one or more space-separate CSS classes on to<dl>element, in addition to the automatically included classglossary. There is rarely any reason to do this.
Examples
This shows both a very simple then a rather complex instance in a structured glossary (including an entry with a block quotation, using the glossary block quotation template, {{gbq}}):
==A–M==
{{glossary}}
{{term|1=applesnorkel}}
{{defn|1=Definition of term 1.}}
{{term|term=arglefarst |content=''{{lang|xx|arglefarst}}''{{anchor|argle-farst|argle farst}} }}
{{defn|no=1 |defn=Beginning of first definition of term 2
{{gbq|1=Block quotation in first definition of term 2.}}
Conclusion of first definition of term 2.
}}
{{defn|no=2 |defn=Second definition of term 2.}}
{{glossary end}}
|
|
Scope
This family of templates, like the underlying definition list code, is primarily intended for definitional uses, but can have other applications. The HTML 4.01 Specification itself says:
Definition lists...generally consist of a series of term/definition pairs (although definition lists may have other applications). Thus, when advertising a product, one might use a definition list:
- Lower cost
- The new version of this product costs significantly less than the previous one!
- Easier to use
- We've changed the product so that it's much easier to use!
- Safe for kids
- You can leave your kids alone in a room with this product and they won't get hurt (not a guarantee).
Thus, editors should feel free to use definition list markup as an alternative to bulleted or numbered lists when the material is well-suited to definition list presentation.
| Usage | ||||||||
|---|---|---|---|---|---|---|---|---|
|
The template Basic usage: Inline templates, reference citations, wikimarkup styles, etc., can be applied to the term in the second parameter (
More complex usage is typically: ထာမ်ပလိက်:Block indent or ထာမ်ပလိက်:Block indent or ထာမ်ပလိက်:Block indent Wiki-styling and linking of the term
If the second or
Style cannot be applied around the template, either, as it is a container for content (the term), not content itself (and doing so will produce invalid markup that will have unpredictable results depending upon browser):
For the same reasons that links to other pages are discouraged in headings, links are discouraged in glossary terms:
Again, as with the first parameter (the term) itself, if the " numbered: ထာမ်ပလိက်:Block indent or named: ထာမ်ပလိက်:Block indent Linking to the term
If your glossary has an unusual case in which one entry and another share the exact same name except for case (thus would get the same lower-cased HTML {{term|term=foo}}
{{defn|Definition of lower-case version here ...
{{term|term=Foo |id=Foo_2 |content={{vanchor|Foo}} }}
{{defn|Definition of proper-name version here ...
You can then link to them as The template As with styled terms, the first parameter must be used to provide the "bare" term, the second to provide this extra markup. It is not necessary to add the term itself to the By contrast, when using semicolon-delimited terms in unstructured glossaries, the term does need to be added explicitly as an anchor if link anchorage is desired (which is almost always the case): ထာမ်ပလိက်:Block indent
or use (Strictly speaking, this fact has nothing to do with this template, but may be of use to editors who are converting from one glossary style to the other.) Multiple terms sharing a definition
Two or more Example: {{term|1=aspirin}}
{{defn|1=A mild analgesic of the non-steroidal anti-inflammatory drug (NSAID) family...}}
{{term|1=heroin}}
{{term|1=diacetylmorphine |multi=y}}
{{term|1=diamorpine |multi=y}}
{{defn|1=A synthetic narcotic drug of the opiate family...}}
{{term|1=ranitidine}}
{{defn|1=An antacid of the proton pump inhibitor family...}}
Languages
To indicate the language of a non-English term, use the This shows no visual change for most languages: For all non-English languages this provides many metadata features, but it is essential for those that do not use the Latin alphabet, so that the content displays properly in various browsers. If it is useful to indicate the name of the language, there are individual templates for most languages, with names based on the ISO codes, and which automatically italicize the foreign content: which renders as:
As detailed above, two or more terms, as variations or alternatives, can share definitions. The most common use case for this is presenting the term in two variants of English. Example:
ထာမ်ပလိက်:Pre
Note the use of Result: ထာမ်ပလိက်:Blockindent In a different format, more appropriate for alphabetical glossaries: Result: That example uses the The Applying CSS styles to the term
The Other parameters
HTML5 update:
Most of the restrictions on the content of
id have been removed, so id values no longer have to begin with an [a-z][A-Z] alphabetic character, avoid most punctuation marks, or suffer other such limitations. Wikipedia's MediaWiki engine is smart enough to auto-escape any problematic characters, on the fly.|id= parameter can be used to assign a one-word, case-sensitive ID name to term. It must be unique on the page. This can be used as another #link target, and could have other metadata uses. By default, the |term= a.k.a. |1= parameter is already set as the ID, and this should rarely be overridden, unless there are two identical terms on the same page creating conflicting IDs. Usually the {{anchor}} template is used to add more link targets to an entry .
The Examples
This shows both a very simple then a rather complex instance:
Images, hatnotes and other content
Images, hatnotes and other "add-in" content intended to immediately follow the
Technical details
What this template does on the technical level is wrap the term in the |
| Usage | |||||||||
|---|---|---|---|---|---|---|---|---|---|
|
The template Basic usage: {{glossary}} {{term|1=term}} {{defn|1=Definition.}} {{glossary end}} Links, inline templates, reference citations, wikimarkup styles, etc., can be applied to the definition. Technically, the
More complex usage is typically:
where Images, hatnotes and other content
Images, hatnotes and other "add-in" content intended to immediately follow the
Multiple definitions for one term
If a single
Because of the uneven length of definitions, it is usually more convenient to put the
or
This is a very robust method, because it permits complex content like block quotations, nested lists, Use of a hatnote with a numbered definition requires manual numbering or it will look weird: {{term|1=blackjack|content=blackjack{{anchor|Blackjack}} }}
{{defn |1={{main|Blackjack}}}}
{{defn|no=1|1=A card game in which players attempt to approach 21 but not exceed it.}}
{{defn|no=2|1=The best possible hand in the game of blackjack, made up of an ace and a card valued at 10 (namely, 10, J, Q, K). }}
Making the definition independently linkable
HTML5 update:
Most of the restrictions on the content of
id have been removed, so id values no longer have to begin with an [a-z][A-Z] alphabetic character, avoid most punctuation marks, or suffer other such limitations. Wikipedia's MediaWiki engine is smart enough to auto-escape any problematic characters, on the fly.{{term}} (or it must be the |id=foo value, if any, used in {{term}}). This must be unique on the page for each term, but should be the same for multiple definitions of the same term). This is done with the {{defn}}'s |term= parameter. This will produce a #-link target ID in the form term-defn#, where the # is the number of the definition (see #Multiple definitions for one term, above), defaulting to "1". Example:
Note that some characters in The IDs ထာမ်ပလိက်:Samp, ထာမ်ပလိက်:Samp, and ထာမ်ပလိက်:Samp are all individually linkable, e.g. as To add more than one linkable anchor, use the {{anchor}} template at the beginning of the definition's content: {{defn|no=2|1=ထာမ်ပလိက်:TlpConsectetur adipisicing elit.|term=blubbermonster}}
Languages
There is no {{glossary}}
{{term|1=Titles of La Vie en Rose in various languages |content=Titles of ''[[La Vie en Rose]]'' in various languages}}
{{defn|1=French: ''{{lang|fr|La Vie en Rose}}''}}
{{defn|1=English: ''Life in Pink''}}
...
{{glossary end}}
Examples
This shows both a very simple then a rather complex instance:
Applying CSS styles to the definition
The Other parameters
The The |
See also
ထာမ်ပလိက်:Glossary templates see also ထာမ်ပလိက်:HTML lists