タイトル、出力パス、UI の文字列で使用する言語など、基本的な出力設定を指定するには、以下のオプションを使用します。
- RoboHelp ユーザーガイド
- 概要
- プロジェクト
- 作成者との共同作業
- PDF レイアウト
- 編集と書式
- 読み込みとリンク
- Toc、indexes、用語集および引用
- 条件付きコンテンツ
- マイクロコンテンツ
- レビューと共同作業
- 翻訳
- 出力を生成中
- 出力の公開
- 付録
ここでは、RoboHelp でフレームなし出力を生成し、コンテンツをオンラインまたはデスクトップアプリケーションで表示する方法について説明します。
フレームなし出力とは
フレームなし出力は Web やデスクトップアプリケーションを使用して表示することができます。この出力タイプは任意のブラウザーやプラットフォームで機能するだけでなく、カスタマイズ機能をいくつか提供します。
フレームなし出力プリセットの設定
RoboHelp プロジェクトの出力を生成するには、最初に出力プリセットを作成してから、その出力プリセットの各種設定を構成する必要があります。 フレームなし出力プリセットを構成するには、以下の設定を使用します。
全般
タイトル:生成された出力のタイトルを指定します。
タイトル内で変数を使用することができます。 タイトル内で変数を使用するには、「Ctrl + 1」を入力し、ドロップダウンリストで変数を選択して Enter キーを押します。「コンテンツ」タブ/変数セットフィールドで設定された変数を選択すると、出力の生成時に、その変数の値が変数セットから取得されます。
出力の「ブラウザ」タブに、タイトルが表示されます。タイトル内で変数が使用されている場合は、その変数も表示されます。
お気に入りアイコン:出力に関連付けるアイコンを指定します。このアイコンは出力のブラウザータブに表示されます。目的のアイコンを参照して選択するには、 をクリックします。
出力パス:出力の場所を指定します。場所を選択するには、をクリックします。
出力パスがプロジェクトフォルダーのパスに含まれていないことを確認します。出力パスがプロジェクトフォルダーのパスに含まれている場合、出力は生成されません。 また、必要なコンテンツが保管されていないフォルダーを選択してください。 RoboHelp はフォルダー内のコンテンツを削除した後、出力を生成します。
プロジェクトに対する相対パスとして出力パスを保存:有効にして出力パスを参照すると、出力へのパスは絶対パスではなく相対パスになります。
開始ページ:RoboHelp で出力の URL の生成に使用できるページ名と拡張子(.htm または .html)を指定します。例えば、index.html と指定します。
言語:生成後の出力の UI で、プロジェクト設定で指定したコンテンツの言語とは異なる言語を使用する必要がある場合は、このドロップダウンリストを使用して、出力プリセットの言語を指定します。
エンコーディング:コンテンツで使用する文字のエンコーディング形式を指定する場合は、このドロップダウンリストを使用します。
小文字のファイル名を使用:すべての出力ファイル名を小文字で生成する場合は、このオプションを選択します。
生成後スクリプト :出力生成後にカスタムスクリプトを実行するには、ドロップダウンリストから .js ファイルを選択します。
コンテンツ
以下のオプションを使用して、目次、索引、用語集、条件式など、コンテンツ関連の出力設定を指定します。
目次:出力に含める目次を選択する場合は、このドロップダウンリストを使用します。このドロップダウンリストには、プロジェクトで使用可能な目次が表示されます。 デフォルトでは、このドロップダウンリストの最初の目次が選択されます。
選択された目次にあるファイルとその参照のセットが、生成された出力に表示されます。
閲覧シーケンス:プロジェクトで定義されている閲覧シーケンスを表示する場合は、このドロップダウンを使用します。複数の閲覧シーケンスを選択することもできます。 選択した閲覧シーケンスは出力のためマージされます。 選択した閲覧シーケンスに競合が発生した場合は、最初に選択した閲覧シーケンスが優先されます。
デフォルトトピック:出力を開く際にトピックパネルに表示するトピックを選択するには、 をクリックします。デフォルトでは、該当する出力に対して選択した目次の最初のトピックがデフォルトトピックです。
マージした子プロジェクトから初期設定のトピックを選択することもできます。マージした子プロジェクトの下に表示されるリストは、選択した目次から読み取られます。
索引を含む:出力に索引ページを含める場合は、この設定を選択します。
用語集:出力に含める用語集を選択する場合は、このドロップダウンリストを使用します。用語集を使用すると、プロジェクト内の関連用語とその定義をすばやく取得できます。
条件式:出力の条件式を指定する場合は、このドロップダウンリストを使用します。この設定を使用すると、目的の出力タイプや対象ユーザーに応じて、出力内に表示するコンテンツと出力から除外するコンテンツを簡単に指定することができます。 選択した条件式を編集するには、をクリックします。条件式を指定しない場合は、ドロップダウンリストで「なし」を選択します。
ダイナミックコンテンツフィルター:ダイナミックコンテンツフィルターを選択し、生成された出力のコンテンツをフィルターできるようにするには、このドロップダウンリストを使用します。選択したダイナミックコンテンツフィルターを編集するには、 をクリックします。ダイナミックコンテンツフィルターを指定しない場合は、「なし」を選択します。
変数セット:該当する出力で使用する変数セットを指定する場合は、このドロップダウンリストを使用します。ドロップダウンリストで <デフォルト変数セット> を選択すると、プロジェクトのデフォルト変数セットを使用できます。変数セットを使用すると、出力方法に応じて変数を使用できます。 例えば、お客様と内部ユーザーとで異なる変数セットを使用して出力を生成できます。
マップファイル:状況依存ヘルプを使用する場合は、このドロップダウンを使用してマップファイルを選択します。詳細については、「状況依存ヘルプの使用」を参照してください。
レイアウト
以下のオプションを使用して、出力の外観を設定します。
カスタムホームページまたはトピックページフッターを作成し、選択したトピックに適用できます。フッターには、任意の動的要素(抜粋、変数、コンディショナルタグなど)を含めることができます。これらは、トピックに含まれている場合があります。
ホームページのフッターコンテンツ:ホームページ上にフッターとして表示するトピックを参照して選択するには、 をクリックします。例えば、Readme.htm と指定します。
トピックページのフッターコンテンツ:トピックページ上にフッターとして表示するトピック(.htm)を参照して選択するには、 をクリックします。例えば、README.htm と指定します。
PDF をダウンロード ユーザーが出力でPDF をダウンロードボタンをクリックしたときにダウンロードされる PDF を参照して選択するには、をクリックします。
ホームページのスキンを使用 出力にホームページを表示するには、このフィールドを選択します。
ホームページコンテンツのスキン 目次タイルと共にホームページ上に表示するトピックを参照するには、をクリックします。
検索
以下のオプションを使用して、出力の検索に関連する設定を指定します。
検索コンテキスト:検索コンテキストを指定すると、要件に基づいてトピックの検索結果をカスタマイズできます。 検索コンテキストには、次の 3 つのオプションがあります。
- 検索語の周囲のテキスト:このオプションを選択すると、最初に表示された検索語の周囲のテキストが表示されます。
- トピックの説明:このオプションを選択すると、トピックの説明がコンテキストとして表示されます。トピックプロパティの「一般/説明」で追加する説明が表示されます。
- トピックの開始テキスト:このオプションを選択すると、トピックの最初のコンテンツが表示されます。
検索コンテキストの文字制限を設定 :ここに数値を追加すると、トピックの検索結果で表示される文字数を制限できます。
検索ボックスの 自動入力機能を 有効化:このオプションを選択すると、ユーザーが最初に入力した文字に基づいて、検索クエリで予測した選択肢が表示されます。
検索クエリの 自動修正:このオプションを選択すると、入力された検索用語のスペルミスが修正されます。1 つの検索用語につき、このオプションで自動的に修正されるのは 1 文字だけです。 これにより、スペルが間違っている用語を入力した場合であっても、その用語に関連する結果が検索されることになります。
用語集の定義を表示:このオプションを選択すると、この出力に対して選択された用語集から検索用語の定義が表示されます。用語集に登録されている用語のうち、検索用語と一致する用語の定義が表示されます。
XML サイトマップを生成:この設定を選択すると、公開する出力用のサイトマップが生成されます。公開した出力の sitemap.xml ファイルにはサイトマップが含まれています。このファイルを検索エンジンに送信すると、サイトの検索結果を改善できます。sitmap.xml ファイルを送信するには、お使いの検索エンジンのマニュアルに記載されている手順に従ってください。「ホストされているコンテンツのベース URL」で、サイトの関連 URL を入力します。「コンテンツ変更の頻度」で、コンテンツの索引を作成する頻度を指定します。
検索から除外するファイルタイプを選択:PDF、Word、Excel など、特定のファイル形式を検索対象から除外できます。選択したファイルタイプのコンテンツは、検索対象にはなりません。
圧縮ファイルを検索などで使用するには、サーバー側で圧縮が有効になっている必要があります。
現在、1KB を超えるすべての CSS ファイルおよび JavaScript ファイルは gzip 形式で圧縮され、出力フォルダーに元のファイルと共に含まれています。 ファイルは、サーバーからの圧縮ファイルのリクエストに応じて呼び出されます。
公開
出力は SharePoint Online および FTP、SFTP またはファイルシステムに公開できます。出力を公開できるようにするには、まず適切なサーバーの種類用の公開プロファイルを設定します。詳細については、次のセクションを参照してください。
公開プロファイルを保存すると、 RoboHelp の公開タブにプロファイルが表示されます。 出力を公開するには、該当する公開プロファイルを選択し、 をクリックします。
初期設定では、選択された公開プロファイルを使用して公開されるのは、前回の公開以降に変更されたファイルのみです。
すべてのファイルを公開するには、「すべてを再公開」を選択し、をクリックします。公開ログを表示するには、出力プリセットパネルで、該当する出力プリセットについて/「公開ログを表示する」を選択します。
フレームなし出力の生成
-
プロジェクトのオーサリングウィンドウで、標準ツールバーの右上隅に表示されているクイック生成アイコン()をクリックします。または、出力メニューで「クイック生成」を選択します。
-
クイック生成ダイアログボックスで、フレームなし出力プリセットを選択します。
-
設定を構成するには、以下に示すいずれかの操作を実行します。
- クイック生成ダイアログボックスで、設定を編集アイコン()をクリックします。
- 標準ツールバーの左側に表示されている「出力」タブをクリックします。
出力ビューが表示されます。
-
出力ツールバーで、「出力プリセット」をクリックします。 出力プリセットパネルで、以下に示すいずれかの操作を実行します。
- 目的のフレームなし出力プリセットをダブルクリックします。
- 目的の出力プリセットの横に表示されている アイコンをクリックし、「編集」を選択します。
-
出力設定の構成方法については、「フレームなし出力プリセットの設定」を参照してください。
-
出力ビューの標準ツールバーの左上隅に表示されている保存アイコン()をクリックして、設定を保存します。
-
出力プリセットパネルのプリセットを生成アイコン()をクリックします。
次に、出力プリセットパネルで、選択した出力プリセットの横に表示されているプログレスバーを確認します。出力の生成が完了すると、画面の右下隅に成功ダイアログボックスが表示されます。
出力の生成が完了したら、出力プリセットパネルの をクリックして出力を表示します。
注意:オーサリングウィンドウで出力を生成することもできます。その場合は、ツールバーでクイック生成アイコン()をクリックし、目的の出力プリセットを選択して「生成」をクリックします。
次に、クイック生成ダイアログボックスのプログレスバーを確認します。出力の生成が完了したら、出力プリセットの横に表示されている をクリックして出力を表示します。出力の生成が失敗した場合は、選択した出力プリセットの横に表示されている をクリックしてエラーログを確認します。
-
選択したブラウザーで出力を表示するには、「アプリケーションを選択して表示」を選択し、コンピューターにインストールされているブラウザーのいずれかを選択します。現在利用可能なブラウザーは、Google Chrome、Internet Explorer、Mozilla Firefox などで、アルファベット順に一覧表示されています。コンピューターにインストールされている任意のブラウザーで出力をプレビューできます。この「アプリケーションを選択して表示」オプションは、オーサリングのプレビューモードでも使用できます。
ユーザーは、任意の新しいブラウザーをダウンロードしてインストールすることができます。新しいブラウザーがインストールされると、ブラウザーの一覧に表示されるようになります。
フレームレス出力における Google アナリティクスのサポート
Google アナリティクスを利用すると、ページビュー、セッション時間、ユーザーのインタラクションなどの指標を簡単に追跡できます。 フレームレス出力はシングルページアプリケーション(SPA)のように機能します。違うトピックを開くと出力全体を再読み込みできません。 ただし、違うトピックやブックマークを開くと URL が変わります。 Google アナリティクスは URL のこの変更履歴を追跡することで、データを取得します。
次の手順に従うと、(サーバーでホストされている)フレームレス出力と Google アナリティクスを統合できます。
詳しくは、「Google のタグマネージャーのサポート」を参照して、Google タグマネージャーの変更履歴トリガーを使って指標を追跡する方法をご覧ください。
-
Google のタグマネージャーに移動して、アカウントを設定します。
-
ワークスペースで次のタグを見つけてください。
-
Robohelp プロジェクトを開きます。 作成者タブで「トピックレイアウト」を選択します。
-
トピックレイアウトの「ソース」ビューを選択して、前述のコードを<head> タグおよび <body> タグに貼り付けます。
-
出力タブ/出力プリセット/フレームレス/レイアウト
を選択します。 -
「トピックレイアウト」ドロップダウンからトピックレイアウトを選択します。
-
フレームレス出力を生成して、出力をサーバーでホストします。
-
Google のタグマネージャーワークスペースのワークスペースで「プレビュー」を選択し、タグアシスタントをサイトに接続するウィンドウを開きます。
-
サイトの URL を入力し、「接続」を選択して、ホストされている出力を Google のタグマネージャーに接続します。
出力全体を移動する際にデータを収集して、追跡履歴を表示できるようになりました。