Lingo.dev + .csv（データ）

Lingo.dev CLIはCSVファイルの構造、ヘッダー、データの整合性を保持しながら翻訳し、コンテンツ管理やデータローカリゼーションを実現します。CLIは正確なCSV形式と区切り文字を維持し、列名を変更せず、数値や日付を保持しながらテキストコンテンツのみを処理し、UTF-8やさまざまな文字エンコーディングを安全に扱い、Excel、Google Sheets、データベースインポートとシームレスに連携します。

クイックセットアップ

ロケールベースの命名規則を持つCSVファイル用の設定：

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "csv": {
      "include": ["data/[locale].csv"]
    }
  }
}

注意：[locale]はプレースホルダーであり、設定内にそのまま残しておく必要があります。CLI実行時に実際のロケールに置き換えられます。

CSVデータの翻訳

npx lingo.dev@latest i18n

指定された列のテキストコンテンツを翻訳しながら、CSV構造、ヘッダー、データ型を保持します。

CSV構造の処理

ヘッダー付きコンテンツ

id,title,description,category
1,"Getting Started","Learn the basics quickly","Tutorial"
2,"Advanced Features","Deep dive into advanced topics","Guide"
3,"API Reference","Complete API documentation","Reference"

ヘッダーは変更されず、翻訳可能なコンテンツはローカライズされます。

混合データ型

product_id,name,price,description,created_date
SKU001,"Premium Widget",29.99,"High-quality widget for professionals","2024-01-15"
SKU002,"Basic Tool",9.99,"Simple tool for everyday use","2024-01-16"

テキスト列のみが翻訳され、数値、日付、IDはそのまま保持されます。

高度な機能

カスタム区切り文字のサポート

さまざまなCSV方言に対応：

• カンマ区切り：value1,value2,value3
• セミコロン区切り：value1;value2;value3
• タブ区切り：value1 value2 value3

引用符の処理

title,content,tags
"Article Title","Content with ""quotes"" inside","tag1,tag2"
"Another Article","Simple content","single-tag"

CSVの引用符とエスケープ規則を保持します。

高度な設定

複数のCSVファイル

"csv": {
  "include": [
    "data/[locale].csv",
    "content/[locale]/*.csv"
  ]
}

特定の列をロックする

"csv": {
  "include": ["data/[locale].csv"],
  "lockedKeys": ["id", "price", "created_date", "status"]
}

特定の列の翻訳を防ぐために、列ヘッダーをキーとして使用します。