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>{{#ifeq: {{Str mid|{{BASEPAGENAME}}|-1}} | S
+{{High-use}}
-|
+<includeonly>{{#ifeq: {{Str mid|{{BASEPAGENAME}}|-1}} | S
-<!-- Die Vorlage mit dem 'S' und der Ausgabe der Sprache im Text -->
+| <!-- 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 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.
+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|{{Str crop|{{BASEPAGENAME}}|1}}}} arbeitet nach dem selben Prinzp, allerdings wird nur der Text, nicht der Name der Sprache ausgegeben.
+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.
+}}
+== 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}}
-|
+== Individuelle Gestaltung ==
-<!-- Die Vorlage ohne dem 'S' und ohne der Ausgabe der Sprache im Text -->
+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:
-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 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.
+* {{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
-== Verwendung ==
+Hier einige Beispiele zur Anwendung:
-Prinzipiell arbeiten diese Art von Vorlagen nach folgendem Prinzip:
+* <code><nowiki>.voy-foreign-lang { display: none; }</nowiki></code> – Alle Fremdsprachigen Texte immer unterdrücken
-* {{Tlc|{{BASEPAGENAME}}|Text|{{Var|w{{=}}Wikivoyage-Transkription}}|{{Var|b{{=}}Deutsche Bedeutung}}|{{Var|a{{=}}Aussprache}}|{{Var|i{{=}}IPA-Alphabet}}}}
+* <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)
-* '''Optionale Parameter:'''
+* <code><nowiki>.voy-foreign-lang .voy-audio { display: none; }</nowiki></code> – Tondateien immer ausblenden
-** {{Para|w}} Wikivoyage-Transkription
+* <code><nowiki>.voy-foreign-lang-ipa { display: none; }</nowiki></code> – IPA-Code immer ausblenden
-** {{Para|b}} Deutsche Bedeutung
+* <code><nowiki>.voy-foreign-lang { background-color: bisque; }</nowiki></code> – komplette Sprachvorlagen mit beigefarbenem Hintergrund
-** {{Para|a}} lokale Aussprache (wenn sie von der Transkiption abweicht).
+* <code><nowiki>.voy-foreign-lang .voy-lang-th { color: red; }</nowiki></code> – Nur Thailändische Worte immer rot schreiben, den Rest der Vorlage Standard
-** {{Para|i}} Schreibweise im IPA-Alphabet.
+* <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.
-== Variante der Vorlage ==
+'''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.
-Die Vorlage {{Tl|{{BASEPAGENAME}}S}} arbeitet nach dem selben Prinzp. 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.
-}}
 == 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.
 == Siehe auch ==
-* {{Lcs|Vorlagen:Fremdsprachenunterstützung}} – Alle Vorlagen zur Fremdsprachenunterstützung.
+* {{C|Vorlagen:Fremdsprachenunterstützung}} – Alle Vorlagen zur Fremdsprachenunterstützung.
-* [[Wikivoyage:Vorlagen/Fremdsprachen|Fremdsprachen]] – Alles Wissenswerte über die Fremdrprachenvorlagen.
+* [[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>