Zuletzt bearbeitet vor einem Jahr
von Margit Link-Rodrigue

Vorlagen Download/Sprachenwechsler: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Zeile 37: Zeile 37:
|{{#var:clswitcher}}}}
|{{#var:clswitcher}}}}
</syntaxhighlight>
</syntaxhighlight>
*Ein Tracking-Attribut stellt sicher, dass die einzelnen Sprachseiten im Wiki für Abfragen (z.B. zur Erstellung von Seitenlisten zur Verfügung steht):<syntaxhighlight lang="text">
<!-- set tracking property //-->
[[Languages/tracklang::{{#switch: {{SUBPAGENAME}}|{{#var:l1}}={{#var:l1}}|{{#var:l2}}={{#var:l2}}|{{#var:l3}}={{#var:l3}}|{{#var:l4}}={{#var:l4}}|{{#var:cl}}}}]]
</syntaxhighlight>
Alternativ kann in BluesSpice free (wo standarmäßig keine SMW-Funktionen und daher keine Attribute zur Verfügung stehen, über Tracking-Kategorien gearbeitet werden. Diese sind in der Vorlage standardmäßig auskommentiert. Der Kommentar muss daher entfernt werden und alle Sprachen als Kategorie getrackt werden:<syntaxhighlight lang="text">
{{#switch: {{SUBPAGENAME}}|{{#var:l1}}=[[Category:{{#var:l1}}]]|{{#var:l2}}=[[Category:{{#var:l2}}]]|{{#var:l3}}=[[Category:{{#var:l3}}]]|{{#var:l4}}=[[Category:{{#var:l4}}]]|[[Category:{{#var:cl}}]]}}
</syntaxhighlight>
*Zusätzlich sollte die Sprache auch zur Beschreibung der Vorlage für die Erweiterung [[Referenz:TemplateData|TemplateData]] hinzugefügt werden:<syntaxhighlight lang="text">
*Zusätzlich sollte die Sprache auch zur Beschreibung der Vorlage für die Erweiterung [[Referenz:TemplateData|TemplateData]] hinzugefügt werden:<syntaxhighlight lang="text">
"description": {
"description": {
Zeile 46: Zeile 54:
}
}
</syntaxhighlight>{{Hinweisbox|boxtype=Wichtig|icon=|Note text=In einem deutschsprachigen Wiki, wird deutsch als "content language" definiert. Daher muss die bereits in der Vorlage angelegte Variable "l1" auf eine andere Sprache (z.B. ''en'') umbelegt werden.|bgcolor=}}
</syntaxhighlight>{{Hinweisbox|boxtype=Wichtig|icon=|Note text=In einem deutschsprachigen Wiki, wird deutsch als "content language" definiert. Daher muss die bereits in der Vorlage angelegte Variable "l1" auf eine andere Sprache (z.B. ''en'') umbelegt werden.|bgcolor=}}
==Vorlage einbinden==
==Vorlage einbinden==
Damit der Sprachenwechsler funktioniert, müssen die Sprachversionen als Unterseiten der Inhaltssprache des Wikis angelegt werden. In einem englischen Wiki würden die Seiten folgendermaßen angelegt werden:
Damit der Sprachenwechsler funktioniert, müssen die Sprachversionen als Unterseiten der Inhaltssprache des Wikis angelegt werden. In einem englischen Wiki würden die Seiten folgendermaßen angelegt werden:

Version vom 23. März 2022, 15:57 Uhr

Diese Vorlage erstellt einen Sprachumschalter, der Sprachversionen in Form von Unterseiten unterstützt. Es kann über das VisualEditor-Menü „Einfügen > Vorlage“ am Beginn einer Wiki-Seite eingefügt werden.

Import der Vorlage[Bearbeiten | Quelltext bearbeiten]

Die benötigte Import-Datei befindet sich im Archiv HW-LanguageSwitcher.zip. Sie enthält die Datei HW-LanguageSwitcher.xml.

Führen Sie auf der Seite Spezial:Import in Ihrem Wiki folgende Schritte durch:

  1. Entpacken Sie die zip-Datei.
  2. Klicken Sie Browse... und wählen Sie die Datei HW-LanguageSwitcher.xml.
  3. Geben Sie ein Interwiki-Präfix an. Da dieses Feld erforderlich ist, geben Sie hier einfach hw (für hallowelt) ein.
  4. Belassen Sie die Vorauswahl Zu den Standard-Speicherorten importieren.
  5. Klicken Sie Datei hochladen... .

Die Vorlage ist nun in Ihrem Wiki verfügbar.

Enthaltene Importdateien[Bearbeiten | Quelltext bearbeiten]

Der xml-Import erstellt folgende Dateien in Ihrem Wiki:

  • Vorlage:Languages
  • Vorlage:Languages/styles.css

So funktioniert's[Bearbeiten | Quelltext bearbeiten]

Die Vorlage definiert einige Variablen, die bestimmen, welche Sprachen unterstützt werden:

  • Sie bestimmt automatisch die Inhaltssprache des Wikis (content language). Diese Variable ist unbedingt notwendig und darf nicht gelöscht werden.
  • Sie müssen mindestens eine Sprachversion definieren, damit der Sprachenwechsler sinnvoll eingesetzt werden kann. Jede Variable für eine Sprache wird als "l1", "l2",.... benannt. Der Wert muss mit dem ISO 639-1 Sprachencode übereinstimmen. Für Spanisch, würden Sie folgende Variable zu Vorlage:Languages hinzufügen:
    {{#vardefine:l4|es}}
    
  • Danach muss die Sprache zum eigentlichen Wechsler hinzugefügt werden:
    {{#switch: {{SUBPAGENAME}}
    |{{#var:l1}}={{#var:switcher}}
    |{{#var:l2}}={{#var:switcher}}
    |{{#var:l3}}={{#var:switcher}}
    |{{#var:l4}}={{#var:switcher}}
    |{{#var:clswitcher}}}}
    
  • Ein Tracking-Attribut stellt sicher, dass die einzelnen Sprachseiten im Wiki für Abfragen (z.B. zur Erstellung von Seitenlisten zur Verfügung steht):
    <!-- set tracking property //-->
    [[Languages/tracklang::{{#switch: {{SUBPAGENAME}}|{{#var:l1}}={{#var:l1}}|{{#var:l2}}={{#var:l2}}|{{#var:l3}}={{#var:l3}}|{{#var:l4}}={{#var:l4}}|{{#var:cl}}}}]]
    

Alternativ kann in BluesSpice free (wo standarmäßig keine SMW-Funktionen und daher keine Attribute zur Verfügung stehen, über Tracking-Kategorien gearbeitet werden. Diese sind in der Vorlage standardmäßig auskommentiert. Der Kommentar muss daher entfernt werden und alle Sprachen als Kategorie getrackt werden:

{{#switch: {{SUBPAGENAME}}|{{#var:l1}}=[[Category:{{#var:l1}}]]|{{#var:l2}}=[[Category:{{#var:l2}}]]|{{#var:l3}}=[[Category:{{#var:l3}}]]|{{#var:l4}}=[[Category:{{#var:l4}}]]|[[Category:{{#var:cl}}]]}}
  • Zusätzlich sollte die Sprache auch zur Beschreibung der Vorlage für die Erweiterung TemplateData hinzugefügt werden:
    "description": {
            "{{#var:cl}}": "Sprachenwechsler",
    		"{{#var:l1}}": "Language switcher",		
    		"{{#var:l2}}": "Sélecteur de langue",
    		"{{#var:l3}}": "Taal verandering",
    		"{{#var:l4}}": "Cambiador de idioma"
    	}
    
    Wichtig!In einem deutschsprachigen Wiki, wird deutsch als "content language" definiert. Daher muss die bereits in der Vorlage angelegte Variable "l1" auf eine andere Sprache (z.B. en) umbelegt werden.


Vorlage einbinden[Bearbeiten | Quelltext bearbeiten]

Damit der Sprachenwechsler funktioniert, müssen die Sprachversionen als Unterseiten der Inhaltssprache des Wikis angelegt werden. In einem englischen Wiki würden die Seiten folgendermaßen angelegt werden:

  • Urlaubsregelung
  • Urlaubsregelung/en
  • Urlaubsregelung/fr


Die Vorlage muss dann zu allen Sprachversionen hinzugefügt werden:

  1. Fügen Sie die Vorlage Languages über den Einfügen-Dialog von VisualEditor ein.
  2. Geben Sie einen Anzeigetitel (displaytitle) an, wenn es sich um eine Unterseite handelt. Damit wird ein sinnvoller Name auf der Seite angezeigt, der auch von der Suchmaschine genutzt wird. Für die Seite Urlaubsregelung/en, geben Sie "Vacation policy" an:
    Anzeigetitel für Unterseiten
    Anzeigetitel für Unterseiten




Feedback zur Dokumentation ist im Community-Forum möglich.