Quelltext der Seite Vorlage:Lang/Doku

{{SEITENTITEL:Vorlage:lang<noinclude>/Doku</noinclude>}}
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Mit dieser Vorlage lässt sich die '''Sprache''' ([[englische Sprache|englisch]] {{lang|en|''language''}}) eines Wortes oder Textabschnittes im [[Fließtext]] angeben.
* Das kann visuelle Effekte haben, weil dadurch die [[Hilfe:Schriftunterstützung|Schriftunterstützung]] der [[MediaWiki]]-Software greifen kann, insbesondere fehlende Schriftzeichen als [[Webfont]]s bereitgestellt werden; auch [[#CSS|benutzerspezifische Anpassungen]] können wirken.
* Manche [[Webbrowser]] können [[Anführungszeichen]], [[Interpunktion]], Worttrennung (durch [[Trennstrich]]) und weitere [[Typografie|typografische]] Eigenschaften sprachspezifisch umsetzen.
* [[Screenreader]] können anhand der gegebenen Sprachinformation die richtige Audioausgabe zuordnen.
* Werkzeuge für Rechtschreib- und Grammatikprüfung können Fremdwörter von der deutschsprachigen Analyse ausschließen; hingegen fremdsprachliche Wörterbücher für die Textpassage zuordnen.
Die Vorlage sollte nicht verwendet werden, um lediglich Fremdwörter auszuzeichnen, die auch im Deutschen üblich sind.

{{Achtung|1=2016 wurde die Funktionalität stark erweitert.
* Viele neue Parameter werden ermöglicht.
* Es kamen Gültigkeitsprüfungen hinzu.}}

{{TemplateData|JSON=
{
	"description": "Auszeichnung von [[Fließtext]]-Textpassagen in bestimmten Sprachen",
	"params": {
		"1": {
			"label": "Sprachcode",
			"description": "Sprachcode; meist nach [[Liste der ISO-639-Sprachcodes|ISO 639]] (zwei oder drei Kleinbuchstaben), auch erweitert nach RFC 5646",
			"type": "line",
			"required": true,
			"example": "ru"
		},
		"2": {
			"label": "Textpassage",
			"description": "Auszuzeichnende Textsequenz, meist in Fremdsprache und ggf. fremder Schrift",
			"type": "string",
			"required": true,
			"example": "Москва́"
		},
		"3": {
			"label": "Umschrift",
			"description": "Umschrift in lateinischen Buchstaben, gemäß [[CowboysWiki:Namenskonventionen]] oder gebräuchliche Form (nur zulässig, wenn Textpassage nicht-lateinisch basiert, und Sprachcode angemessen); wird in Kursivschrift dargestellt",
			"type": "string",
			"required": false,
			"suggested": true,
			"example": "Moskwa"
		},
		"Audio": {
			"label": "Tondatei",
			"description": "Hörbeispiel zur Textpassage verlinken",
			"type": "wiki-file-name",
			"required": false,
			"example": "Don Quijote-pronunciation-es 2.ogg"
		},
		"IPA": {
			"label": "Lautschrift",
			"description": "Aussprache der Textpassage zeigen",
			"type": "line",
			"required": false,
			"example": "ˈbaɪ̯ʃpiːl"
		},
		"de": {
			"label": "deutsch",
			"description": "deutschsprachige Übersetzung der Textpassage",
			"type": "string",
			"required": false,
			"example": "Beispiel"
		},
		"en": {
			"label": "englisch",
			"description": "englischsprachige Übersetzung der Textpassage",
			"type": "string",
			"required": false,
			"example": "example"
		}
	},
	"format": "inline"
}
|TOC=1
}}

== Verwendungszweck ==
Die Vorlage selbst hat keinen direkten visuellen Effekt, sie stellt lediglich [[Metadaten|Metainformationen]] bereit. Dabei ist sie unabhängig von der Art der Schrift zu verwenden, unbeeinflusst also, ob der Abschnitt in einem Fremdalphabet (z.&nbsp;B. [[Hangeul]]) oder in einer Romanisierung (z.&nbsp;B. [[McCune-Reischauer]]) geschrieben ist. Als Sprachcodes sollten [[ISO 639]] und für Regionen [[ISO 3166]] verwendet werden.

Alle Textfragmente in nichtlateinischen Schriften sollten immer in diese Vorlage oder eines ihrer Derivate eingekleidet werden.

=== Sprachcodes ===
Die [http://www.iana.org/assignments/language-subtag-registry ''Language Subtag Registry''] der [[Internet Assigned Numbers Authority|IANA]] enthält alle Werte, die wirkungsvoll benutzt werden können, gegliedert in zwei Klassen.
# ''Tags'': Vollständige Wertfolgen, z.&nbsp;B. <code>zh-Hant-SG</code> für [[Chinesische Sprachen|Chinesisch]] in der [[Langzeichen|traditionellen Schreibweise]], wie es in [[Singapur]] verwendet wird.
# ''Subtags'': Einzelwerte, die nach dem Schema ''language''[-''script''][-''region''][-''variant''] zusammengesetzt werden, z.&nbsp;B. <code>de-CH-1901</code> ''(language-region-variant)'' für [[Deutsche Sprache|Deutsch]] nach der [[Orthographische Konferenz von 1901|alten Rechtschreibung (von 1901)]], das in der [[Schweiz]] verwendet wurde. Eine genauere Beschreibung dazu ist in [http://www.w3.org/International/articles/bcp47/ W3C: ''Understanding the New Language Tags''] (englisch) zu finden.
Beachte den Hinweis zu [[#Ungeeignete Sprachcodes|ungeeigneten Sprachcodes]].

=== Einfaches Beispiel ===
<pre>
{{lang|fr|Je suis un Français.}}
</pre>
ergibt:<br />
{{lang|fr|Je suis un Français.}}

== Umschrift ==
Eine Umschrift ([[Transliteration]]/[[Transkription (Schreibung)|Transkription]]) ist bei Textpassagen <code>[[#templatedata:2|2=]]</code> in allen Sprachen bzw. schriftlichen Wiedergaben möglich, die nicht in einer überwiegend auf dem lateinischen Alphabet basierenden Verschriftung angegeben sind.

Es können mehrere Fälle unterschieden werden:
# [[Wikipedia:Namenskonventionen]] (WP:NK)<br /> sofern für diese Sprache vorliegend
# gebräuchliche Schreibung
#* nur wenn nicht nach WP:NK definiert, dann eine verbreitete Form
#* teils unterschiedlich für englisch, deutsch usw. kursierend
# formalisierte Systeme, teils wissenschaftlich<br /> mit eigenem Parameter ausgestattet; zurzeit (nur bei geeigneter Sprache oder Schrift):
#* <code>DMG=</code> – DMG – [[Deutsche Morgenländische Gesellschaft]], für arabische Schrift
#* <code>IAST=</code> – IAST – [[International Alphabet of Sanskrit Transliteration]], für indische Schriften
#* <code>RTGS=</code> – RTGS – [[Thailändisches Umschriftsystem]], für Thai-Schrift
#* <code>THL=</code> – [[THDL-Transkription]], für tibetische Schrift
#* <code>WYLIE=</code> – [[Umschrift nach Wylie]], für tibetische Schrift
#* <code>ZWPY=</code> – [[Offizielle Transkription der Volksrepublik China für das Tibetische]]
#* <code>YIVO=</code> – [[YIVO]], für Jiddisch
#* <code>BAHAI=</code> – [[Bahai-Transkription]], für arabische Schrift
#* <code>MCR=</code> – [[McCune-Reischauer]], für koreanische Schrift
#* <code>RR=</code> – [[Revidierte Romanisierung]], für (süd-)koreanische Schrift
#* <code>DIN1460=</code> – [[ISO 9|DIN 1460]], für kyrillische Schrift (slawisch)
#* <code>DIN1460-2=</code> – [[ISO 9|DIN 1460-2]], für kyrillische Schrift (nichtslawisch)
#* <code>DIN32706=</code> – DIN 32706, für Armenisch
#* <code>DIN32707=</code> – DIN 32707, für Georgisch
#* <code>ISO9=</code> – [[ISO 9]], für kyrillische Schrift
#* <code>ISO233=</code> – [[DIN 31635|ISO 233]], für arabische Schrift
#* <code>ISO259=</code> – [[DIN 31636|ISO 259]], für hebräische Schrift
#* <code>ISO9984=</code> – ISO 9984, für Georgisch. 
#* <code>ISO15919=</code> – [[ISO 15919]], für indische Schriften
#* <code>BGN-PCGN=</code> – [[BGN/PCGN-Transkription]], für alle Schriften
#* <code>ALA-LC=</code> – [[ALA-LC-Transkription]], für alle Schriften
Für die ersten beiden Fälle ist der Parameter <code>[[#templatedata:3|3=]]</code> zu verwenden; formalisierte Systeme haben jeweils einen eigenen Parameter, der das System explizit benennt.

== Übersetzungen ==
Im Prinzip beliebig viele weitere Parameter können Übersetzungen der Textpassage <code>2</code> spezifizieren. Zurzeit sind etwas über 200 möglich; Voraussetzung ist die Benennung in der [[:Kategorie:Vorlage:Fremdsprachenunterstützung]] und die Wirkung wäre im Einzelfall auszuprobieren.

Der Übersetzung wird der Sprachname vorangestellt; dieser (abgesehen von „deutsch“) auch verlinkt.

Die Sprache (und gleichzeitig Schrift) der Textpassage selbst scheidet naturgemäß für eine Übersetzung aus.

Die Reihenfolge mehrerer moderner Übersetzungen ist in der Vorlagensyntax nicht vorhersagbar oder konstant zu gewährleisten. Jedoch steht die deutschsprachige Übersetzung immer an erster Stelle; es folgen an antiken Sprachen {{grcS}}, {{hboS|bibel=1}}, {{laS}}, danach {{enS}} und dann alle weiteren.

== Beispiele ==
<pre>
Das lateinische Wort 
{{lang|la|luna|de=Mond|lmo=lüna|fr=lune|pt=lua|eo=luno|gl=lúa}}
</pre>
Das lateinische Wort 
{{lang|la|luna|de=Mond|lmo=lüna|fr=lune|pt=lua|eo=luno|gl=lúa}}

<pre>
Die Insel heißt
{{lang|fr|Réunion |Audio=fr-Réunion.ogg |IPA=ʀeyˈnjɔ̃ |de=Wiedervereinigung |en=reunion}}
</pre>
Die Insel heißt
{{lang|fr|Réunion |Audio=fr-Réunion.ogg |IPA=ʀeyˈnjɔ̃ |de=Wiedervereinigung |en=reunion}}

<pre>
Die Landessprache ist {{lang|bn|বাংলা ভাষা |IAST=bāṃlā bhāṣā |de=Bengalisch |en=Bengali language}}
</pre>
Die Landessprache ist {{lang|bn|বাংলা ভাষা |IAST=bāṃlā bhāṣā |de=Bengalisch |en=Bengali language}}

== {{Anker|CJK}} Verwendung bei CJKV ==
Für die Schriftdarstellung im Bereich [[CJK]]V ist eine Auszeichnung von Schriftzeichen in der jeweiligen Sprache mit visuellen Änderungen verbunden.

In der Geschichte der Verwendung [[Chinesische Schrift|chinesischer Zeichen]] ({{zh|v=汉字|t=漢字|p=hànzì}}, [[Japanische Schrift|jap.]] ''[[kanji]]'', [[Koreanische Schrift|kor.]] ''[[hanja]]'') in den verschiedenen Sprachen Chinesisch, Japanisch, Koreanisch und Vietnamesisch ([[CJK]]V) haben sich gewisse Änderungen in der Darstellung ergeben. Die untere Tabelle stellt dabei eine Auflistung gleicher Zeichen auf, die durch diese Vorlage an das jeweilige [[Locale]] angepasst ist. Die Grafik daneben zeigt, wie es aussehen soll.

[[Datei:Vergleich zh-Hant-CN zh-Hant-TW ja-Hani ko-Hani.png|mini|Vergleich der CJK-Schriften.]]
{| class="wikitable" style="text-align:center;"
|+ Vergleich der CJK-Schriftdarstellungen für Chinesisch (Volksrepublik), Chinesisch (Taiwan), Japanisch, Koreanisch
! <code>zh-Hans-CN</code> !! <code>zh-Hant-TW</code> !! <code>ja</code> !! <code>ko</code>
|- style="font-size:xx-large; padding:0.5em;"
|{{lang|zh-Hans-CN|判}}
|{{lang|zh-Hant-TW|判}}
|{{lang|ja|判}}
|{{lang|ko|判}}
|- style="font-size:xx-large; padding:0.5em;"
|{{lang|zh-Hans-CN|逸}}
|{{lang|zh-Hant-TW|逸}}
|{{lang|ja|逸}}
|{{lang|ko|逸}}
|- style="font-size:xx-large; padding:0.5em;"
|{{lang|zh-Hans-CN|骨}}
|{{lang|zh-Hant-TW|骨}}
|{{lang|ja|骨}}
|{{lang|ko|骨}}
|}

Zum Kopieren:
* Für Chinesisch bitte die [[Vorlage:zh|zh-Vorlage]] benutzen, nicht die lang-Vorlage. Die zh-Vorlage benutzt intern die lang-Vorlage. Zur weiteren Information siehe auf der Seite dort. Als Beispiel:
 <nowiki>{{zh|v=中华人民共和国香港特别行政区|t=中華人民共和國香港特別行政區}}</nowiki>
* Sonstige Sprachen, die auf der chinesischen Schrift basieren:
 <nowiki>{{lang|ja|</nowiki>{{lang|ja|漢字}}<nowiki>}}</nowiki>
 <nowiki>{{lang|ko|</nowiki>{{lang|ko|漢字}}<nowiki>}}</nowiki>
* Für sonstige Schriften:
 <nowiki>{{lang|ja|</nowiki>{{lang|ja|走れメロス}}<nowiki>}}</nowiki>
 <nowiki>{{lang|ko|</nowiki>{{lang|ko|한글}}<nowiki>}}</nowiki>
 <nowiki>{{lang|zh-Bopo|</nowiki>{{lang|zh-Bopo|ㄅㄆㄇㄈ}}<nowiki>}}</nowiki>

== {{Anker|RTL}} Sprachen mit rechts-nach-links Schreibrichtung (RTL) ==
Alle freien (sichtbaren) Textfragmente in Sprachen mit Schreibrichtung von rechts nach links ({{enS|right to left}}, abgekürzt ''RTL'') sollten immer in Vorlagen eingefasst werden, um Darstellungsprobleme zu vermeiden.

Bevorzugt sollten spezifische Vorlagen aus der [[:Kategorie:Vorlage:zur Schriftunterstützung (bidi)]] eingesetzt werden. Für alle gängigen Sprachen sind solche Vorlagen vorhanden; sofern einmal eine fehlen sollte, kann sie kurzfristig bereitgestellt werden.

Siehe auch allgemein: [[Hilfe:Asiatische Schriften #RTL]].

== Ungeeignete Sprachcodes ==
Die [[Internet Assigned Numbers Authority|IANA]]-Registrierung sieht für je eine Sprache nur genau ''einen'' Sprachcode vor.
* Nur unter diesem einen Code sind in Webbrowsern, in [[Screenreader]]n, bei Werkzeugen für Rechtschreib- und Grammatikprüfung Wörterbücher und Grammatikregeln oder Aussprachedefinitionen hinterlegt.
Die [[ISO 639]] erlaubt für die Sprachen in der Regel mehrere weitere synonyme Codes.
* ''Beispiel:'' <code>de</code> für „deutsch“; synonym dazu auch <code>deu</code> und <code>ger</code>.
Nur der erstgenannte Wert <code>de</code> wird von weiterverarbeitender Software erkannt und „verstanden“; sämtliche Synonyme machen den Vorlageneinsatz völlig wertlos.
* Wenn sowohl zwei als auch drei Kleinbuchstaben zur Wahl stehen, ist immer der kürzere Wert zu wählen.
* Auch die [[Hilfe:Schriftunterstützung|Schriftunterstützung]] der [[MediaWiki]]-Software ordnet nur beim registrierten Hauptwert die geeigneten Schriften zu.
* Gleichermaßen sind die im [[#CSS|übernächsten Abschnitt]] genannten benutzerdefinierten Regeln kaum auf Nebenwerte eingerichtet, wie es <code>rus</code> gemäß [[ISO 639-2]] oder [[ISO 639-3]] wäre.

== Parameter-Syntax ==
Hunderte von Parametern stehen zur Verfügung oder würden sich sinnvoll konstruieren lassen. Nachstehend die Möglichkeiten verallgemeinert im Überblick:
; 1
: [[#Sprachcodes|Sprachcode]] (ggf. mit Erweiterungen) in der die Textsequenz '''2''' notiert ist.
: ''Pflichtparameter''
: Dies ist kompatibel zu [[:en:Template:Lang]] in der englischsprachigen Wikipedia.
; 2
: Fließtext-Textsequenz
: ''Pflichtparameter''
: Dies ist kompatibel zu [[:en:Template:Lang]] in der englischsprachigen Wikipedia.
; 3
: [[#Umschrift|Umschrift]] der Textsequenz '''2''' (nur bei nichtlateinischem Ausgangstext)
; zwei oder drei Kleinbuchstaben; ggf. nach Bindestrich weitere Informationen
: [[Wikipedia:Technik/MediaWiki/Sprachen|Sprachcode]]
: Sprache einer [[#Übersetzungen|Übersetzung]] der Textsequenz '''2'''
; ein Großbuchstabe, drei Kleinbuchstaben
: [[Wikipedia:Technik/MediaWiki/Schriftsysteme|Schriftsystem]]
: Darstellung des Basistextes in einer anderen Verschriftung
; zwei oder mehr Großbuchstaben; ggf. gefolgt von Ziffern, Bindestrich, weitere Großbuchstaben und Ziffern
: formalisierte [[#Umschrift|Umschriften]] (in lateinische Buchstaben)
; [[Internationales Phonetisches Alphabet|IPA]]
: syntaktisch gesehen ein Sonderfall der formalisierten Umschrift, nur halt nicht in lateinische Schrift.
; Audio
: [[#templatedata:Audio|Sonderbedeutung]]
Bei allen Werten wird führender und schließender [[Weißraum]] ignoriert.
; prefix
: In manchen Sprachen, die aus der Antike bis heute verwendet werden, ist es in einigen Zusammenhängen sinnvoll, die verlinkte Seite durch vorangestelltes „alt-“ oder „neu-“ genauer zu charakterisieren.
; style
: [[Hilfe:Tags#style|Standard-Attribut]]
; class
: [[Hilfe:Tags#class|Standard-Attribut]]

== {{Anker|CSS}} Stylesheet anpassen ==
Mit dieser Vorlage wird einer Textpassage das [[XML]]-Universalattribut „lang“ zugewiesen. Dieses Attribut kann unter anderem dazu verwendet werden, Einfluss auf die Darstellung zu nehmen. Dazu existiert in [[Cascading Style Sheets]] (CSS), der Sprache, mit der die Darstellung von Webinhalten gesteuert wird, die Pseudoklasse „lang()“. Sie kann als [[Cascading Style Sheets#Selektoren|Selektor]] bei der Definition von Darstellungsvorgaben genutzt werden.

[[Stylesheet]]s existieren für die Wikipedia als ganzes, aber auch für einzelne Vorlagen. Zudem können Benutzer [[Wikipedia:Technik/Skin/Einstellungen|Einstellungen]] vornehmen, um die Darstellung an ihre eigenen Bedürfnisse anzupassen. Insbesondere registrierte Benutzer können dazu ihr eigenes Stylesheet [[Special:Mypage/common.css|common.css]] definieren.

Folgendes Beispiel legt eine besondere Schriftfarbe für alle durch diese Vorlage (oder in analoger Weise) gekennzeichneten Sprachen fest und wählt (hier für Russisch) eine Schriftart aus:
<syntaxhighlight lang="css">
span[lang] {
   color: green;
}
span[lang|="ru"] {
   font-family: fonteskaya;
}
</syntaxhighlight>

Alternativ kann der Selektor in der zweiten Zuweisung auch gesetzt werden:
<syntaxhighlight lang="css">
span:lang(ru) {
   font-family: fonteskaya;
}
</syntaxhighlight>

Oft ist es hilfreich, die Schrift zu vergrößern. Dies wird folgendermaßen erreicht:
<syntaxhighlight lang="css">
span[lang|="th"] {
   font-size: 1.2em;
}
</syntaxhighlight>

Neben den auf eine Sprache bezogenen Selektoren gibt es auch für das Schriftsystem definierte Klassen. Alle nichtlateinischen Fragmente werden mit einem Klassennamen markiert, der genauso heißt wie in [[ISO 15924]] definiert. Nachstehend eine Vergrößerung für alle Textfragmente in tibetischer Schrift unabhängig von der Sprache:
<syntaxhighlight lang="css">
.Tibt {
   font-size: 150%;
}
</syntaxhighlight>

''Siehe zu CSS auch:''
* [[Wikipedia:Technik/Skin/CSS]]
* [http://www.w3.org/International/questions/qa-css-lang ''FAQ: Styling using the lang attribute''] auf w3.org (englisch)

== Wartung ==
Probleme mit der Einbindung (auch abgeleiteter Vorlagen) werden aufgelistet in:
{{Vorlagenfehler-Wartungskat|Vorlage=Vorlage:lang|Text=*}}
{{Vorlagenfehler-Wartungskat |Vorlage=Parameter:Sprachcode|Text=*}}

== Weitere Informationen ==
(zurzeit alle englischsprachig)
* [[:en:Template talk:Lang]] – englischsprachige Wikipedia
* [[:en:User:Wikipeditor/CJK#.7B.7Blang.7D.7D|en:User:Wikipeditor/CJK#&#123;&#123;lang}}]]
* [http://www.iana.org/assignments/language-subtag-registry ''Language Subtag Registry.''] [[Internet Assigned Numbers Authority|IANA]]
* [http://www.w3.org/International/articles/language-tags/ ''Language tags in HTML and XML.''] [[World Wide Web Consortium|W3C]]
* {{RFC-Internet |Autor=A. Phillips, M. Davis |RFC=5646 |Titel=Tags for Identifying Languages |Standard=BCP 47 |Datum=2009-09 |Obsoletes=4646 |Errata=1 |Kommentar=Best Current Practice}}
* [https://r12a.github.io/app-subtags/ Language subtag lookup app]
<includeonly>
{{Lua-Vorlage|Vorlage:lang #flat}}

[[Kategorie:Vorlage:Fremdsprachenunterstützung|*Lang]]
</includeonly>