この記事では、複数の言語で表示されるガイドの作成と管理を担当するチーム向けの、ベストプラクティスをご紹介します。お客様の組織には、新しいガイドが作成・公開されるたびに使用する内部チェックリストがあるかもしれません。Pendoのローカライズ機能を使用している場合は、そのチェックリストにローカライズ固有の項目をいくつか追加することをお勧めします。これにより、エラーを回避し、各ガイドのローカライズに必要な時間を短縮できます。ローカライズを初めて行う方で、Pendoのローカライズ機能の包括的な概要が必要な場合は、ローカライズの記事をご覧ください。
事前に計画を立てる
ローカライズプロセスを開始する前に、明確な行動計画を立てましょう。サポートする言語を特定し、ローカライズ作業の範囲を決定します。この言語はPendoサブスクリプションですでに設定されており、特定のガイド用に新しい翻訳を作成するだけでよいのか、それともその言語をサブスクリプションのサポート対象言語として設定する必要もあるのかを確認します。
ヒント：ローカライズプロセスを開始する前に、ガイドの内容を完成させることを強くお勧めします。
設定
XLIFFファイル内のターゲット言語コードは、目的の言語の言語設定メタデータ値と一致する必要があります。これを調整するには、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］>［アプリケーション（Applications）］に移動し、お客様のアプリケーション、アプリを選択し、［ローカライズ設定（Localization Settings）］を選択します。
ターゲットフィールド
<source>フィールドから同じ情報をコピーする場合でも、XLIFFファイル内のすべての<target>フィールドには値が必要です。例：
<xliff...>
<file....source-language="en-US" target-language="fr-FR">
...
<trans-unit id="ID string">
<source> Hello </source>
<target> Bonjour </target>
<note> TextView </note>
</trans-unit>
...
</file>
</xliff>
サードパーティ製アプリケーション
コンテンツの翻訳とローカライズに利用できるツールは複数ありますが、一部のツールでは、PendoにアップロードするときにXLIFFファイルに互換性がなくなる可能性があります。Pendoは特定の翻訳ツールやサービスを推奨したり、ガイドコンテンツの翻訳を提供したりすることはありませんが、多くのお客様はCrowdin、Xliff Editor、Smartlingを使用しています。
ガイドの複製
すでに翻訳されたガイドを複製する場合、ガイドの新しいコピーをPendoで再度翻訳する必要があります。残念ながら、元のガイドのXLIFFファイルは、ガイドの新しいコピーと互換性がありません。翻訳するには、ガイドの新しいコピーからXLIFFファイルをエクスポートする必要があります。
動画
Unicode以外の文字を使用するビデオリンクを正しく表示するには、<target>フィールドのCDATAタグで囲む必要があります。
例
<trans-unit id="ID string">
<source> <![CDATA[https://www.youtube.com/watch?v=videoIdGoesHere]]></source>
<target><![CDATA[https://www.youtube.com/watch?v=videoIdGoesHere]]></target>
<note> interst.io.VideoPlayerView </note>
</trans-unit>
ローカライズの制限
ガイドがカスタムコードブロックまたはガイドバッジアイコン（カスタムテキストに設定されている場合）のいずれかを使用している場合、ガイドのこれらのセクションは翻訳されず、デフォルトの言語で表示されます。ガイドの他の部分は翻訳されます。
ガイドのプレビュー
インポートしたXLIFFファイルを使ってガイドをプレビューし、異なる言語でどのように見えるかを確認できます。ガイド設定内の［表示（Viewing）］ドロップダウンから、表示する言語を選択します。
または、［プレビュー（Preview）］を選択して、ドロップダウンから言語を選択することもできます。
メンテナンス
XLIFFファイルを監査する
XLIFFファイルをアップロードした後でガイドに追加のコンテンツ編集を行う場合は、新しいファイルをアップロードする必要があります。ガイドを変更すると、XLIFFファイル内のIDが変更され、インポートされた元の翻訳ファイルの位置が合わなくなり、エラーが発生することがあります。これは、リソースセンターで作成された新しいモジュールにも当てはまります。モジュールを追加または削除する場合は、リソースセンター用に新しい翻訳ファイルをアップロードする必要があります。
ローカライズ、トラブルシューティング、XLIFFコードでの作業についての詳細は、ローカライズの記事、エラー：XLIFF翻訳ファイルの不具合の記事、XLIFFコードの作業の記事をご覧ください。