Nwuan a̱tyin ka a li Ta‌̱mpi‌̱let:Lang-el/doc

{{Documentation subpage}}
{{COinS safe|n}}
{{high-use|18556}}
{{lua|Module:lang}}
{{hatnote|'''This template is only for tagging [[Helen A̱zafwun]] text.''' For Ancient Greek, see {{tlx|lang-grc}}; for Medieval Greek, see {{tlx|lang-gkm}}. For custom labels, no labels, or other uses, see {{tlx|lang}}.}}

==Usage==
{{#invoke:Lang/documentor tool|lang_xx_settings|template={{ROOTPAGENAME}}}}
The primary objective of this template (and of the other {{tlx|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 helps 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'' (e.g.: "Ancient Greek:" vs. "Greek:" vs. "Modern Greek"), this template will ''always'' wrap the supplied Greek text inside of appropriate HTML {{tag|span}} tags – that is to say that the Greek text will be tagged using the [[ISO 639-1]] language code for '''Modern Greek''':  "'''el'''". The following example wikicode:
::{{tlc|lang-el|άτομο}}
produces the following HTML:
::<code><nowiki><a href="/wiki/Greek language" title="Greek language">Greek</a>:</nowiki></code>
::<code><nowiki><span </nowiki>'''lang="el" xml:lang="el"'''<nowiki>>άτομο</span></nowiki></code>

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

== Parameters ==
{{#lst:Template:Lang-x/doc/parameters|lang_xx_parameters}}

==Syntax==
:'''<nowiki>{{lang-el</nowiki>'''
::'''|{{var|Modern Greek text}}''' – using the Greek alphabet (with [[Greek diacritics|diacritics]]). ''(mandatory)''
::'''|{{var|<nowiki>links=value</nowiki>}}''' – valid values: '''yes''' to have the language name linked (default) and '''no''' to prevent the language name from being linked. '' (optional)''
::'''|{{var|<nowiki>lit=string</nowiki>}}''' – valid strings are English translations of the Greek text. ''(optional)''
::'''|{{var|<nowiki>translit=string</nowiki>}}''' – valid strings are transliterations (with the [[Latin script]]) of the Greek text. ''(optional)''
:'''<nowiki>}}</nowiki>'''

==Examples==
:{| class="wikitable"
|-
! Code
! Result
|-
| {{tlf|lang-el|άτομο}}
| {{lang-el|άτομο}}
|-
| {{tlf|lang-el|άτομο|links{{=}}yes}}
| {{lang-el|άτομο|links=yes}}
|-
| {{tlf|lang-el|άτομο|links{{=}}no}}
| {{lang-el|άτομο|links=no}}
|-
| <code><nowiki>'''Nea Dimokratia''' -</nowiki></code><br/><code><nowiki>{{Lang-el|Νέα Δημοκρατία|translit=Nea Dimokratia}}</nowiki></code>
| '''Nea Dimokratia''' - {{Lang-el|Νέα Δημοκρατία|translit=Nea Dimokratia}}
|-
| <code><nowiki>'''Eleftherotypia''' -</nowiki></code><br/><code><nowiki>{{Lang-el|Ελευθεροτυπία|lit=Freedom of the Press}}</nowiki></code>
| '''Eleftherotypia''' - {{Lang-el|Ελευθεροτυπία|lit=Freedom of the Press}}
|}

== Tracking categories ==
* Articles using this template are automatically placed in {{clc|Articles containing Greek-language text}}.
* {{clc|Instances of Lang-el using second unnamed parameter}} - nothing inherently wrong if supplied <code>{{{2}}}</code>, but was created to check for compliance with template scheme.

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Text",
			"description": "The Greek text to be displayed",
			"type": "line",
			"required": true
		},
		"links": {
			"label": "Link?",
			"description": "If a link to the article Greek language is included",
			"type": "boolean",
			"default": "yes"
		},
		"lit": {
			"label": "Lit",
			"description": "English translation of Greek text",
			"type": "string"
		},
		"translit": {
			"label": "Transliteration",
			"description": "A Latin alphabet respelling of Greek text",
			"suggested": true,
			"type": "string"
		},
		"translit-std": {
			"label": "Transliteration standard",
			"description": "The identifier for the standard used for transliteration. Accepted value must be one of: ISO, DIN, IAST, ALA, and ALA-LC.",
			"suggested": true,
			"example": "ISO",
			"type": "string"
		},
		"label": {
			"label": "Label",
			"description": "label to be used instead of template-provided language label; may be wikilinked; special keyword none causes the template to render without any labels (including transliteration and translation labels)",
			"example": "none"
		}
	},
	"description": "Insert Greek text. This template should only be used with modern Greek."
}
</templatedata>

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

<includeonly>{{Sandbox other||
<!-- Categories go here and interwikis go in Wikidata. -->
[[Category:Greek multilingual support templates|{{PAGENAME}}]]
[[Category:Lang-x templates|el]]
[[Category:Templates that add a tracking category]]
}}</includeonly>