Handbuch:Erweiterung/MenuEditor/Sprachen: Unterschied zwischen den Versionen

Version vom 23. Dezember 2021, 11:03 Uhr

Spracheinstellungen unterstützen[Bearbeiten | Quelltext bearbeiten]

Wenn die Elemente der Hauptnavigation in der jeweiligen Benutzersprache - also der Sprache, die ein Benutzer in den eigene Einstellungen aktiviert hat - angezeigt werden soll, muss für jeden Menüpunkt eine separate Nachrichtenseite existieren. Diese Nachrichtenseiten müssen sich im Namensraum MediaWiki befinden.

Da BlueSpice Englisch und Deutsch unterstützt, verwenden folgende Beispiele diese beiden Sprachen.

Im Beispiel erstellen wir einen Menüpunkt namens Quality assurance für ein Wiki mit der Spracheinstellung Englisch (site content language). Benutzer, die in ihren Einstellungen Deutsch (de) oder formales Deutsch (de-x-formal) angegeben haben, sollen stattdessen die Beschriftung Qualitätssicherung sehen.

Notwendige Schritte:

Erstellen oder bearbeiten Sie die Seite MediaWiki:QA und fügen Sie die englische Beschriftung hinzu (Quality assurance). Speichern Sie die Seite.
Erstellen oder bearbeiten Sie die Seite MediaWiki:QA/de und fügen Sie die deutsche Beschriftung hinzu (Qualitätssicherung). Speichern Sie die Seite.
Erstellen Sie den Link auf der Seite MediaWiki:Sidebar: **About_quality_assurance|QA Hiermit wird in der Hauptnavigation ein Link zur Seite About Quality Assurance erstellt und die Beschriftung angezeigt, die sich auf den Nachrichtenseiten in verschiedenen Sprachen befindet. Um die Sprachen zu testen, gehen Sie in Ihrem Benutzerprofilmenü zu Einstellungen> Benutzerdaten. Stellen Sie im Abschnitt Sprache die Sprache von Englisch auf Deutsch oder umgekehrt ein und speichern Sie die Einstellung. Die Sprache des Navigationslinks wird jetzt in der entsprechenden Sprache angezeigt.

Navigation in mehrsprachigen Wikis[Bearbeiten | Quelltext bearbeiten]

Wichtig!Diese Anleitung gilt nicht in einer Farmumgebung bzw. in getrennten Sprachwikis. Diese Anleitung benutzen Sie nur, wenn Sie Sprachen über Unterseiten pflegen.

Wenn Sie Inhalte über Unterseiten in mehreren Sprachen pflegen, möchten Sie, dass Benutzer mit einer englischen Spracheinstellung nicht nur die entsprechenden Menübezeichnungen sehen. Sie sollten auch auf die englische Seite geleitet werden, wenn sie auf den Menüpunkt klicken. Benutzer mit deutschen Spracheinstellungen sollten den deutschen Inhalt sehen, nachdem sie auf den deutschen Menülink geklickt haben. In diesem Fall müssen Sie zusätzlich zu den Sprachbezeichnungen separate Linkziele erstellen.

Hinweis:Um zu vermeiden, dass unterschiedliche Navigationsseiten für formales (de-formal) und informales Deutsch (de) eingerichtet werden müssen, können Sie eine Richtlinie erstellen, welche Spracheinstellung von Ihren Benutzern verwendet werden soll.

Im vorherigen Abschnitt haben wir die Beschriftungen bereits erstellt, wenn ein Benutzer die Sprache wechselt. Jetzt müssen wir auch verschiedene Linkziele für diese Seiten erstellen. Wenn die Hauptsprache Englisch ist und die Seite About quality assurance heißt, können die Übersetzungen auf Unterseiten gefunden werden. Die deutsche Version befindet sich beispielsweise unter About quality assurance/de.

So erstellen Sie die Linkziele zu den Sprachversionen der Seite:

Erstellen oder bearbeiten Sie die Seite MediaWiki:QA-url und fügen Sie den Link zur englischen Seite About quality assurance hinzu. Der Link wird ohne Klammern im Klartext eingegeben. Speichern Sie die Seite.
Erstellen oder bearbeiten Sie die Seite MediaWiki:QA-url/de und fügen Sie den Text für die deutsche Seite hinzu (About quality assurance/de). Der Link wird ohne Klammern im Klartext eingegeben. Speichern Sie die Seite.

Ändern Sie im Link zur Seite Quality Assurance von

** About_quality_assurance | QA

zu

** QA-url | QA

Dadurch wird der Sprachwechsel für die Zielseiten (QA-url) und für die Bezeichnung des Menüpunkts erreicht.

Abhängig von den Spracheinstellungen des Benutzers wird der Benutzer jetzt direkt zur richtigen Sprachversion geleitet.

Weiterführende Links

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

@@ Zeile 1: / Zeile 1: @@
+== Spracheinstellungen unterstützen ==
+Wenn die Elemente der Hauptnavigation in der jeweiligen Benutzersprache - also der Sprache, die ein Benutzer in den eigene Einstellungen aktiviert hat - angezeigt werden soll, muss für jeden Menüpunkt eine separate Nachrichtenseite existieren. Diese Nachrichtenseiten müssen sich im Namensraum ''MediaWiki'' befinden.
-== Navigation in mehrsprachigen Wikis ==
+Da BlueSpice Englisch und Deutsch unterstützt, verwenden folgende Beispiele diese beiden Sprachen.
-In mehrsprachigen Wikis sollen natürlich nicht nur die Inhalte, sondern auch die Navigation in unterschiedlichen Sprachen verfügbar sein. Um einen neuen Navigationspunkt in MediaWiki anzulegen, benötigen Sie deshalb immer zwei Seiten, auf die die Navigation zurückgreift:
-* Zum einen eine Seite, die den Link auf die Zielseite enthält
-* Zum anderen eine Seite, die den Alias Namen, der in der Navigation auftauschen soll enthält
-== Spracheinstellungen unterstützen ==
+Im  Beispiel erstellen wir einen Menüpunkt namens ''Quality assurance'' für ein Wiki mit der Spracheinstellung Englisch (site content language). Benutzer, die in ihren Einstellungen ''Deutsch (de)'' oder ''formales Deutsch (de-x-formal)'' angegeben haben, sollen stattdessen die Beschriftung ''Qualitätssicherung'' sehen.
-Wenn Sie sicherstellen möchten, dass Ihre Menüpunkte in der Sprache angezeigt werden, die ein Benutzer unter ''Einstellungen'' festgelegt hat, müssen Sie für jeden Menüpunkt eine separate Nachrichtenseite bereitstellen. Diese Nachrichtenseiten müssen sich im Namensraum ''MediaWiki'' befinden. Da BlueSpice Englisch und Deutsch (sowohl de als auch de-formal) unterstützt, benötigen Sie drei Sprachseiten für jeden Menüpunkt in der Seitenleiste.
-Im folgenden Beispiel erstellen wir einen Menüpunkt namens Quality assurance für ein Wiki mit Hauptsprache Englisch. Ein Benutzer, der in seinen Einstellungen Deutsch (de) oder formales Deutsch (de-formal) angegeben hat, sollte stattdessen die Beschriftung ''Qualitätssicherung'' sehen.
+'''Notwendige Schritte:'''
-'''Um die Beschriftungen in den Sprachversionen EN, DE und DE-formal zu erstellen:'''
+#'''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA'' und '''fügen''' Sie die englische Beschriftung '''hinzu''' (''Quality assurance''). '''Speichern''' Sie die Seite.
+#'''Erstellen oder bearbeiten''' Sie die Seite  ''MediaWiki:QA''/''de'' und '''fügen''' Sie die deutsche Beschriftung '''hinzu''' (''Qualitätssicherung''). '''Speichern''' Sie die Seite.
-# '''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA'' und '''fügen''' Sie die englische Beschriftung '''hinzu''' (''Quality assurance''). '''Speichern''' Sie die Seite.
-# '''Erstellen oder bearbeiten''' Sie die Seite  ''MediaWiki:QA''/''de'' und '''fügen''' Sie die deutsche Beschriftung '''hinzu''' (''Qualitätssicherung''). '''Speichern''' Sie die Seite.
-# '''Erstellen oder bearbeiten''' Sie die Seite  ''MediaWiki:QA''/''de-formal'' und fügen Sie die deutsche Beschriftung (''Qualitätssicherung''). '''Speichern''' Sie die Seite.
 # Erstellen Sie den Link auf der Seite ''MediaWiki:Sidebar'': <code>**About_quality_assurance|QA</code> Hiermit wird in der Hauptnavigation ein Link zur Seite ''About Quality Assurance'' erstellt und die Beschriftung angezeigt, die sich auf den Nachrichtenseiten in verschiedenen Sprachen befindet. Um die Sprachen zu testen, gehen Sie in Ihrem Benutzerprofilmenü zu ''Einstellungen> Benutzerdaten''. Stellen Sie im Abschnitt ''Sprache'' die Sprache von Englisch auf Deutsch oder umgekehrt ein und speichern Sie die Einstellung. Die Sprache des Navigationslinks wird jetzt in der entsprechenden Sprache angezeigt.
 == Navigation in mehrsprachigen Wikis ==
-{{Hinweisbox|boxtype=important|Note text=Diese Anleitung gilt nicht in einer Farmumgebung bzw. in getrennten Sprachwikis. Diese Anleitung benutzen Sie nur, wenn Sie Sprachen über Unterseiten pflegen.}}
+{{Hinweisbox|boxtype=Wichtig|icon=|Note text=Diese Anleitung gilt nicht in einer Farmumgebung bzw. in getrennten Sprachwikis. Diese Anleitung benutzen Sie nur, wenn Sie Sprachen über Unterseiten pflegen.|bgcolor=}}
-Wenn Sie Inhalte über Unterseiten in mehreren Sprachen pflegen, möchten Sie, dass Benutzer mit einer englischen Spracheinstellung  nicht nur die entsprechenden Menübezeichnungen sehen. Sie sollten auch auf die englische Seite geleitet werden, wenn sie auf den Menüpunkt klicken. Benutzer mit deutschen Spracheinstellungen sollten den deutschen Inhalt sehen, nachdem sie auf den deutschen Menülink geklickt haben. In diesem Fall müssen Sie zusätzlich zu den Sprachbezeichnungen separate Linkziele erstellen.{{Hinweisbox|boxtype=note|Note text=Um zu vermeiden, dass unterschiedliche Navigationsseiten für formales (de-formal) und informales Deutsch (de) eingerichtet werden müssen, können Sie eine Richtlinie erstellen, welche Spracheinstellung von Ihren Benutzern verwendet werden soll.}}
+Wenn Sie Inhalte über Unterseiten in mehreren Sprachen pflegen, möchten Sie, dass Benutzer mit einer englischen Spracheinstellung  nicht nur die entsprechenden Menübezeichnungen sehen. Sie sollten auch auf die englische Seite geleitet werden, wenn sie auf den Menüpunkt klicken. Benutzer mit deutschen Spracheinstellungen sollten den deutschen Inhalt sehen, nachdem sie auf den deutschen Menülink geklickt haben. In diesem Fall müssen Sie zusätzlich zu den Sprachbezeichnungen separate Linkziele erstellen.{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Um zu vermeiden, dass unterschiedliche Navigationsseiten für formales (de-formal) und informales Deutsch (de) eingerichtet werden müssen, können Sie eine Richtlinie erstellen, welche Spracheinstellung von Ihren Benutzern verwendet werden soll.|bgcolor=}}
 Im vorherigen Abschnitt haben wir die Beschriftungen bereits erstellt, wenn ein Benutzer die Sprache wechselt. Jetzt müssen wir auch verschiedene Linkziele für diese Seiten erstellen. Wenn die Hauptsprache Englisch ist und die Seite ''About quality assurance'' heißt, können die Übersetzungen auf Unterseiten gefunden werden. Die deutsche Version befindet sich beispielsweise unter  ''About quality assurance/de''.
@@ Zeile 27: / Zeile 22: @@
 # '''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA-url'' und '''fügen''' Sie den Link zur englischen Seite  ''About quality assurance'' '''hinzu'''. Der Link wird ohne Klammern im Klartext eingegeben. '''Speichern''' Sie die Seite.
 # '''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA-url/de'' und '''fügen''' Sie den Text für die deutsche Seite '''hinzu''' (''About quality assurance''/''de''). Der Link wird ohne Klammern im Klartext eingegeben. '''Speichern''' Sie die Seite.
-# '''Erstellen oder bearbeiten''' Sie die Seite ''MediaWiki:QA-url/de-formal'' und '''fügen''' Sie den Text für die deutsche Seite '''hinzu''' ( ''About quality assurance''/''de-formal).'' Der Link wird ohne Klammern im Klartext eingegeben. '''Speichern''' Sie die Seite.
 Ändern Sie im Link zur Seite ''Quality Assurance'' von
@@ Zeile 40: / Zeile 34: @@
 Abhängig von den Spracheinstellungen des Benutzers wird der Benutzer jetzt direkt zur richtigen Sprachversion geleitet.
+{{Box Links|Thema1=[[Handbuch:Erweiterung/BlueSpiceInterWikiLinks#Spezialfall:_Mehrsprachigkeit|Sprachversionen von Wikiseiten in unterschiedlichen Wikis verknüpfen]]}}