Lingo のリンク

チェックアウトで使用する組織とローカライゼーションエンジンを選択したり、ファイルを削除せずに紐付けを解除したりできます。

lingo link は orgId と engineId を .lingo/config.json に保存します。これらの識別子は機密情報ではなく、ファイル翻訳の実行先を指定するものです。選択したリソースにアクセスできるかどうかは、引き続き現在有効な認証情報によって決まります。

sh
lingo whoami
lingo link

リンク時に組織とローカライゼーションエンジンが指定されていない場合は、選択を求められます。権限があれば、対話形式の手順でどちらのリソースも作成できます。既存のリソースを選択するには、--org <id> と --engine <id> を使用してください。表示名は識別子としては使えません。

組織のセットアップを完了する #

対話形式で新しい組織を作成すると、link が組織名の入力と初期設定に関する質問への回答を求めます。ウェブアプリでセットアップを進めると、お使いのウェブサイトをもとに、その組織で最初のエンジンが作成されます。

セットアップが完了するまでは、link に既存のエンジンは一覧表示されますが、別のエンジンを作成する選択肢は表示されません。利用可能なエンジンがない場合は、セットアップを完了するためのリンクを表示して終了します。ウェブでの手順を完了してから、lingo link を再実行してください。この初期設定時の制限は、招待を受けて参加した組織や API キー認証には適用されません。

どの組織にも所属していない場合や、所属する組織で必須の SSO サインインが現在のセッションで完了していない場合、link はウェブアプリへ案内します。組織を作成するか、既存の組織に参加するか、その組織の SSO プロバイダーを通じてサインインしてから、再試行してください。組織の識別子を指定しても、組織への所属や SSO の要件を回避することはできません。

紐付けるプロジェクトを確認する #

CLI は上位の階層にある最も近い .lingo/config.json を探します。そのため、入れ子になったパッケージ内でリンクを実行すると、上位階層のプロジェクトが変更されることがあります。ファイルをプッシュする前に、設定ファイルのパスと保存された識別子を確認してください。リンク操作では、ソースとターゲットのロケール、およびファイルエントリーの設定は保持されます。

フォークには、コピーされた設定内の識別子は引き継がれますが、元の組織のリソースへのアクセス権は引き継がれません。使用するローカライゼーションエンジンにリンクし直してください。モノレポでポリシーが異なる場合は、パッケージごとに設定を分け、それぞれのパッケージのルートからコマンドを実行してください。

ローカライゼーションエンジンは、モデルと言語に関するガイダンスを提供します。リンク操作はエンジンを選択するものであり、紐付けられたすべてのリソースや任意の処理段階がプロジェクトに適していることを保証するものではありません。初回の翻訳前に、エンジンの設定を確認してください。

sh
lingo unlink

リンク解除で削除されるのは orgId と engineId のみです。ローカライゼーション設定、ファイル、Lockfile は保持され、リモートのローカライゼーションエンジンが削除されたり、認証情報が無効になったりすることはありません。保存されたログイン状態を解除するには logoutを使用し、意図的にファイルを削除する場合に限り purgeを使用してください。

LINGO_API_URL は、プロジェクトのコンテンツと認証情報の送信先サーバーを選択します。API のオリジンを変更する前に、CLI の環境設定を参照してください。