google-spreadsheet-to-js

多國語系檔案生成

根據 i18n-to-js.config 配置檔案 mode 選擇不同轉換方式 擷取google sheet excel 並 轉換成key:value 的js檔案

安裝與設定

1. 安裝

npm install excel-to-js-google-spreadsheet

2. 設定配置檔

# 複製範例配置檔
cp i18n-to-js.config.example.js i18n-to-js.config.js

# 編輯配置檔，填入你的設定
vim i18n-to-js.config.js

3. 配置檔說明

// i18n-to-js.config.js
const path = require("path");
module.exports = {
  mode: "LOCAL", // LOCAL: 讀取本地Excel | GOOGLE_SHEET: 使用Google API
  excelProjectToken: "YOUR_GOOGLE_SHEET_TOKEN", // Google Sheet 專案 token
  useApiKey: "YOUR_GOOGLE_API_KEY", // Google API key
  sheet: [], // 選擇excel表內sheet，空陣列表示處理所有sheet
  distFolder: "src/i18n/lang", // 檔案輸出資料夾
  sourceFilePath: "src/i18n/xxx.xlsx", // LOCAL模式時的Excel檔案路徑
  outputFormat: "js", // 輸出格式: 'js' JavaScript模組 | 'json' 純JSON檔案（可選，預設 'js'）
};

⚠️ 重要: i18n-to-js.config.js 包含敏感資料，已加入 .gitignore，請勿提交到版控系統。

| key | description | |--------|--| | mode | LOCAL: 讀取本地EXCEL , GOOGLE_SHEET: 使用google api | | excelProjectToken | 專案的token | | useApiKey | googleapi key | | sheet | 選擇excel 表內sheet | | distFolder | 檔案輸出資料夾 | | sourceFilePath | 讀取的EXCEL路徑 | | outputFormat | 輸出格式: 'js' JavaScript模組, 'json' 純JSON檔案（可選，預設 'js'） |

excel 表格長這樣

| key | structure | zh-CN | en | |--------|--------------|-------|--------| | login | login | 登入 | LOGIN | | logout | login | 登出 | LOGOUT | | name | user.columns | 名稱 | LOGOUT |

structure 能夠細分多層結構

輸出格式

JavaScript 格式 (outputFormat: 'js')

會生成 .js 檔案：

zh-CN.js

export default {
  login: {
    login: '登入',
    logout: '登出',
  },
  user: {
    columns: {name: '名稱'}
  }
};

en.js

export default {
  login: {
    login: 'LOGIN',
    logout: 'LOGOUT',
  },
  user: {
    columns: {name: 'Name'}
  }
};

JSON 格式 (outputFormat: 'json')

會生成 .json 檔案：

zh-CN.json

{
  "login": {
    "login": "登入",
    "logout": "登出"
  },
  "user": {
    "columns": {
      "name": "名稱"
    }
  }
}

en.json

{
  "login": {
    "login": "LOGIN",
    "logout": "LOGOUT"
  },
  "user": {
    "columns": {
      "name": "Name"
    }
  }
}