Difference between revisions of "Template:Lang-grc-x-medieval/doc"

From blackwiki
Jump to navigation Jump to search
imported>GoingBatty
m (→‎Important metadata: typo(s) fixed: i.e: → i.e.: using AWB (11376))
imported>Pauli133
m (fixing lint errors)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
{{hatnote|'''This template is for tagging [[Medieval Greek]] (about 600-1500 AD) text only!''' – for Modern Greek, see {{tlx|lang-el}} and for Ancient Greek, see {{tlx|lang-grc}} instead. For custom labels, no labels, or other uses, see {{tlx|lang}}.}}
+
{{hatnote|'''This template is for tagging [[Medieval Greek]] (about 600-1500 AD) text only!''' – for Modern Greek, see {{tlx|lang-el}} and for Ancient Greek, see {{tlx|lang-grc}} instead. For custom labels, no labels, or other uses, see {{tlx|lang}}.}}
  
 
== Usage ==
 
== Usage ==
Line 9: Line 9:
 
::{{tlc|lang-gkm|Συρακοῦσαι|Surakoũsai|Syracuse}}
 
::{{tlc|lang-gkm|Συρακοῦσαι|Surakoũsai|Syracuse}}
 
produces the following HTML:
 
produces the following HTML:
::<code><nowiki><a href="/wiki/Medieval_Greek" title="Medieval Greek">Medieval Greek</a>:</nowiki><br />
+
::<code><nowiki><a href="/wiki/Medieval_Greek" title="Medieval Greek">Medieval Greek</a>:</nowiki><br /></code>
::<nowiki><span </nowiki>'''lang="gkm" xml:lang="gkm"'''<nowiki>>Συρακοῦσαι</span></nowiki><br />
+
::<code><nowiki><span </nowiki>'''lang="gkm" xml:lang="gkm"'''<nowiki>>Συρακοῦσαι</span></nowiki><br /></code>
::<nowiki><span title="Medieval Greek transliteration" class="Unicode" style="white-space:normal; text-decoration: none"><i>Surakoũsai</i></span></nowiki><br />
+
::<code><nowiki><span title="Medieval Greek transliteration" class="Unicode" style="white-space:normal; text-decoration: none"><i>Surakoũsai</i></span></nowiki><br /></code>
::<nowiki>"Syracuse"</nowiki></code>
+
::<code><nowiki>"Syracuse"</nowiki></code>
  
 
This [[metadata]] identifies the enclosed text as Medieval Greek for the benefit of search engines, browsers, screen readers, translators, typesetters, and so on. To these "non-human readers", Medieval Greek (encoded as "gkm") has important distinctions from Modern Greek (appropriately encoded using "ell", "gre" or "grk" by other {{tlx|lang}} templates). '''For that reason, this template should never be used with Modern or Ancient or other Greek text'''.
 
This [[metadata]] identifies the enclosed text as Medieval Greek for the benefit of search engines, browsers, screen readers, translators, typesetters, and so on. To these "non-human readers", Medieval Greek (encoded as "gkm") has important distinctions from Modern Greek (appropriately encoded using "ell", "gre" or "grk" by other {{tlx|lang}} templates). '''For that reason, this template should never be used with Modern or Ancient or other Greek text'''.
Line 19: Line 19:
 
:'''<nowiki>{{lang-gkm</nowiki>'''
 
:'''<nowiki>{{lang-gkm</nowiki>'''
 
::'''|{{var|Medieval Greek text}}''' – using the Greek [[polytonic]] alphabet (with [[Greek diacritics|diacritics]]). ''(mandatory) – must be the 1st field''
 
::'''|{{var|Medieval Greek text}}''' – using the Greek [[polytonic]] alphabet (with [[Greek diacritics|diacritics]]). ''(mandatory) – must be the 1st field''
::'''|{{var|transliterated text}}''' – the same text, [[transliterated]] using Latin alphabet (see [[Romanization of Greek]]). ''(optional) – must be the 2nd field or the parameter “tli” (“'''t'''rans'''li'''teration”)''
+
::'''|{{var|transliterated text}}''' – the same text, [[transliterated]] using Latin alphabet (see [[Romanization of Greek]]). ''(optional) – must be the 2nd field or the parameter “tli”&nbsp;(“'''t'''rans'''li'''teration”)''
::'''|{{var|translated text}}''' – in English. ''(optional) – must be the 3rd field or the parameter “tla” (“'''t'''rans'''la'''tion”)''
+
::'''|{{var|translated text}}''' – in English. ''(optional) – must be the 3rd field or the parameter “tla”&nbsp;(“'''t'''rans'''la'''tion”)''
 
:'''<nowiki>}}</nowiki>'''
 
:'''<nowiki>}}</nowiki>'''
  

Revision as of 21:27, 30 April 2018

Usage

The primary objective of this template (and of the other {{lang}} templates) is to tag non-English text so that both human and machine readers are able to properly interpret, display and understand non-English text as part of an effort to move towards a semantic web. To that end, proper use of these templates help web browsers to choose the correct display font, text-to-speech screen readers to select a more appropriate pronunciation, search engines to better index and relate the context of the content, translation services to properly interpret the words, spell checkers to properly allow and/or require diacritics, and so on.

Important metadata

Regardless of the label that is displayed in front of the text (i.e.: "Medieval Greek:" vs. "Greek"), this template will always wrap the supplied Medieval Greek text inside of appropriate HTML <span>...</span> tags – that is to say that the Medieval Greek text will be tagged using the ISO-639-3 language code for Medieval Greek: "gkm". The following example wikicode:

{{lang-gkm|Συρακοῦσαι|Surakoũsai|Syracuse}}

produces the following HTML:

<a href="/wiki/Medieval_Greek" title="Medieval Greek">Medieval Greek</a>:
<span lang="gkm" xml:lang="gkm">Συρακοῦσαι</span>
<span title="Medieval Greek transliteration" class="Unicode" style="white-space:normal; text-decoration: none"><i>Surakoũsai</i></span>
"Syracuse"

This metadata identifies the enclosed text as Medieval Greek for the benefit of search engines, browsers, screen readers, translators, typesetters, and so on. To these "non-human readers", Medieval Greek (encoded as "gkm") has important distinctions from Modern Greek (appropriately encoded using "ell", "gre" or "grk" by other {{lang}} templates). For that reason, this template should never be used with Modern or Ancient or other Greek text.

Syntax

{{lang-gkm
|Medieval Greek text – using the Greek polytonic alphabet (with diacritics). (mandatory) – must be the 1st field
|transliterated text – the same text, transliterated using Latin alphabet (see Romanization of Greek). (optional) – must be the 2nd field or the parameter “tli” (“transliteration”)
|translated text – in English. (optional) – must be the 3rd field or the parameter “tla” (“translation”)
}}

Examples

Code Result
{{lang-gkm|Συρακοῦσαι}} Medieval Greek: Συρακοῦσαι
{{lang-gkm|Συρακοῦσαι|Surakoũsai}} Medieval Greek: Συρακοῦσαι, romanized: Surakoũsai
{{lang-gkm|Συρακοῦσαι|Surakoũsai|Syracuse}} Medieval Greek: Συρακοῦσαι, romanized: Surakoũsai, lit. 'Syracuse'
{{lang-gkm|Συρακοῦσαι|tla=Syracuse|tli=Surakoũsai}} Medieval Greek: Συρακοῦσαι
{{lang-gkm|Συρακοῦσαι| |Syracuse}}  Medieval Greek: Συρακοῦσαι, lit. 'Syracuse' 
{{lang-gkm|Συρακοῦσαι|tla=Syracuse}}  Medieval Greek: Συρακοῦσαι 

Category

Articles using this template are automatically placed in Category:Articles containing Medieval Greek-language text.

References

See also

  • {{lang-grc}} for Ancient Greek.
  • {{lang-el}} for Modern Greek.
  • {{lang-ell}} for Modern Greek explicitly stated and linked so in the label.
  • {{lang-grc-gre}} for which the Ancient Greek description is not satisfactory or limiting.
  • {{lang|el}} and {{lang|ell}} tags Modern Greek text, without the label (for use with custom display, and other uses).
  • {{lang|grc}} tags Ancient Greek text, without the label (for use with custom display, and other uses).
  • {{transl|gkm}} tags text as "Medieval Greek Transliteration" (has no visible effect other than said tag when pointer is placed on text).