多國語言（i18n）

Eagle 插件內建 i18next 模組，讓開發者輕鬆製作多語言插件。i18next 是 JavaScript 多國語言庫，易於翻譯、局部化並支援多種翻譯方法。

Eagle 插件內建了 i18next 模組，這使得開發者可以很輕鬆的製作出支援多國語言的插件。i18next 是一個用於多國語言應用的 JavaScript 庫，它可以輕鬆地處理多國語言翻譯，並且提供了多種翻譯的支援，包括自定義翻譯、局部化、多語系支援等。

以下我們將手把手説明如何讓插件支援多國語系：

步驟一、建立 `_locales` 資料夾

步驟二、建立語言 `.json` 檔案

{
    "manifest": {
        "app": {
            "name": "i18n example"
        }
    },
    "contextMenu": {
        "copy": "Copy",
        "paste": "Paste"
    }
}

{
    "manifest": {
        "app": {
            "name": "多國語言範例"
        }
    },
    "contextMenu": {
        "copy": "複製",
        "paste": "粘貼"
    }
}

{
    "manifest": {
        "app": {
            "name": "多國語言範例"
        }
    },
    "contextMenu": {
        "copy": "複製",
        "paste": "貼上"
    }
}

{
    "manifest": {
        "app": {
            "name": "i18n の例"
        }
    },
    "contextMenu": {
        "copy": "コピー",
        "paste": "ペース"
    }
}

目前支援的語言有 en, ja_JP, es_ES, de_DE, zh_TW, zh_CN, ko_KR, ru_RU。

步驟三、調整 `manifest.json`

使用 Eagle Plugin 的 i18next 功能，你可以透過設定簡單的 JSON 檔案來定義多國語言應用的翻譯。

{
    "id": "LE564883T24ZR",
    "version": "1.0.0",
    
    // 1. 調整名稱
    "name": "{{manifest.app.name}}",
    "logo": "/logo.png",
    "keywords": [],
    
    // 2. 設定支援語言、預設語言
    "fallbackLanguage": "zh_CN",
    "languages": ["en", "zh_TW", "zh_CN", "ja_JP"],
    
    "main": {
        "url": "index.html",
        "width": 640,
        "height": 480
    }
}

步驟四、更換程式碼中使用到的字串

調整 plugin.js，使用 i18next 方法獲取字串，並進行 alert

plugin.js

eagle.onPluginCreate((plugin) => {

    // 取得多國語言欄位
    let copyText = i18next.t('contextMenu.copy');
    let pasteText = i18next.t('contextMenu.paste');

    document.querySelector('#message').innerHTML = `
    <ul>
        <li>Language: ${eagle.app.locale}</li>
        <li>Copy: ${copyText}</li>
        <li>Paste: ${pasteText}</li>
    </ul>
    `;
});