マニュアル キャンセル

サービスプロバイダー向け翻訳フレームワークの設定

  1. RoboHelp ユーザーガイド
  2. 概要
    1. RoboHelp ワークスペースの概要
    2. RoboHelp(2022 リリース)の新機能
      1. アップデート 5 の新機能
      2. アップデート 4 の新機能
      3. アップデート 3 の新機能
      4. アップデート 2 の新機能
      5. アップデート 1 の新機能
    3. RoboHelp で解決済みの問題
    4. RoboHelp 必要システム構成
    5. Windows および macOS に RoboHelp をダウンロード
    6. アドビアプリのダウンロードおよびインストール
    7. RoboHelp FAQ
    8. RoboHelp(2020 リリース)の新機能
      1. アップデート 8 の新機能
      2. アップデート 7 の新機能
      3. アップデート 6 の新機能
      4. アップデート 5 の新機能
      5. アップデート 4 の新機能
      6. アップデート 3 の新機能
      7. アップデート 2 の新機能
      8. アップデート 1 の新機能
  3. プロジェクト
    1. RoboHelp プロジェクトの計画
    2. プロジェクトの作成
    3. プロジェクトの管理
    4. トピックとフォルダーの操作
    5. レポートの生成
    6. 状況依存ヘルプの使用
    7. 参照の管理
    8. RoboHelp での環境設定
  4. 作成者との共同作業
    1. Git を使用した共同作業
    2. SharePoint Online を使用した共同作業
    3. Azure DevOps(Team Foundation Server)を使用した共同作業
  5. PDF レイアウト
    1. PDF テンプレート
    2. ページレイアウトのデザイン
    3. PDF 出力の公開
    4. 一般的なコンテンツスタイルの利用
    5. PDF テンプレートのコンポーネント
    6. 言語変数のサポート
    7. PDF のカスタマイズ
  6. 編集と書式
    1. コンテンツの書式設定
    2. 相互参照の作成と管理
    3. リンクの作成と管理
    4. スニペットによるシングルソース
    5. 画像とマルチメディアの操作
    6. 作成した変数を使用して簡単に更新を行う
    7. 変数セットの操作
    8. 検索と置換の使用
    9. コンテンツの自動保存
    10. スプリットビューで並べて編集
    11. スペルチェック機能の使用
    12. ブックマークの作成と編集
    13. フィールドの挿入と更新
    14. 複数ビュー間の切り替え
    15. CSS の自動番号付け
  7. 読み込みとリンク
    1. プロジェクトへの Markdown ファイルの読み込み
    2. Word ドキュメントのプロジェクトへの読み込み
    3. FrameMaker ドキュメントのプロジェクトへの読み込み
  8. Toc、indexes、用語集および引用
    1. 目次の作成と管理
    2. 索引の作成と管理
    3. 用語集の作成と管理
    4. 引用の作成と管理
    5. 閲覧シーケンスの作成と管理
    6. 関連項目および関連トピックの操作
  9. 条件付きコンテンツ
    1. 条件付きコンテンツとは
    2. コンディションタグの作成と適用
    3. 条件付きコンテンツの出力プリセットの設定
    4. 条件付きコンテンツの最適化と管理
  10. マイクロコンテンツ
    1. マイクロコンテンツ
  11. レビューと共同作業
    1. レビューと共同作業
  12. 翻訳
    1. コンテンツの複数言語への翻訳
    2. サービスプロバイダー向け翻訳フレームワークの設定
  13. 出力を生成中
    1. 出力の生成
    2. フレームレス出力の生成
    3. ナレッジベース出力の生成
    4. PDF 出力の生成
    5. レスポンシブ HTML5 出力の生成
    6. Word ドキュメント出力の生成
    7. コンテンツのみの出力の生成
    8. 電子ブック出力の生成
    9. Microsoft HTML Help 出力の生成
    10. モバイルアプリ出力の生成
  14. 出力の公開
    1. RoboHelp Server への公開
    2. FTP サーバー、セキュア FTP サーバーまたはファイルシステムへの公開
    3. SharePoint Online への公開
    4. Zendesk ヘルプセンターへの公開
    5. Salesforce ナレッジベースに公開
    6. ServiceNow ナレッジベースへの公開
    7. Zoho ナレッジベースへの公開
    8. Adobe Experience Manager への公開
    9. アトラシアン Confluence ナレッジベースに公開します
  15. 付録
    1. Adobe RoboHelp スクリプトリファレンス
    2. RoboHelp のキーボードショートカット

RoboHelp を使用してコンテンツを動的に翻訳するために、選択した翻訳サービスプロバイダー向けの翻訳フレームワークを設定する方法を説明します。

すぐに利用できる定義済みの翻訳プロバイダーに加えて、翻訳コネクタを統合して要件に対応することもできます。

翻訳用カスタムスクリプトの使用

カスタムプロバイダーを設定するには、システム上で JavaScript ファイルを作成します。ファイルには、オブジェクトを戻り値として持つ関数が含まれています。この返されるオブジェクトには「呼び出し元」というフィールドがあり、戻り値として JavaScript Promise 型の関数が含まれています。

(src_lng, tar_lng, text2translate, API_KEY, endpoint) => { 
 //src_lang: source language 
 //tar_lang: target language 
 //text2translate: text to send for translation 
 //API_KEY: API key from your service provider 
 //endpoint: endpoint/API URL of your service provider 
 //build your query  
 var query:Function = //REST API goes here, which returns a Promise 
 return { 
  caller: query  
 } 
}

呼び出し元(関数)

返されたオブジェクトの呼び出し元フィールドで定義された関数は、JavaScript Promise を返す JavaScript の「リクエスト」メソッドを使用して、REST API リクエストをサーバーに送信します。Promise の解決 / 拒否に応じて、翻訳されたテキストを返すか、エラーが発生した場合にエラーをスローします。

Bing サンプルスクリプトファイル

(src_lng, tar_lng, text2translate, API_KEY, endpoint) => { 
     const uuidv4 = require('uuid/v4'); 
   const request = require('request'); 
 var api_request_fn = () => { 
   // return a promise because sending and receiving translated text is asynchronous procedure 
            return new Promise((resolve, reject) => {  
   var request_data = { 
              method: 'POST', 
              baseUrl: endpoint, 
              url: 'translate', 
              qs: { 
                'api-version': '3.0', 
                'to': [tar_lng] 
              }, 
              headers: { 
                 'Ocp-Apim-Subscription-Key': API_KEY, //your API key goes here 
                 'Content-type': 'application/json', 
                 'X-ClientTraceId': uuidv4().toString() //give an ID to your request 
              }, 
              body: [{ 
                    'text': text2translate //send the text to translate as a part of the body 
              }], 
              json: true, 
          }  
   // the structure of request_data is different for every service provider 
   // look up the documentation provided by your translation service provider  
   // to build the request data. 
 
                request(request_data, function(err, res, body) {  
     // read about request method here https://www.npmjs.com/package/request 
                    if(err) {// in case of an error reject the promise, it will exit the translation process 
                        reject({body, err, res}) 
                    } else {// in case of a valid response from the server, resolve the promise 
                        resolve({body, err, res}) 
                    } 
                }) 
            }).then(data => { 
                if(data.body.error) { 
     // in case error from the server is send as part of the body  
     // and skipping the previous if block in request, handle it here  
                    throw new Error(data.body.error.message); 
     // throw the error with the message you want to show,  
     // preferably the error message sent by the server 
                } else { 
                    return data.body[0].translations[0].text  
     // return the translated text here, in this case it is in the data at  
     // the specified location. The location in the data object varies with the provider 
                } 
            }) 
        } 
}

上記の例では、Bing translate API について説明しました。Google や Yandex は、Bing とは異なる処理となることに注意してください。サービスプロバイダーが提供する仕様に従って、この関数をビルドします。

RoboHelp インストールディレクトリの下記サンプルを精査することを強くお勧めします。
「resources/data/template/translation/bing/profile_builder.js」
「resources/data/template/translation/google/profile_builder.js」
「resources/data/template/translation/yandex/profile_builder.js」
「resources/data/template/translation/deepl/profile_builder.js」

注意:
  1. 顧客がこれらの翻訳機能を使用すると、データは処理のためにプロバイダーに送信されます。 
  2. そのデータの使用と処理は、プロバイダーとお客様の間の契約およびプロバイダーのプライバシーポリシーによって管理され、Adobe はプロバイダーに対して責任を負いません。

カスタム統合プロファイルの作成

  1. 翻訳プロファイルに移動します。詳細については、「機械翻訳プロファイルの作成」を参照してください。

  2. 新しいプロファイルを作成するには、「+」をクリックします。

  3. 翻訳プロファイルダイアログボックスで、API キーエンドポイントおよびカスタムスクリプトパスの詳細を入力します。

  4. 「検証」をクリックして、入力した資格情報が完全に正しいことを確認します。

  5. 「保存」をクリックします。

ヘルプをすばやく簡単に入手

新規ユーザーの場合

Adobe MAX 2025

Adobe MAX Japan
クリエイターの祭典

2025 年 2 月 13 日
東京ビッグサイト