View source for Template:Gloss/doc

{{Documentation subpage}}

==Usage==
Use this template to apply the correct styling to a [[Gloss (annotation)#In linguistics|gloss]], given as the first (and often only) parameter.

*Based on linguistic standards, for linguistic material
*Based on default [[WP:Manual of Style]] expectations, out of a linguistic context
*Adjustable in [[Help:User style|user stylesheets]] 

'''Typical usage:'''

{{in5}}<code><nowiki>Foreign term {{gloss|English term}}</nowiki></code>

E.g.:

{{in5}}<code><nowiki>{{langx|es|casa}} {{gloss|house}}</nowiki></code>

yields:

{{in5}}{{langx|es|casa}} {{gloss|house}}

'''With parentheses (round brackets):'''

See below for when to use this option.

{{in5}}<code><nowiki>Technical or ambiguous term {{gloss</nowiki>'''|mode=def'''<nowiki>|contextual plain-English meaning}}</nowiki></code>

E.g.:

{{in5}}<code><nowiki>billiards {{gloss|mode=def|cue sports on a pocketless table}}</nowiki></code>

yields:

{{in5}}billiards {{gloss|mode=def|cue sports on a pocketless table}}

===Inline glosses===
Most translations and definitions are worded as ''glosses''.  That is, the words in the definition or translation function with the same part of speech and semantics as the defined or translated material.  For example, a contextual gloss of the word ''cats'' (a noun) might be the noun phrase ''members of the family [[Felidae]]'' (to distinguish it from the narrow meaning ''domestic cats''), and a translating gloss of the Spanish verb {{lang|es|vivir}} is a verb phrase in English, ''to live''.  Some terms are difficult or impossible to define with a gloss.  For example, one of the definitions of the word ''of'' in English that a dictionary could give might be ''Connects a noun derived from a verb with the object of that verb''.<ref>as in "[[The Taming of the Shrew|The Taming {{bracket|noun}} {{strong|of}} the Shrew {{bracket|object}}]]" cf. "he {{bracket|subject}} tames {{bracket|verb}} the shrew {{bracket|object}}."</ref>  That definition is not a gloss, because the words in the definition cannot be used as a substitute for ''of''.

[[WP:Wikipedia is not a dictionary|Wikipedia is not a dictionary]], and thus we do not usually specially format glosses (or non-gloss explanations) of terms or concepts in any particular way, but present this content as best fits the context:
* {{xt|The flower is available in many specific [[cultivar]]s.}}
* {{xt|The flower is available in many specific cultivated varieties ([[cultivar]]s).}}
* {{xt|The flower is available in many specific [[cultivar]]s (cultivated varieties).}}
* {{xt|The flower is available in many specific [[cultivar]]s (short for ''cultivated varieties'').}}
* {{xt|The flower is available in many specific cultivated varieties, technically termed ''[[cultivar]]s''.}}
* And so on.

There are some exceptions, where a consistent approach can be helpful:

# In the presentation of translations of non-English content into English, it is useful to both readers and editors to consistently distinguish meaning, as in {{xt|1=[[Lao language|Lao]]: {{lang|lo-Latn|khwaay}} 'water buffalo'}}, from other annotations, as in {{xt|1=[[Lao language|Lao]]: {{lang|lo-Latn|khwaay}} {{smallcaps|noun}}}}, or {{xt|1=[[Lao language|Lao]]: {{lang|lo-Latn|khwaay}} ({{lang|th-Latn|kwai}} in [[Thai language|Thai]])}}. '''Standard linguistic practice (and WP practice – see [[MOS:SINGLE]]) is to place English translation glosses of foreign terms in 'single quotation marks', non-italicized, non-bracketed, and without intervening punctuation (e.g. comma); and to italicize the non-English original (see [[MOS:FOREIGN]]).'''  This is the default behavior of this template: <code><nowiki>[[Lao language|Lao]]: {{lang|lo-Latn|khwaay}} {{gloss|water buffalo}}</nowiki></code> produces: [[Lao language|Lao]]: {{lang|lo-Latn|khwaay}} {{gloss|water buffalo}} – without need of any further parameters.
# When glossing a literal but ambiguous English translation (itself a different kind of gloss), to make the meaning clearer: {{xt|{{langx|vi|trâu}} 'water buffalo' (domestic water buffalo, ''[[Bubalus bubalis]]'')}}, since "water buffalo" by itself could be misinterpreted as inclusive of the wild species. This additional kind of gloss is most often put in parentheses (round brackets), and is not italicized in most contexts. (They are italicized or otherwise distinguished in some dictionaries, for distinction from the definition as such.) The typical non-italicized use is the second of this template's basic functions: <code><nowiki>... playing billiards {{gloss|mode=def|cue sports on a pocketless table}} ...</nowiki></code> produces: "... playing billiards {{gloss|mode=def|cue sports on a pocketless table}} ...".  If this use of the template becomes common, it will be possible for [[Help:User style|user stylesheets]] to hide them for more concise presentation (e.g. on mobile devices) or perhaps a [[Wikipedia:Gadget]] to toggle display/hide mode on the fly.
# When quickly explaining jargon, slang, or other possibly unfamiliar wording, and without need for elaboration, the use of parentheses is the most common and concise approach, and usually the least likely to lead to a comprehension difficulty: {{xt|cultivars (cultivated varieties)}}, or {{xt|cats (felids)}} vs. {{xt|cats (domesticated felines)}}. Note that the ''or'' format can easily imply an alternative term instead of a gloss, and is frequently confused for this reason: {{xtg|cats or felids}}. The use of double quotation marks can easily be misinterpreted as skepticism or sarcasm, whichever direction they are applied: {{xtg|cultivar ("cultivated variety")}} and {{xtg|cultivated variety ("cultivar")}}. The use of italics for ''[[words as words]]'' can similarly lead to difficulty, such as applying the wrong style to a taxonomic group that is never italicized, as in {{!xt|cats (''[[Felidae]]'')}}, or being misinterpreted as {{em|emphasis}} or as a ''{{lang|fr|terme non-anglais}}'' (non-English term). This is another case for use of {{tlx|gloss|mode{{=}}def|...}}.

==Interlinear glosses==

Other templates have been provided for [[interlinear gloss]]ing:
* Use {{tlx|interlinear}} for glossed text
* Use {{tlx|gcl}} for individual glossing abbreviations

However, {{tlx|gloss}} can technically be used (possibly awkwardly) to provide glosses (the bottom line) of an interlinear gloss.

It is not presently suited for a gloss spread out over several table columns, because it generates 'single quotes' on each use. A parameter could be added to suppress this, but may never be needed since we have {{tlx|interlinear}}.

===Don't over-do it===
Regardless what template you use, please note that excessively complex interlinear glosses (such as might be found in a linguistics journal paper) are usually ''not appropriate'' in an encyclopedia. As the ''Leipzig Glossing Rules'' states: "Depending on the author's purposes and the readers' assumed background knowledge, different degrees of detail will be chosen."<ref name="Leipzig">{{cite web |title=Leipzig Glossing Rules: Conventions for interlinear morpheme-by-morpheme glosses |author=
Department of Linguistics |publisher=Max Planck Institute for Evolutionary Anthropology |version=Revised Version |date=February 2008 |url= https://www.eva.mpg.de/lingua/resources/glossing-rules.php |access-date=9 September 2015}}</ref> Our readers have {{em|zero assumed background knowledge}} other than enough English-language competence to get the gist of articles on the English Wikipedia. Many of our readers are elementary school children, and learners of [[English as a second language]] (ESL). Even a native speaker with a masters degree may have no knowledge of linguistics jargon. 

In most contexts, it is thus not necessary, and may be confusing, to provide a great deal of metalanguage ''morpheme-by-morpheme correspondence'' information, between the original text and the free English gloss (much less to mix such information into the gloss).

When such information is provided, e.g. in an article on detailed linguistic matters, link at least the first occurrence of standardized linguistics abbreviations (given in {{sc|smallcaps}}) to the corresponding article about that feature of language, as in: {{xt|stay-[[Future tense|{{sc|FUT}}]]-[[Affirmative and negative|{{sc|NEG}}]]}}.  Use the {{tlx|gcl}} template, as it was created to do this without having to resort to a bunch of manual markup.

Interlinear glosses of any complexity are best arranged in a bare table, to preserve vertical alignment between elements.

==See also==
* {{tlx|translation}} - For cases where it isn't obvious that the word is a translation, or when ambiguity isn't preferred, such as translating titles of works.
* {{tlx|Literal translation}} or {{tlx|Lit}} - similar template but with a "lit." lead-in.
* {{tlx|Language with name/for}} or {{tlx|Langnf}}

==References and further reading==
{{reflist|refs=
<ref name="Leipzig"/>
}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Language formatting and function templates]]
[[Category:Translation templates]]
}}</includeonly>