chrome.i18n

Beschreibung

Manifest

Wenn eine Erweiterung ein /_locales-Verzeichnis hat, muss im Manifest "default_locale" definiert werden.

Konzepte und Verwendung

Sie müssen alle für den Nutzer sichtbaren Strings in eine Datei mit dem Namen messages.json einfügen. Jedes Mal fügen Sie eine neue Sprache hinzu, fügen Sie eine Nachrichtendatei unter einem Verzeichnis namens /_locales/_localeCode_ hinzu, wobei localeCode ist ein Code wie en für Englisch.

Hier ist die Dateihierarchie für eine internationalisierte Erweiterung, die Englisch (en und Spanisch) unterstützt. (es) und Koreanisch (ko):

Unterstützung mehrerer Sprachen

Angenommen, Sie haben eine Erweiterung mit den Dateien, die in der folgenden Abbildung dargestellt sind:

Um diese Erweiterung zu internationalisieren, benennen Sie jeden für den Nutzer sichtbaren String und fügen ihn in eine Nachricht ein. -Datei. Das Manifest, die CSS-Dateien und der JavaScript-Code der Erweiterung verwenden den Namen der einzelnen Strings, um ihre lokalisierte Version.

So sieht die Erweiterung aus, wenn sie international ist. Beachten Sie, dass sie immer noch nur Englische Strings):

<img "__msg_extname__",="" "default_locale"="" "de".="" „extname“."="" „hallo="“ _locates=&quot;&quot; a=&quot;&quot; alt="In der Datei „manifest.json“ " and=&quot;&quot; war="" changed=&quot;&quot; chrome.i18n.getmessage("extname").="" defines=&quot;&quot; en=&quot;&quot; file=&quot;&quot; file,=&quot;&quot; has=&quot;&quot; hello=&quot;&quot; in=&quot;&quot; item=&quot;&quot; javascript=&quot;&quot; messages.json=&quot;&quot; named=&quot;&quot; new="" src=&quot;/static/docs/extensions/mv2/reference/i18n/images/i18n-after-1.gif&quot; the=&quot;&quot; to=&quot;&quot; Wert="" Welt"=""

Hinweise zur Internationalisierung:

• Sie können jedes unterstützte Gebietsschema verwenden. Wenn Sie eine nicht unterstützte Sprache verwenden, ignoriert sie.

• Verweisen Sie in manifest.json- und CSS-Dateien so auf einen String mit dem Namen messagename:

  __MSG_messagename__
  

• Verweisen Sie im JavaScript-Code Ihrer Erweiterung oder Anwendung auf einen String mit dem Namen messagename, wie hier gezeigt:

  chrome.i18n.getMessage("messagename")
  

• In jedem Aufruf von getMessage() können Sie bis zu 9 Strings angeben, die in die Nachricht aufgenommen werden sollen. Weitere Informationen finden Sie unter Beispiele: getMessage für weitere Informationen

• Einige Nachrichten, z. B. @@bidi_dir und @@ui_locale, stammen von der Internationalisierung System. Eine vollständige Liste der vordefinierten Nachrichtennamen finden Sie im Abschnitt Vordefinierte Nachrichten.

• In messages.json hat jeder für den Nutzer sichtbare String einen Namen, eine „Nachricht“ und einen optionalen &quot;description&quot; ein. Der Name ist ein Schlüssel wie „extName“. oder „Suchzeichenfolge“ der die . Die „Nachricht“ gibt den Wert der Zeichenfolge in diesem Gebietsschema an. Die optionale Beschreibung „description“ für Übersetzer, die nicht sehen können, wie die Zeichenfolge . Beispiel:

  {
    "search_string": {
      "message": "hello%20world",
      "description": "The string we search for. Put %20 between words that go together."
    },
    ...
  }
  

Weitere Informationen finden Sie unter Formate: Sprachspezifische Nachrichten.

Nachdem eine Erweiterung internationalisiert wurde, lässt sie sich ganz einfach übersetzen. Sie kopieren messages.json, und übersetzen Sie sie und legen Sie die Kopie in einem neuen Verzeichnis unter /_locates ab. Um beispielsweise Spanisch, haben Sie einfach eine übersetzte Kopie von „messages.json“ unter /_locates/es gestellt. In der folgenden Abbildung zeigt die vorherige Erweiterung mit einer neuen spanischen Übersetzung an.

Vordefinierte Mitteilungen

Das Internationalisierungssystem enthält einige vordefinierte Nachrichten, die Ihnen bei der Lokalisierung helfen. Diese Fügen Sie @@ui_locale hinzu, damit Sie die aktuelle UI-Sprache und einige @@bidi_...-Meldungen erkennen können, die Textrichtung erkennen. Die letzten Nachrichten haben ähnliche Namen wie Konstanten in der Gadgets BIDI (bidirektional).

Die Sondermeldung @@extension_id kann in den CSS- und JavaScript-Dateien verwendet werden, unabhängig davon, ob die Erweiterung oder App lokalisiert ist. Diese Nachricht funktioniert nicht in Manifestdateien.

In der folgenden Tabelle werden die einzelnen vordefinierten Nachrichten beschrieben.

Hier ist ein Beispiel für die Verwendung von @@extension_id in einer CSS-Datei zum Erstellen einer URL:

body {
  background-image:url('chrome-extension://__MSG_@@extension_id__/background.png');
}

Wenn die Erweiterungs-ID abcdefghijklmnopqrstuvwxyzabcdef lautet, wird die fett formatierte Zeile im vorherigen Code wird zu:

  background-image:url('chrome-extension://abcdefghijklmnopqrstuvwxyzabcdef/background.png');

Hier ist ein Beispiel für die Verwendung von @@bidi_*-Nachrichten in einer CSS-Datei:

body {
  direction: __MSG_@@bidi_dir__;
}

div#header {
  margin-bottom: 1.05em;
  overflow: hidden;
  padding-bottom: 1.5em;
  padding-__MSG_@@bidi_start_edge__: 0;
  padding-__MSG_@@bidi_end_edge__: 1.5em;
  position: relative;
}

Für rechtsläufige Sprachen wie Englisch werden die fett formatierten Zeilen so dargestellt:

  dir: ltr;
  padding-left: 0;
  padding-right: 1.5em;

Sprachen

Sie können aus vielen Sprachen auswählen, einschließlich einiger (z. B. en), bei denen eine einzelne Übersetzung mehrere Varianten einer Sprache unterstützt (z. B. en_GB und en_US).

Sie können Ihre Erweiterung für jede Sprache lokalisieren, die vom Chrome Web Store unterstützt wird. Wenn dein Land hier nicht aufgeführt ist, wähle eine Alternative aus, die dir am nächsten kommt. Wenn die Standardsprache Ihrer Erweiterung beispielsweise "de_CH" ist, wählen Sie im Chrome Web Store "de" aus.

Nachrichten suchen

Sie müssen nicht jeden String für jede unterstützte Sprache definieren. Solange die Einstellung messages.json-Datei einen Wert für jeden String hat, wird Ihre Erweiterung oder App ausgeführt, egal wie dünnbesetzt ist. So sucht das Erweiterungssystem nach einer Nachricht:

1. Suchen Sie in der Nachrichtendatei (falls vorhanden) nach dem bevorzugten Gebietsschema des Nutzers. Wenn zum Beispiel Google als Sprache Britisches Englisch (en_GB) festgelegt ist, sucht das System zuerst in /_locates/en_GB/messages.json. Wenn die Datei bereits vorhanden ist und die Nachricht vorhanden ist, sucht das System nach nicht weiter.
2. Wenn das bevorzugte Gebietsschema des Nutzers eine Region enthält (d. h. einen Unterstrich: _), suchen Sie nach die Sprache ohne diese Region. Beispiel: Die Nachrichtendatei en_GB existiert nicht oder die Nachricht nicht enthält, sucht das System in der en-Nachrichtendatei. Ob die Datei existiert und die Nachricht vorhanden ist, sucht das System nicht weiter.
3. Suchen Sie in der Nachrichtendatei nach der Standardsprache. Wenn beispielsweise die „default_locale“ auf „es“ festgelegt ist und weder /_locates/en_GB/messages.json noch „/_locates/en/messages.json“ enthält die Nachricht, die Erweiterung verwendet die Nachricht von /_locates/es/messages.json

In der folgenden Abbildung zeigt die Meldung „colores“ in allen drei Sprachen verfügbar ist, unterstützt, aber „extName“ ist nur in zwei dieser Sprachen verfügbar. überall dort, wo ein Nutzer in den USA Google Chrome ausführt Im Englischen wird das Label „Colors“ angezeigt, für Nutzer von britischem Englisch „Colours“. Sowohl US-Englisch als auch Nutzer in britischem Englisch sehen den Erweiterungsnamen „Hello World“. Da die Standardsprache Spanisch ist, Nutzern, die Google Chrome in einer anderen Sprache als Englisch ausführen, wird das Label "Farben" angezeigt. und die Erweiterung den Namen „Hola mundo“.

Sprache des Browsers festlegen

Um Übersetzungen zu testen, können Sie die Sprache Ihres Browsers einstellen. In diesem Abschnitt erfahren Sie, wie Sie dem Gebietsschema unter Windows, Mac OS X, Linux und ChromeOS

Windows

Sie können die Sprache entweder über eine länderspezifische Tastenkombination oder über die Benutzeroberfläche von Google Chrome ändern. Die ist nach der Einrichtung schneller und ermöglicht es, mehrere Sprachen gleichzeitig zu verwenden.

Sprachspezifische Tastenkombination verwenden

So erstellen und verwenden Sie eine Verknüpfung, die Google Chrome mit einer bestimmten Sprache startet:

1. Erstellen Sie eine Kopie der Google Chrome-Verknüpfung, die sich bereits auf Ihrem Desktop befindet.
2. Benennen Sie die neue Verknüpfung so um, dass sie der neuen Sprache entspricht.

3. Ändern Sie die Eigenschaften der Verknüpfung so, dass im Feld „Ziel“ die --lang und --user-data-dir-Flags. Das Ziel sollte in etwa so aussehen:

   path_to_chrome.exe --lang=locale --user-data-dir=c:\locale_profile_dir
   

4. Starten Sie Google Chrome durch Doppelklicken auf die Verknüpfung.

Um beispielsweise eine Verknüpfung zu erstellen, mit der Google Chrome auf Spanisch (es) gestartet wird, könnten Sie ein Verknüpfung mit dem Namen chrome-es mit folgendem Ziel:

path_to_chrome.exe --lang=es --user-data-dir=c:\chrome-profile-es

Sie können beliebig viele Tastenkombinationen erstellen und so ganz einfach in mehreren Sprachen testen. Beispiel:

path_to_chrome.exe --lang=en --user-data-dir=c:\chrome-profile-en
path_to_chrome.exe --lang=en_GB --user-data-dir=c:\chrome-profile-en_GB
path_to_chrome.exe --lang=ko --user-data-dir=c:\chrome-profile-ko

Benutzeroberfläche verwenden

So ändern Sie das Gebietsschema in Google Chrome für Windows über die Benutzeroberfläche:

1. App-Symbol > Optionen
2. Wählen Sie den Tab Details aus.
3. Scrollen Sie nach unten zu Webinhalte.
4. Klicken Sie auf Schriftart- und Spracheinstellungen ändern.
5. Wählen Sie den Tab Sprachen aus.
6. Wählen Sie im Drop-down-Menü die Sprache für Google Chrome aus.
7. Chrome neu starten

Mac OS X

Um das Gebietsschema auf einem Mac zu ändern, verwenden Sie die Systemeinstellungen.

1. Wähle im Apple-Menü Systemeinstellungen aus.
2. Wählen Sie im Abschnitt Persönlich die Option International aus.
3. Sprache und Standort auswählen
4. Chrome neu starten

Linux

Um das Gebietsschema unter Linux zu ändern, beenden Sie zuerst Google Chrome. Legen Sie dann in einer Zeile die SPRACHE und starten Sie Google Chrome. Beispiel:

LANGUAGE=es ./chrome

ChromeOS

So ändern Sie die Sprache unter ChromeOS:

1. Wählen Sie in der Taskleiste Einstellungen aus.
2. Wählen Sie im Bereich Sprachen und Eingabe das Drop-down-Menü Sprache aus.
3. Wenn Ihre Sprache nicht aufgeführt ist, klicken Sie auf Sprachen hinzufügen und fügen Sie sie hinzu.
4. Klicken Sie nach dem Hinzufügen neben der Sprache auf das Dreipunkt-Menü Weitere Aktionen und wählen Sie ChromeOS in dieser Sprache anzeigen
5. Klicken Sie neben der festgelegten Sprache auf die Schaltfläche Neu starten, um ChromeOS neu zu starten.

Beispiele

Einfache Beispiele für die Internationalisierung finden Sie im Verzeichnis examples/api/i18n. Für eine vollständiges Beispiel finden Sie unter examples/extensions/news. Weitere Beispiele und Hilfe beim Anzeigen der siehe Beispiele.

getMessage()

Mit dem folgenden Code wird eine lokalisierte Nachricht vom Browser abgerufen und als String angezeigt. Es ersetzt zwei Platzhalter in der Nachricht durch die Zeichenfolgen "string1" und "string2".

function getMessage() {
  var message = chrome.i18n.getMessage("click_here", ["string1", "string2"]);
  document.getElementById("languageSpan").innerHTML = message;
}

So würden Sie einen einzelnen String angeben und verwenden:

  // In JavaScript code
  status.innerText = chrome.i18n.getMessage("error", errorDetails);

"error": {
  "message": "Error: $details$",
  "description": "Generic error template. Expects error parameter to be passed in.",
  "placeholders": {
    "details": {
      "content": "$1",
      "example": "Failed to fetch RSS feed."
    }
  }
}

Weitere Informationen zu Platzhaltern finden Sie auf der Seite Sprachspezifische Nachrichten. Weitere Informationen zu getMessage() aufrufen, finden Sie in der API-Referenz.

getAcceptLanguages()

Der folgende Code ruft Accept-languages vom Browser ab und zeigt sie als Zeichenfolge von Trennen der einzelnen Accept-Language-Sprachen durch ,.

function getAcceptLanguages() {
  chrome.i18n.getAcceptLanguages(function(languageList) {
    var languages = languageList.join(",");
    document.getElementById("languageSpan").innerHTML = languages;
  })
}

Weitere Informationen zum Aufrufen von getAcceptLanguages() findest du in der API-Referenz.

detectLanguage()

Mit dem folgenden Code werden bis zu drei Sprachen aus der angegebenen Zeichenfolge erkannt und das Ergebnis wird als durch Zeilenumbruch getrennte Strings.

function detectLanguage(inputText) {
  chrome.i18n.detectLanguage(inputText, function(result) {
    var outputLang = "Detected Language: ";
    var outputPercent = "Language Percentage: ";
    for(i = 0; i < result.languages.length; i++) {
      outputLang += result.languages[i].language + " ";
      outputPercent +=result.languages[i].percentage + " ";
    }
    document.getElementById("languageSpan").innerHTML = outputLang + "\n" + outputPercent + "\nReliable: " + result.isReliable;
  });
}

Weitere Informationen zum Aufrufen von detectLanguage(inputText) findest du in der API-Referenz.

chrome.i18n.detectLanguage(
  text: string,
  callback?: function,
)

chrome.i18n.getAcceptLanguages(
  callback?: function,
)

chrome.i18n.getMessage(
  messageName: string,
  substitutions?: any,
  options?: object,
)

chrome.i18n.getUILanguage()