Vorlage:lang/Doku

Diese Seite ist die Dokumentations-Unterseite der Vorlage:Lang.

Mit dieser Vorlage lässt sich die Sprache eines Wortes oder Textabschnittes angeben.

• Das kann visuelle Effekte haben, weil dadurch die Schriftunterstützung der MediaWiki-Software greifen kann; insbesondere fehlende Schriftzeichen als Webfonts bereitgestellt würden; auch benutzerspezifische Anpassungen können wirken.
• Manche Webbrowser können Anführungszeichen, Interpunktion, Worttrennung (durch Trennstrich) und weitere 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.

Ende Oktober 2016 wurde die Funktionalität stark erweitert.

• Alle bestehenden Einbindungen sind davon zunächst nicht betroffen.
• Bisher schon wegen fehlender Parameter unbrauchbare Einbindungen zeigen jetzt eine Fehlermeldung.
• Viele neue Parameter werden ermöglicht.
• Perspektivisch könnte eine Gültigkeitsprüfung des Sprachcodes (erster Parameter) hinzukommen.

Diese Vorlage ist vielfach eingebunden. Wenn du die Auswirkungen genau kennst, kannst du sie bearbeiten. Meist ist es jedoch sinnvoll, Änderungswünsche erst auf Vorlage Diskussion:Lang abzustimmen.

TemplateData

TemplateData

{{#invoke:TemplateData|f|lang=⧼lang⧽}}

Verwendungszweck

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

Sprachcodes

Die Language Subtag Registry der IANA enthält alle Werte, die wirkungsvoll benutzt werden können, gegliedert in zwei Klassen.

1. Tags: Vollständige Wertfolgen, z. B. zh-Hant-SG für Chinesisch in der traditionellen Schreibweise das in Singapur verwendet wird.
2. Subtags: Einzelwerte, die nach dem Schema language[-script][-region][-variant] zusammengesetzt werden, z. B. de-CH-1901 (language-region-variant) für Deutsch nach der alten Rechtschreibung (von 1901), das in der Schweiz verwendet wurde. Eine genauere Beschreibung dazu ist in W3C: Understanding the New Language Tags (englisch) zu finden.

Beachte den Hinweis zu ungeeigneten Sprachcodes.

Einfaches Beispiel

{{lang|fr|Je suis un Français.}}

ergibt:
{{#invoke:Vorlage:lang|flat}}

Umschrift

Eine Umschrift (Transliteration/Transkription) ist bei Textpassagen 2 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:

1. Wikipedia:Namenskonventionen (WP:NK)
   sofern für diese Sprache vorliegend
2. gebräuchliche Schreibung
   • nur wenn nicht nach WP:NK definiert, dann eine verbreitete Form
   • teils unterschiedlich für englisch, deutsch usw. kursierend
3. formalisierte Systeme, teils wissenschaftlich
   • mit eigenem Parameter ausgestattet; zurzeit nur: IAST=
   • DMG – Deutsche Morgenländische Gesellschaft, für arabische Schrift
   • IAST – International Alphabet of Sanskrit Transliteration, für indische Schriften

Für die ersten beiden Fälle ist der Parameter 3 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 2 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 {{#invoke:Vorlage:lang|full|CODE=grc|SCRIPTING=Grek|SERVICE= altgriechisch|SUITABLE=variant label}}, Biblisches Hebräisch, {{#invoke:Vorlage:lang|full|CODE=la|SCRIPTING=Latn|SERVICE=lateinisch|SUITABLE=label}}, danach {{#invoke:Vorlage:lang|full|CODE=en|SCRIPTING=Latn|SERVICE=englisch}} und dann alle weiteren.

Beispiele

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

Das lateinische Wort {{#invoke:Vorlage:lang|flat}}

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

Die Insel heißt {{#invoke:Vorlage:lang|flat}}

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

Die Landessprache ist {{#invoke:Vorlage:lang|flat}}

Verwendung bei CJKV

Für die Schriftdarstellung im Bereich CJKV ist eine Auszeichnung von Schriftzeichen in der jeweiligen Sprache mit visuellen Änderungen verbunden.

In der Geschichte der Verwendung chinesischer Zeichen (chinesisch {{#invoke:Vorlage:lang|flat}} / {{#invoke:Vorlage:lang|flat}}, Pinyin hànzì, jap. kanji, kor. hanja) in den verschiedenen Sprachen Chinesisch, Japanisch, Koreanisch und Vietnamesisch (CJKV) 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.

Vergleich der CJK-Schriften.

Vergleich der CJK-Schriftdarstellungen für Chinesisch (Volksrepublik), Chinesisch (Taiwan), Japanisch, Koreanisch

zh-Hans-CN	zh-Hant-TW	ja	ko
flat}}	flat}}	flat}}	flat}}
flat}}	flat}}	flat}}	flat}}
flat}}	flat}}	flat}}	flat}}

Zum Kopieren:

• Für Chinesisch bitte die 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:

{{zh|v=中华人民共和国香港特别行政区|t=中華人民共和國香港特別行政區}}

• Sonstige Sprachen, die auf der chinesischen Schrift basieren:

{{lang|ja|{{#invoke:Vorlage:lang|flat}}}}
{{lang|ko|{{#invoke:Vorlage:lang|flat}}}}

• Für sonstige Schriften:

{{lang|ja|{{#invoke:Vorlage:lang|flat}}}}
{{lang|ko|{{#invoke:Vorlage:lang|flat}}}}
{{lang|zh-Bopo|{{#invoke:Vorlage:lang|flat}}}}

Sprachen mit rechts-nach-links Schreibrichtung (RTL)

Bei Sprachen mit Schreibrichtung von rechts nach links ({{#invoke:Vorlage:lang|full|CODE=en|SCRIPTING=Latn|SERVICE=englisch}}, abgekürzt RTL) sollen nur spezifische Vorlagen aus der Kategorie:Vorlage:zur Schriftunterstützung (bidi) eingesetzt werden. Nur damit wird die Schreibrichtung im Kontext bei allen Browser richtig gesetzt. Für alle gängigen Sprachen sind Vorlagen vorhanden; sofern einmal eine fehlen sollte, kann sie kurzfristig bereitgestellt werden.

Siehe auch allgemein: Hilfe:Asiatische Schriften #RTL.

Ungeeignete Sprachcodes

Die IANA-Registrierung sieht für je eine Sprache nur genau einen Sprachcode vor.

• Nur unter diesem einen Code sind in Webbrowsern, in Screenreadern, 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: de für „deutsch“; synonym dazu auch deu und ger.

Nur der erstgenannte Wert de wird von weiterverarbeitender Software erkannt und „verstanden“; sämtliche Synonyme machen den Vorlageneinsatz wertlos.

• Wenn sowohl zwei als auch drei Kleinbuchstaben zur Wahl stehen, ist immer der kürzere Wert zu wählen.
• Auch die Schriftunterstützung der MediaWiki-Software ordnet nur beim registrierten Hauptwert die geeigneten Schriften zu.
• Gleichermaßen sind die im folgenden Abschnitt genannten benutzerdefinierten Regeln kaum auf Nebenwerte eingerichtet, wie es rus gemäß ISO 639-2 oder ISO 639-3 wäre.

Stylesheet anpassen

Benutzer können auf unterschiedlichen Wegen, insbesondere registrierte Benutzer mit ihrer eigenen Stylesheet-Seite common.css ihr persönliches Erscheinungsbild definieren. Folgendes Beispiel legt eine besondere Schriftfarbe für alle durch diese Vorlage (oder in anloger Weise) gekennzeichneten Sprachen fest und wählt für Russisch eine Schriftart fest 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>

Für kursive Schrift ist entsprechend einzufügen: <syntaxhighlight lang="css"> span[lang] {

  font-style: italic;

} </syntaxhighlight>

Siehe zu CSS auch:

• Wikipedia:Technik/Skin/CSS
• FAQ: Styling using the lang attribute auf w3.org (englisch)

Weitere Informationen

(zurzeit alle englischsprachig)

• en:Template talk:Lang – englischsprachige Wikipedia
• en:User:Wikipeditor/CJK#{{lang}}
• Language Subtag Registry. IANA
• Language tags in HTML and XML. W3C
• RFC 5646 – Tags for Identifying Languages (bzw. best practice BCP 47)
• Language subtag lookup app