Vorlage:Dokumentation Fremdsprachenunterstützung: Unterschied zwischen den Versionen

Aktuelle Version vom 23. Februar 2023, 01:35 Uhr

Diese Vorlage wird auf vielen Seiten verwendet

Um große Unterbrechungen und unnötige Serverauslastung zu vermeiden, solltest du Änderungen an anderer Stelle testen, indem du beispielsweise den Quellcode dieser Vorlage kopierst und in den Benutzerbereich oder in die Sandbox einfügst. Erwäge, deine Änderungen auf der Diskussionsseite vorzuschlagen, bevor du diese Vorlage bearbeitest.

Dokumentation für die Vorlage {{Dokumentation Fremdsprachenunterstützung}}[Ansicht] [Bearbeiten] [Versionsgeschichte] [Aktualisieren]

Für die Vorlage {{Dokumentation Fremdsprachenunterstützung}} gibt es noch keine Dokumentation. Du kannst sie aber anlegen.

Hinweise

Die obige Dokumentation wurde aus der Seite Vorlage:Dokumentation Fremdsprachenunterstützung/Doku eingefügt. (bearbeiten | Versionsgeschichte) Die Kategorien für diese Vorlage sollten in der Dokumentation eingetragen werden. Die Interwiki-Links sollten auf Wikidata eingepflegt werden.
Doku anlegen -Testseite anlegen -Editnotice anlegen -Wartungsseite anlegen
Liste der Unterseiten

@@ Zeile 1: / Zeile 1: @@
-<includeonly>Die Vorlagen {{Tl|{{Str left|{{BASEPAGENAME}}|2}}}} und {{Tl|{{Str left|{{BASEPAGENAME}}|2}}S}} dienen der korrekten Darstellung der {{Dokumentation Fremdsprachenunterstützung/ISO 639-1|{{Str left|{{BASEPAGENAME}}|2}}}} Sprache. Diese Vorlage weist den vorgegebenen absatzgebundenen Text als aus der angegebenen Sprache stammend aus. Dem Text werden dazu die nötigen (X)HTML-Attribute zugwiesen. Dies ist nötig, wenn dieser Text in einer anderssprachigen Umgebung eingefügt wird. Der Browser kann so z.B. bei der Silbentrennung oder beim Vorlesen darauf Rücksicht nehmen.
+{{High-use}}
+<includeonly>{{#ifeq: {{Str mid|{{BASEPAGENAME}}|-1}} | S
+| <!-- Die Vorlage mit dem 'S' und der Ausgabe der Sprache im Text -->
+Diese Vorlage sowie ihre Schwester {{Tl|{{Str crop|{{BASEPAGENAME}}|1}}}} dienen der korrekten Darstellung der {{Dokumentation Fremdsprachenunterstützung/ISO 639-1|{{Str crop|{{BASEPAGENAME}}|1}}}} Sprache. Diese Vorlage weist den vorgegebenen absatzgebundenen Text als aus der {{Dokumentation Fremdsprachenunterstützung/ISO 639-1|{{Str crop|{{BASEPAGENAME}}|1}}}} Sprache stammend aus. Dem Text werden dazu die nötigen (X)HTML-Attribute zugewiesen. Dies ist nötig, wenn dieser Text in einer anderssprachigen Umgebung eingefügt wird. Der Browser kann so z.&#x202F;B. bei der Silbentrennung oder beim Vorlesen darauf Rücksicht nehmen.
+| <!-- Die Vorlage ohne dem 'S' und ohne der Ausgabe der Sprache im Text -->
+Die Vorlage sowie ihre Schwester {{Tl|{{BASEPAGENAME}}S}} dienen der korrekten Darstellung der {{Dokumentation Fremdsprachenunterstützung/ISO 639-1|{{BASEPAGENAME}}}} Sprache. Diese Vorlage weist den vorgegebenen absatzgebundenen Text als aus der {{Dokumentation Fremdsprachenunterstützung/ISO 639-1|{{BASEPAGENAME}}}} Sprache stammend aus. Dem Text werden dazu die nötigen (X)HTML-Attribute zugewiesen. Dies ist nötig, wenn dieser Text in einer anderssprachigen Umgebung eingefügt wird. Der Browser kann so z.&#x202F;B. bei der Silbentrennung oder beim Vorlesen darauf Rücksicht nehmen.
+}}
 == Verwendung ==
 Prinzipiell arbeiten diese Art von Vorlagen nach folgendem Prinzip:
-* {{Tlc|{{BASEPAGENAME}}|Text|{{Var|w{{=}}Wikivoyage-Transkription}}|{{Var|b{{=}}Deutsche Bedeutung}}|{{Var|a{{=}}Aussprache}}|{{Var|i{{=}}IPA-Alphabet}}}}
+* {{Tlc|{{BASEPAGENAME}}|Text|{{Var|w{{=}}Wikivoyage-Transkription}}|{{Var|b{{=}}Deutsche Bedeutung}}|{{Var|a{{=}}Aussprache}}|{{Var|i{{=}}IPA-Alphabet}}|{{Var|audiodatei{{=}}Audiodatei}}|{{Var|inKlammern{{=}}ja}}}}
 * '''Optionale Parameter:'''
 ** {{Para|w}} Wikivoyage-Transkription
 ** {{Para|b}} Deutsche Bedeutung
-** {{Para|a}} lokale Aussprache (wenn sie von der Transkiption abweicht).
+** {{Para|a}} lokale Aussprache (wenn sie von der Transkription abweicht).
 ** {{Para|i}} Schreibweise im IPA-Alphabet.
+** {{Para|audiodatei}} Angabe eine Audiodatei ohne Namensraum und Wikisyntax. Hinter dem Fremdsprachentext wird dann ein kleines Lautsprechersymbol eingeblendet.
+** {{Para|inKlammern}} Angabe, ob die Ausgabe in runde Klammern eingebettet werden soll (standardmäßig nicht). Dies macht es möglich, die ganze Ausgabe per CSS für bestimmte Sprachen zu unterdrücken, ohne das störende leere Klammern verbleiben. Drei Werte kann der Parameter bedienen.
+***{{Code|ja/j/yes/y/1}} – Klammern werden angezeigt.
+***{{Code|links/l}} – nur die linke Klammer wird angezeigt.
+***{{Code|rechts/r}} – nur die rechte Klammer wird angezeigt.
+{{#ifeq: {{Str mid|{{BASEPAGENAME}}|-1}} | S
+| <!-- Die Vorlage mit dem 'S' und der Ausgabe der Sprache im Text -->
+== Variante der Vorlage ==
+Die Vorlage {{Tl|{{Str crop|{{BASEPAGENAME}}|1}}}} arbeitet nach dem selben Prinzip, allerdings wird nur der Text, nicht der Name der Sprache ausgegeben.
+| <!-- Die Vorlage ohne dem 'S' und ohne der Ausgabe der Sprache im Text -->
+== Variante der Vorlage ==
+Die Vorlage {{Tl|{{BASEPAGENAME}}S}} arbeitet nach dem selben Prinzip. Zusätzlich zum eigentlichen fremdsprachigen Text wird bei ihr der Name der Sprache vorangestellt. Ist auf Wikivoyage ein Sprachführer vorhanden, wird dieser zusätzlich direkt verlinkt.
+}}
-== Varianten der Vorlage ==
+== Beispiele ==
+Hier einige Beispiele für die Anwendung der Sprachvorlagen auf Wikivoyage. Alle arbeiten nach dem selben Prinzip.
+* <code><nowiki>{{JaS|富士山|i=ɸɯʑisaɴ|audiodatei=Ja-Fuji-san.oga}}</nowiki></code> ergibt: {{JaS|富士山|i=ɸɯʑisaɴ|audiodatei=Ja-Fuji-san.oga}}
+* <code><nowiki>{{Ja|富士山|i=ɸɯʑisaɴ|audiodatei=Ja-Fuji-san.oga|inKlammern=ja}}</nowiki></code> ergibt: {{Ja|富士山|i=ɸɯʑisaɴ|audiodatei=Ja-Fuji-san.oga|inKlammern=ja}}
+* <code><nowiki>{{Th|กรุงเทพมหานคร}}</nowiki></code> ergibt: {{Th|กรุงเทพมหานคร}}
+* <code><nowiki>{{ThS|กรุงเทพมหานคร|b=Krung Thep Maha Nakhon|audiodatei=Th-Krung Thep Maha Nakhon.ogg}}</nowiki></code> ergibt: {{ThS|กรุงเทพมหานคร|b=Krung Thep Maha Nakhon|audiodatei=Th-Krung Thep Maha Nakhon.ogg}}
+* <code><nowiki>{{KaS|საქართველო|w=Sakartwelo}}</nowiki></code> ergibt: {{KaS|საქართველო|w=Sakartwelo}}
+* <code><nowiki>{{MnS|ᠪᠣᠭᠣᠲᠣ|vertikal=ja|inKlammern=y}}</nowiki></code> ergibt: {{MnS|ᠪᠣᠭᠣᠲᠣ|vertikal=ja|inKlammern=y}}
+* <code><nowiki>{{he|בית כנסת הרמב"ם|w=Bet Knesset haRambam|b=die Rambam-Synagoge|inKlammern=ja}}</nowiki></code> ergibt: {{he|בית כנסת הרמב"ם|w=Bet Knesset haRambam|b=die Rambam-Synagoge|inKlammern=ja}}
-Die Vorlage {{Tl|{{BASEPAGENAME}}S}} arbeitet nach dem selben Prinzp. Zusätzlich zum eigentlichen fremdsprachigen Text wird der Name der Sprache vorangestellt. Ist auf Wikivoyage ein Sprachführer vorhanden, wird dieser zusätzlich direkt verlinkt.
+== Individuelle Gestaltung ==
+Die Einbindung der Sprachvorlage lässt sich über [[w:Cascading Style Sheets|CSS]] individuell gestalten, entweder zentral über die Systemdatei [[Mediawiki:common.css]] oder benutzerspezifische Einstellungen [[Special:MyPage/common.css|''Benutzer:<Dein Name>/common.css'']]. Für Programmierer ist es damit auch möglich an jedem Feld per [[w:de:Javascript|Javascript]] Änderungen vorzunehmen und Werkzeuge zu programmieren. Folgende Klassen wurden verwendet:
+* {{Code|.voy-foreign-lang}} – für den gesamten Eintrag
+* {{Code|.voy-foreign-lang-<sprachcode>}} – zusätzliche Klasse, um eine spezifische Sprache zu selektieren (z.&#x202F;B. {{Code|.voy-foreign-lang-th}} für Thai).
+In dem Tag der gerade genannten Klasse sind nun alle einzelnen Informationen in separaten Tags mit folgenden Klassen abgelegt
+* {{Code|.voy-foreign-name}} – Name des Sprache
+* {{Code|.voy-lang}} – Eigentlicher fremdsprachlicher Text
+* {{Code|.voy-lang-<sprachcode>}} – zusätzliche Klasse für den fremdsprachlichen Text, um einen einzelnen Sprachcode zu selektieren
+* {{Code|.voy-audio}} – eingebettete Tondatei
+* {{Code|.voy-foreign-lang-transkription}} – Transkription
+* {{Code|.voy-foreign-lang-translation}} – deutsche Bedeutung
+* {{Code|.voy-foreign-lang-pronounciation}} – Aussprache
+* {{Code|.voy-foreign-lang-ipa}} – IPA-Spachcode
+Hier einige Beispiele zur Anwendung:
+* <code><nowiki>.voy-foreign-lang { display: none; }</nowiki></code> – Alle Fremdsprachigen Texte immer unterdrücken
+* <code><nowiki>.voy-foreign-lang-th { display: none; }</nowiki></code> – Thailändisch immer unterdrücken (weil z.&#x202F;B. auf dem eigenen Rechner kein Thai verfügbar ist oder nicht richtig angezeigt wird)
+* <code><nowiki>.voy-foreign-lang .voy-audio { display: none; }</nowiki></code> – Tondateien immer ausblenden
+* <code><nowiki>.voy-foreign-lang-ipa { display: none; }</nowiki></code> – IPA-Code immer ausblenden
+* <code><nowiki>.voy-foreign-lang { background-color: bisque; }</nowiki></code> – komplette Sprachvorlagen mit beigefarbenem Hintergrund
+* <code><nowiki>.voy-foreign-lang .voy-lang-th { color: red; }</nowiki></code> – Nur Thailändische Worte immer rot schreiben, den Rest der Vorlage Standard
+* <code><nowiki>.voy-foreign-lang .voy-foreign-lang-translation:hover { font-weight: bold; }</nowiki></code> – Deutsche Bedeutung fett darstellen, wenn man die Maus darüber platziert.
+'''Hinweis:''' Die Klassen {{Code|.voy-lang}} und {{Code|.voy-audio}} können auch außerhalb der Fremdsprachenvorlagen auftauchen, das sie über separate Vorlagen eingebunden sind, die auch für sich im Text angewendet werden können. Möchte man sie nur innerhalb der Sprachvorlagen wirken lassen, muss man wie in den Beispielen zusätzlich {{Code|.voy-foreign-lang}} als übergeordneten Selektor angeben.
 == Hinweis ==
 Dies ist eine standardisierte Dokumentation für Sprachvorlagen, die über die Vorlage {{Tl|Dokumentation Fremdsprachenunterstützung}} eingebunden wurde. Aus diesem Grund enthält sie keine sprachspezifischen Beispiele. Wenn du die Funktionalität der Vorlage erweitern bzw. sprachspezifische Beispiele einbinden möchtest, kannst du eine eigene Dokumentation für die Vorlage anlegen.
-Weitere dieser Hilfsvorlagen findest du [[:Kategorie:Vorlagen:Fremdsprachenunterstützung|hier...]]
+== Siehe auch ==
+* {{C|Vorlagen:Fremdsprachenunterstützung}} – Alle Vorlagen zur Fremdsprachenunterstützung.
+* [[Wikivoyage:Vorlagen/Fremdsprachen|Fremdsprachen]] – Alles Wissenswerte über die Fremdsprachenvorlagen.
+== TemplateData ==
+<templatedata>
+{
+	"description": "Die Vorlage weist fremdsprachigen Text aus.",
+	"format": "inline",
+	"params": {
+		"1": {
+			"label": "Text",
+			"description": "fremdsprachiger Text",
+			"type": "string",
+			"required": true
+		},
+		"w": {
+			"label": "Wikivoyage Transkription",
+			"description": "Deutsche Umschrift des Textes",
+			"type": "string",
+			"required": false,
+			"suggested": false
+		},
+		"b": {
+			"inherits": "w",
+			"label": "Bedeutung",
+			"description": "Deutsche Bedeutung des Textes"
+		},
+		"a": {
+			"inherits": "w",
+			"label": "Aussprache",
+			"description": "Lokale Aussprache (wenn sie von der Transkription abweicht)"
+		},
+		"i": {
+			"inherits": "w",
+			"label": "IPA",
+			"description": "Schreibweise im IPA-Alphabet"
+		},
+		"audiodatei": {
+			"inherits": "w",
+			"label": "Audiodatei",
+			"description": "Audiodatei für die Sprachausgabe des Textes",
+			"type": "wiki-file-name"
+		},
+		"inKlammern": {
+			"label": "inKlammern",
+			"description": "Soll der Text in Klammern gesetzt werden?",
+			"default": "ja",
+			"type": "string",
+			"required": false,
+			"suggested": true
+		},
+		"vertikal": {
+			"label": "vertikal",
+			"description": "Soll der Text in Klammern vertikal geschrieben werden?",
+			"default": "ja",
+			"type": "string",
+			"required": false,
+			"suggested": false
+		}
+	}
+}
+</templatedata>
+[[Kategorie:Vorlagen:Fremdsprachenunterstützung|{{BASEPAGENAME}}]]
+[[Kategorie:Vorlagen:Multimediaeinbindung|{{BASEPAGENAME}}]]
 </includeonly><noinclude>{{Dokumentation}}[[Kategorie:Vorlagen:Dokumentation]]</noinclude>
-<includeonly>[[Kategorie:Vorlagen:Fremdsprachenunterstützung|{{BASEPAGENAME}}]]</includeonly>