Knowledgebase:Mehrsprachigkeit

From Cloudrexx Development Wiki
Jump to: navigation, search


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]] [1] Label der entsprechenden Locale Schweizerdeutsch
[[COUNTRY_NAME]] [1] Name des Landes in der aktuellen Locale Switzerland
[[COUNTRY_CODE]] [1] ISO-3166-2 Ländercode der entsprechenden Locale de
  1. 1.0 1.1 1.2 Diese Platzhalter sind vorgesehen, aktuell aber noch nicht verfügbar.
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.