|
|
| Zeile 1: |
Zeile 1: |
| <div class="downloadarea">
| | #WEITERLEITUNG [[Archiv:Referenz:BlueSpiceCalumma]] |
| <span class="getButton">[[Medium:HW-LanguageSwitcher.zip|Download]]</span>
| |
| | |
| [[File:HW-languageswitcher.png|350x350px|verweis=Special:FilePath/HW-languageswitcher.png]] | |
| </div>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==
| |
| 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:
| |
| | |
| #'''Entpacken''' Sie die zip-Datei.
| |
| #'''Klicken''' Sie ''Browse...'' und wählen Sie die Datei ''HW-LanguageSwitcher.xml''.
| |
| #'''Geben''' Sie ein Interwiki-Präfix '''an'''. Da dieses Feld erforderlich ist, geben Sie hier einfach ''hw'' (für hallowelt) ein.
| |
| #Belassen Sie die Vorauswahl ''Zu den Standard-Speicherorten'' importieren.
| |
| #'''Klicken''' Sie ''Datei hochladen...'' .
| |
| | |
| Die Vorlage ist nun in Ihrem Wiki verfügbar.
| |
| | |
| ==Enthaltene Importdateien==
| |
| Der xml-Import erstellt folgende Dateien in Ihrem Wiki:
| |
| | |
| *Vorlage:Languages
| |
| *Vorlage:Languages/styles.css
| |
| *Vorlage:InterLanguages
| |
| *Attribut:Languages/tracklang
| |
| * MediaWiki:Lang
| |
| *MediaWiki:Lang/de
| |
| *MediaWiki:Lang/en
| |
| *MediaWiki:Lang/fr
| |
| *MediaWiki:Lang/nl
| |
| | |
| ==So funktioniert's==
| |
| | |
| === Vorlage:Languages===
| |
| Diese Vorlage wird verwendet, um zwischen einer Seite und ihren übersetzten Versionen zu wechseln, wenn die Übersetzungen als Unterseiten gepflegt werden.
| |
| | |
| 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 [https://de.wikipedia.org/wiki/Liste_der_ISO-639-1-Codes ISO 639-1 Sprachencode] übereinstimmen. Für Spanisch, würden Sie folgende Variable zu ''Vorlage:Languages'' hinzufügen:<syntaxhighlight lang="text">
| |
| {{#vardefine:l4|es}}
| |
| </syntaxhighlight>
| |
| *Danach muss die Sprache zum eigentlichen Wechsler hinzugefügt werden. Jede Sprache muss vor <code><nowiki>{{#var:clswitcher}}</nowiki></code> eingefügt werden:<syntaxhighlight lang="text">
| |
| {{#switch: {{SUBPAGENAME}}
| |
| |{{#var:l1}}={{#var:switcher}}
| |
| |{{#var:l2}}={{#var:switcher}}
| |
| |{{#var:l3}}={{#var:switcher}}
| |
| |{{#var:l4}}={{#var:switcher}}
| |
| |{{#var:clswitcher}}}}
| |
| </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">
| |
| "description": {
| |
| "{{#var:cl}}": "Sprachenwechsler",
| |
| "{{#var:l1}}": "Language switcher",
| |
| "{{#var:l2}}": "Sélecteur de langue",
| |
| "{{#var:l3}}": "Taal verandering",
| |
| "{{#var:l4}}": "Cambiador de idioma"
| |
| }
| |
| </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:Interlanguages==
| |
| Diese Vorlage wird verwendet, um zwischen einer Seite und ihren übersetzten Versionen zu wechseln, wenn die Übersetzungen nicht als Unterseiten gepflegt werden, sondern syntaktisch überhaupt nicht verbunden sind.
| |
| | |
| Die Vorlage definiert einige Variablen, mit der die unterstützten Sprachen festgelegt erden. '''Die Variable "self" definiert die jeweils aktuell geladene Seite. Sie ist erforderlich und darf nicht gelöscht werden.'''
| |
| | |
| Die Sprachvariablen werden genau wie in der Vorlage ''Languages'' definiert. Wenn Sie zusätzliche Sprachvariablen definieren, müssen die neu definierten Sprachen dem Sprachenwechsler-Menü hinzugefügt werden. Die Links werden in folgenden Container erstellt:
| |
| <syntaxhighlight lang="text">
| |
| <div id="langbar-hz">
| |
| ...
| |
| </div>
| |
| </syntaxhighlight>
| |
| Fügen Sie einfach jede Sprache mit der l-Nummer hinzu, die Ihrer Sprachvariablen entspricht, indem Sie folgende Zeile kopieren und die Nummer ersetzen:<syntaxhighlight lang="text">
| |
| {{#if: {{{pgnamel4|}}}|{{#switch:{{{pgnamel4|}}}|{{#var:self}}=[[{{FULLPAGENAME}}{{!}}{{#var:l4}}]]|[[{{{pgnamel4}}}{{!}}{{#var:l4}}]]}}|}}
| |
| </syntaxhighlight>
| |
| Außerdem müssen Sie die Sprache zur Vorlagenbeschreibung und den verfügbaren Feldern im TemplateData-Editor hinzufügen.
| |
| | |
| Im Quellbearbeitungsmodus:
| |
| | |
| #'''Click''' ''Manage TemplateData''
| |
| [[File:interlanguages-manageTD-de.png|center|thumb|650x650px|TemplateData verwalten]]<br />
| |
| #'''Click''' ''Add parameter''
| |
| [[File:interlanguages-manageTD-addparam-de.png|center|thumb|514x514px|Neue Sprache(n) als parameter hinzufügen]]
| |
| #'''Select''' any new language you have added and click '''Apply'''.
| |
| [[File:interlanguages-manageTD-editparam-de.png|center|thumb|515x515px|Neu hinzugefügten Parameter auswählen]]
| |
| #'''Add''' the language abbreviation for the new language as a label and activate the ''Suggested'' checkbox and click '''Done.'''
| |
| [[File:interlanguages-manageTD-paraminfo-de.png|center|thumb|521x521px|Parameter-Einstellungen]]
| |
| #'''Click''' ''Add language'' to add a new template description for this language.
| |
| [[File:interlanguages-manageTD-addlang-de.png|center|thumb|450x450px|Vorlagenbeschreibung hinzufügen]]
| |
| #'''Select''' the user language that corresponds to the current language parameter.
| |
| [[File:interlanguages-manageTD-addlang-es-de.png|center|thumb|450x450px|Benutzersprache auswählen]]<br />
| |
| #'''Enter''' a template description and click '''Apply'''. This description is shown when the user selects a template in the visual editor.[[File:interlanguages-manageTD-addlang-es-desc-de.png|center|thumb|450x450px|Vorlagenbeschreibung]]
| |
| {{Hinweisbox|boxtype=Wichtig|icon=|Note text=If you have changed the original default values for the language variables, make sure to change the language labels here accordingly. The labels for the l1, l2, l3,... languages need to match.<br/>
| |
| [[File:interlanguages-manageTD-labels-de.png|alt=korrekte Sprachenzuweisungen überprüfen|center|thumb|250x250px|korrekte Sprachenzuweisungen überprüfen]]|bgcolor=}}
| |
| | |
| ==Ausrichtung des Sprachenwechslers==
| |
| Standardmäßig wird der Sprachumschalter auf der rechten Seite der Seite angezeigt. Um es auf der linken Seite anzuzeigen, ändern Sie die folgende Zeile in der Seite Vorlage:Languages/styles.css:
| |
| <syntaxhighlight lang="css">
| |
| #langbar-hz {text-align: left;}
| |
| </syntaxhighlight>
| |
| | |
| ==Sprachenwechsler auf einer Seite verwenden==
| |
| Es ist möglich, beide Sprachumschalter im selben Wiki zu verwenden. Sie verbinden Sprachversionen in verschiedenen Szenarien:
| |
| *[https://en.wiki.bluespice.com/wiki/Multilingual_wiki#Creating_wiki_pages_with_translated_subpages Nutzung der Vorlage '''Languages'''] (für Sprachversionen, die als Unterseiten gepflegt werden) - derzeit nur auf Englisch verfügbar
| |
| *[https://en.wiki.bluespice.com/wiki/Multilingual_wiki#Connecting_unrelated_wiki_pages Nutzung der Vorlage '''InterLanguages'''] (für Sprachversionen, die als unabhängige Seiten gepflegt werden) - derzeit nur auf Englisch verfügbar
| |
| __NOTOC__
| |
Diskussionen