クイックスタート

更新日:前四半期 · 読了目安 1分

非推奨

このドキュメントは旧CLI(v0)について説明しています。現在のCLIはv1です。 現在の CLI ドキュメントを見る

CLI を使って、5分以内にセットアップを完了できます。

前提条件

Node.js 18.0 以上がインストールされていることを確認してください。確認するには node --version を実行します。

インストール#

お好みのパッケージマネージャーを使って、CLI をグローバルにインストールします。

bash
npm install -g lingo.dev

インストールを確認#

CLI が正しくインストールされていることを確認します。

bash
lingo --version

以下のような出力が表示されれば完了です。

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

プロジェクトを初期化#

プロジェクトのディレクトリに移動して、次を実行します。

bash
cd my-project
lingo init

この対話型コマンドで、次の設定を行います。

  1. アカウントに接続 - API キーで認証
  2. プロジェクトを選択 - 既存のプロジェクトを選ぶか、新しいプロジェクトを作成
  3. ロケールを設定 - 対応する言語を選択
  4. ファイル構成を設定 - 翻訳ファイルの保存先を選択

設定ファイルを作成しました

CLI は設定内容を含む i18n.json ファイルを作成します。このファイルは必要に応じてあとから変更できます。

最初の翻訳#

まずはシンプルな翻訳ファイルを作成します。

json
{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

翻訳を実行#

設定済みのすべての対象言語にコンテンツを翻訳します。

bash
lingo run

CLI は次の処理を行います。

  • ✅ ソースファイルを検出
  • ✅ lockfile との差分を計算
  • ✅ 変更されたコンテンツを翻訳バックエンドに送信
  • ✅ 翻訳結果をディスクに書き込み

ウォッチモード(開発向け)#

開発中は、ソースファイルの変更にあわせて自動で再翻訳するウォッチモードを有効にできます。

bash
lingo run --watch

ウォッチモードを終了するには Ctrl+C を押します。

ヘルプ#

サポートが必要ですか?

bash
# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

リアルタイムでサポートを受けるには、Discord community に参加してください!

次のステップ#