Root: 1 revision imported

2020-09-15T19:00:17Z

1 revision imported

Mediawiki>Benwing2 at 19:19, 22 August 2020

2020-08-22T19:19:11Z

New page

{{documentation subpage}}
This is used to show inline usage examples (not quotations) following a definition line. The actual work is delegated to [[Module:usex/templates]] and [[Module:usex]].
See [[WT:USEX]] for some general guidelines regarding usage examples.

The template call {{temp|uxi|...}} works identically to {{temp|ux|....|inline=1}}. It is intended for usage examples that are short enough that the example, its transliteration (if needed) and any idiomatic or literal translations can all fit on a single line, separated by em dashes.

==Parameters==
; {{para|1}}
: The language code of the example to be shown, e.g. <tt>en</tt> for English; see [[WT:LANGLIST]] for the full list.
; {{para|2}}
: The example to be shown. It should not contain wikilinks.
; {{para|3}}, {{para|translation}} or {{para|t}}
: The English translation for examples on foreign entries.
; {{para|tr}} or {{para|transliteration}}
: The Latin transliteration for examples in non-Latin script.
; {{para|sc}}
: The script code, required for certain languages with multiple possible scripts; see [[Wiktionary:List of scripts]] for the full list.
; {{para|q}}, {{para|qN}} or {{para|qualifier}}, {{para|qualifierN}}
: To include a qualifier for the example. You can specify multiple qualifiers using q2=, q3=, etc.
; {{para|ref}}
: To include a reference or link to an originating external site.
; {{para|lit}}
: A literal translation.
; {{para|subst}}
: Substitutions to be applied to handle irregular transliterations in certain languages (e.g. Russian, Yiddish, Hindi). If specified, should be one or more substitution expressions separated by commas. Each substitution expression is of the form <code>FROM//TO</code> (<code>FROM/TO</code> is also accepted), where <code>FROM</code> is the source text as found in the example, and <code>TO</code> is the corresponding respelling in the source script (e.g. Cyrillic, Hebrew or Devanagari). The substitutions are applied in order and before transliteration. The idea is to phonetically respell words with irregular transliteration so that the transliteration comes out correctly, without the need to manually transliterate the entire example using {{para|tr}}. Note that <code>FROM</code> and <code>TO</code> are actually Lua patterns (see [[WT:LUA]]). This means, for example, that a hyphen in the source text needs to be "escaped" by writing it as <code>%-</code>. See below for an example of using this parameter. Other examples may be found in the documentation for {{temp|usex}} and {{temp|quote}}.
; {{para|noenum}}
: To use in unnumbered sections (not following a definition). It may start the line following the definition or may be prefixed by "<code>#:</code>" for visual aesthetics.
; {{para|sort}}
: Sortkey. Add this only when the sortkey cannot be generated from the entry name.

Usage examples are normally preceded by "<code>#:</code>", or by "<code>#*</code>" or "<code>#*:</code>" to hide the usage example (normally used for direct quotes).

==Examples==
'''Wikitext''' (from {{cog|tg|китоб}})
<pre># [[book]]
#: {{uxi|tg|Ин '''китобро''' хондам.|I read this '''book'''.}}</pre>

'''Output'''
# [[book]]
#: {{uxi|tg|Ин '''китобро''' хондам.|I read this '''book'''.}}

'''Wikitext''' (from {{cog|eo|indiki}})
<pre># to [[indicate]]
#: {{uxi|eo|La forta vento '''indikas''' ke ŝtormo venas.|The strong wind '''indicates''' that
a storm is coming.|ref=<ref>http://tatoeba.org/eng/sentences/show/454290</ref>}}

===References===
<references/></pre>

'''Output'''
# to [[indicate]]
#: {{uxi|eo|La forta vento '''indikas''' ke ŝtormo venas.|The strong wind '''indicates''' that a storm is coming.|ref=<ref>http://tatoeba.org/eng/sentences/show/454290</ref>}}

===References===
<references/>

'''Wikitext''' (from {{cog|eo|kelkaj}})
<pre># {{inflection of|kelka||p|lang=eo}}
## [[a few]]
## [[several]]
##: {{uxi|eo|'''Kelkaj''' el iliaj ovoj estas malbonaj.|'''Several''' of their eggs are bad.}}</pre>

'''Output'''
# {{inflection of|eo|kelka||p|nocat=1}}
## [[a few]]
## [[several]]
##: {{uxi|eo|'''Kelkaj''' el iliaj ovoj estas malbonaj.|'''Several''' of their eggs are bad.}}

'''Wikitext'''
<pre>#: {{uxi|fr|cousu de fil blanc|blatantly obvious|lit=sewn with white thread}}</pre>

'''Output'''
#: {{uxi|fr|cousu de fil blanc|blatantly obvious|lit=sewn with white thread}}

'''Wikitext'''
<nowiki>#: {{uxi|ru|Полицейские огородили середину шоссе́ на гора́х.|Police officers blocked the middle of the highway.|subst=шоссе́//шоссэ́}}</nowiki>

'''Output'''
#: {{uxi|ru|Полицейские огородили середину шоссе́ на гора́х.|Police officers blocked the middle of the highway.|subst=шоссе́//шоссэ́}}

'''Wikitext'''
<nowiki>#: {{uxi|de|fließen|to flow|q=Germany}}</nowiki>
<nowiki>#: {{uxi|de|fliessen|to flow|q=Switzerland|q2=Liechtenstein}}</nowiki>

'''Output'''
#: {{uxi|de|fließen|to flow|q=Germany}}
#: {{uxi|de|fliessen|to flow|q=Switzerland|q2=Liechtenstein}}

==See also==
* [[WT:USEX]]
* [[Module:usex]]
* [[Module:usex/templates]]
* {{temp|ux}} – used for longer usage examples
* {{temp|quote}} – used for quotations

==TemplateData==
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "language code",
"description": "The language code of the example to be shown",
"example": "en",
"type": "string",
"required": true,
"suggested": true
},
"2": {
"label": "example",
"description": "The example to be shown. Use '''bold''' to highlight the current term.",
"example": "The quick brown '''fox''' jumps over the lazy dog.",
"type": "string",
"required": true,
"suggested": true
},
"3": {
"aliases": [
"t",
"translation"
],
"label": "translation",
"description": "The English translation for examples on foreign entries. Use '''bold''' to highlight the current term's translation.",
"example": "Le rapide '''renard''' brun saute par dessus le chien paresseux.",
"type": "string"
},
"tr": {
"label": "transliteration",
"type": "string",
"description": "The Latin transliteration for examples in non-Latin script."
},
"sc": {
"label": "script code",
"type": "string",
"description": "The script code, required for certain languages with multiple possible scripts.",
"example": "Latn"
},
"q": {
"label": "qualifier",
"type": "string",
"description": "To qualify an example with a region or register, or a type of usage.",
"example": "informal"
},
"ref": {
"label": "reference",
"description": "To include a reference or link to an originating external site.",
"type": "url"
},
"lit": {
"label": "literal translation",
"type": "string",
"description": "A literal translation of an idiomatic expression in a foreign language.",
"example": "to fly like plywood over Paris"
},
"subst": {
"label": "substitution",
"type": "string",
"description": "Substitutions to be applied to handle irregular transliterations in certain languages (e.g. Russian and Yiddish; see example above). If specified, should be one or more substitution expressions, where each substitution expression is of the form FROM//TO (FROM/TO is also accepted), where FROM is a Lua pattern and TO is the corresponding replacement expression. The substitutions are applied in order and before transliteration; hence both FROM and TO should be in the source script (e.g. Cyrillic or Hebrew).",
"example": "шоссе́//шоссэ́"
},
"noenum": {
"label": "noenum",
"description": "To use in unnumbered sections (not following a definition). It may start the line following the definition or may be prefixed by \"<code>#:</code>\" for visual aesthetics.",
"type": "boolean",
"example": "true"
}
},
"description": "This is used to show inline usage examples (not quotations) following a definition line. ",
"format": "block"
}
</templatedata>

<includeonly>

[[Category:Definition templates]]
</includeonly>

← Older revision	Revision as of 19:00, 15 September 2020
(No difference)

uxi/documentation - Revision history

Root: 1 revision imported

Mediawiki>Benwing2 at 19:19, 22 August 2020