Knowledgebase:Mehrsprachigkeit

Einführung

Cloudrexx ermöglicht es mehrsprachige Websites zu betreiben. Dabei wird jede Sprachversion der Website in einem virtuellen Sprachverzeichnis betrieben. Als Sprachverzeichnis wird der IETF language tag der jeweiligen Sprache(region) verwendet. Die deutsche (regionunabhängige) Sprachversion einer Website wird z.B. im virtuellen Sprachverzeichnis /de (www.example.org/de/) betrieben.

Hinweis: Diese Dokumentation bezieht sich auf die Version 5 und neuer. Für ältere Versionen von Cloudrexx, siehe Mehrsprachigkeit V4.

Template Integration

Sprachnavigation

Bei einer mehrsprachigen Website können die verschiedenen Sprachversionen der Website über eine Sprachnavigation verknüpft werden.

Sprachnavigation

Mit dem Block <!-- BEGIN/END locale_navbar --> kann eine Liste der korrespondierenden Inhaltsseiten anderer Sprachversionen erzeugt werden:

<!-- BEGIN locale_navbar -->

• [[PAGE_LINK]]
• [[PAGE_TITLE]]
• [[LOCALE]]
• [[LANGUAGE_CODE]]

<!-- BEGIN current_locale -->

Wird nur für die aktuelle Sprachversion angezeigt.

<!-- END current_locale -->

<!-- END locale_navbar -->

Erläuterung der Platzhalter:

Platzhalter	Bedeutung	Beispiel	Bemerkung
[[PAGE_LINK]]	Link zu der aktuellen Seite in der entsprechenden Locale	https://example.cloudrexx.com/de-CH/Willkommen
[[PAGE_TITLE]]	Titel der aktuellen Seite in der entsprechenden Locale	Willkommen bei Cloudrexx
[[LOCALE]]	RFC 3066 Angabe der entsprechenden Locale	de-CH
[[LOCALE_LABEL]]	Bezeichnung der Sprachversion	Schweizerdeutsch	Verfügbar ab 5.0.2
[[LANGUAGE_CODE]]	ISO-639-1 Sprachcode der aktiven Locale	de

Beispiel

<ul>
<!-- BEGIN locale_navbar -->
<li>
<a href="[[PAGE_LINK]]" <!-- BEGIN current_locale -->class="current"<!-- END current_locale -->>[[LOCALE]]</a>
</li>
<!-- END locale_navbar -->
</ul>

Deprecated

Die folgenden Platzhalter werden nicht mehr unterstützt und sollten daher nicht mehr genutzt werden. Anstelle dessen wird ausschlisslich die Verwendung von <!-- BEGIN/END locale_navbar --> empfohlen.

Platzhalter	Beschreibung	Beispiel
[[LANGUAGE_NAVBAR]]Deprecated	Automatisch generierte Sprachnavigation (Namen der Sprachen als Link)	<a class="de active" href="/de/Willkommen" title="Deutsch">Deutsch</a> <a class="en" href="/en/Welcome" title="English">English</a>
[[LANGUAGE_NAVBAR_SHORT]]Deprecated	Automatisch generierte Sprachnavigation (ISO 639-1 Code der Sprachen als Link)	<a class="de active" href="/de/Willkommen" title="DE">DE</a> <a class="en" href="/en/Welcome" title="EN">EN</a>
[[LANG_CHANGE_<CODE>]]Deprecated	Der Pfad zur jeweiligen Sprachversion der aktuellen Webseite	/de/Willkommen

Aktuelle Sprache

Mit dem Platzhalter [[ACTIVE_LANGUAGE_NAME]] kann der IETF language tag (z.B. de-CH) der aktuellen Sprachversion (angeforderte Sprachregion) ausgegeben werden.

Ausgewählte Sprache

Mit dem Platzhalter [[LANG_SELECTED_<CODE>]]] kann bestimmt werden, welche Sprachversion aktuell angefordert wurde. <CODE> ist mit dem jeweiligen IETF language tag zu ersetzen, wobei ein allfälliger Bindestrich (-) durch ein Unterstrich (_) ersetzt werden muss. Der Platzhalter für die aktuell angeforderte Sprachversion gibt den Wert selected aus. Alle anderen Platzhalter (der nicht angeforderten Sprachversionen) geben nichts aus.

Beispiel

Wird die Seite /de-CH/ aufgerufen, so werden die folgenden Platzhalter wie folgt abgefüllt:

Platzhalter	Wert
[[LANG_SELECTED_EN]]
[[LANG_SELECTED_DE_CH]]	selected
[[LANG_SELECTED_DE]]

Liste der Sprachversionen ausgeben

Mit dem Block <!-- BEGIN/END locale_alternate_list --> kann eine Liste aller Sprach- und Länderversionen einer Inhaltsseite erzeugt werden:

<!-- BEGIN locale_alternate_list -->

• [[PAGE_LINK]]
• [[PAGE_TITLE]]
• [[LOCALE]]
• [[LANGUAGE_CODE]]

<!-- END locale_alternate_list -->

Erläuterung der Platzhalter:

Platzhalter	Bedeutung	Beispiel
[[PAGE_LINK]]	Link zu der aktuellen Seite in der entsprechenden Locale	https://example.cloudrexx.com/de-CH/Willkommen
[[PAGE_TITLE]]	Titel der aktuellen Seite in der entsprechenden Locale	Willkommen bei Cloudrexx
[[LOCALE]]	RFC 3066 Angabe der entsprechenden Locale	de-CH
[[LANGUAGE_CODE]]	ISO-639-1 Sprachcode der entsprechenden Locale	de
[[LOCALE_LABEL]]	Label der entsprechenden Locale	Schweizerdeutsch
[[COUNTRY_NAME]]	Name des Landes in der aktuellen Locale	Switzerland
[[COUNTRY_CODE]]	ISO-3166-2 Ländercode der entsprechenden Locale	de

Beispiel

Dies ist u.a. nützlich für SEO, um damit eine Liste von alternate hreflang Tags zu erstellen.

<!-- BEGIN locale_alternate_list -->
<link rel="alternate" href="[[PAGE_LINK]]" hreflang="[[LOCALE]]" />
<!-- END locale_alternate_list -->

Weitere Sprachversionen hinzufügen

Zusätzliche Sprachversionen können in der Adminkonsole unter Administration > Lokalisierung hinzugefügt werden.

Tipp: Aktivieren Sie für jede neu hinzugefügte Sprachversion das gewünschte Webdesign Template unter Administration > Layout.