このページでは、目次の構造およびプロパティーを編集することができます。
目次内の要素の構造および配列は、「目次」セクションを使用して変更および視覚化できます。 このセクションは、エディター領域の左側部分にあります。
目次内の特定要素のプロパティーは、その対応する「詳細」セクションを使用して変更できます。 これらのセクションは、「目次」セクションで選択した要素のタイプに応じて、エディター領域の右側部分に表示されます。
このページは、次のセクションで構成されています。
このセクションでは、以下を実行できます。
目次のツリー・ビューアー・フィールドには、目次の構造が表示されます。ヘルプ・システムではこの構造どおりに表示されることになります。 このツリー・ビューアーでは、既存要素を再編成したり、新規要素をツリーに追加したりすることで、目次の構造を変更できます。
このビューアーには、次の種類の要素が含まれています。
目次に新規のトピック、リンク、またはアンカーを追加するには、「トピックの追加」、「リンクの追加」、または「アンカーの追加」ボタンをクリックします。 これらのアクションは、何らかの要素が選択されている場合に使用できます。 選択されている要素がブック要素またはトピック要素である場合は、その選択されている要素の最後の子として新規の要素が表示されます。 それ以外の場合、要素は選択されている要素の直後に表示されます。
トピック要素は、HTML ファイルをドラッグして、目次内の希望の位置にドロップすることでも作成できます。 新規に追加されたトピックでは、ユーザーに対して、ドロップされたページを表示します。
同様に、リンク要素は、目次を表す XML ファイルをドラッグして、目次内の希望の位置にドロップすることで作成できます。 新規に追加されたリンクでは、ドロップされた目次を参照します。
目次から要素を削除するには、「削除」ボタンをクリックします。 このアクションは、ブック要素以外のすべての要素で使用できます。 目次の有効性を維持するため、ブック要素の唯一の直接の子となったトピックは削除できないことに注意してください。
要素の位置をその兄弟に対して 1 つ上に移動するには、「上へ」ボタンをクリックします。 このアクションは、ブック要素以外のすべての要素で使用できます。
要素の位置をその兄弟に対して 1 つ下に移動するには、「下へ」ボタンをクリックします。 このアクションは、ブック要素以外のすべての要素で使用できます。
目次内の要素は、それらを希望の位置にドラッグ・アンド・ドロップすることでも移動することができます。
目次またはトピックによって指定された文書ファイルを開くには、単にそのファイルをダブルクリックします。 リソース・ビューに文書ファイルを表示するには、単にその要素を右クリックして、「表示」サブメニューからオプションを選択します。
リンクによって指定された目次を開くには、単にそのリンクをダブルクリックします。 リソース・ビューに目次を表示するには、単にそのリンクを右クリックして、「表示」サブメニューからオプションを選択します。
「ブックの詳細」セクションでは、この目次の名前、ページ・ロケーション、およびアンカー・パスを編集することができます。
ブックの名前を指定するには、「名前」フィールドを編集します。
ブックと関連付けられたページのロケーションを指定するには、「ロケーション」フィールドを編集します。 このページは、ユーザーが「ヘルプ目次」ウィンドウでブック要素をクリックした際に表示されます。 ページが指定されていない場合は、実行時にヘルプ・システムによって自動的にデフォルトのヘルプ・ページが生成されます。
「アンカー」フィールドでは、この目次を他の目次の中に組み込むかどうかを指定できます。 アンカー・フィールドには、目次のパス、およびその目次に含まれているアンカーの ID を「#」記号で区切って指定します。 ユーザーが「ヘルプ目次」ウィンドウで参照先の目次を表示すると、指定のアンカーのロケーションにこの目次の内容が表示されます。
「ロケーション」フィールドに指定されたパスが既存の HTML ページを参照している場合、「ロケーション」ハイパーリンクをクリックすると、デフォルトのエディターでページが開きます。 このパスが、存在しないファイルを参照しているか、空である場合は、「ロケーション」ハイパーリンクをクリックした際に「新規ページ」ウィザードが開き、そこで HTML ページを作成できます。 このウィザードの「ファイル名」フィールドには、「ロケーション」フィールドのファイル名 (指定されている場合) が自動的に取り込まれます。 「ロケーション」フィールドに有効なフォルダー・パスが指定されている場合、ウィザードでは、新規ファイルのロケーションとしてこのパスが自動的に選択されます。
既存の HTML ページを選択する「ページ選択」ダイアログを開くには、「参照」ボタンをクリックします。 このダイアログには、ワークスペースに含まれている HTML ページの階層ビューが表示されます。 選択が完了すると、目次を含むプロジェクトから、選択された HTML ページへの相対パスが、「ロケーション」フィールドに自動的に入力されます。
「トピックの詳細」セクションでは、このトピックの名前およびページ・ロケーションを編集することができます。
トピックの名前を指定するには、「名前」フィールドを編集します。
トピックと関連付けられたページのロケーションを指定するには、「ロケーション」フィールドを編集します。 このページは、ユーザーが「ヘルプ目次」ウィンドウでトピック要素をクリックした際に表示されます。 ページが指定されていない場合は、実行時にヘルプ・システムによって自動的にデフォルトのヘルプ・ページが生成されます。
「ロケーション」フィールドに指定されたパスが既存の HTML ページを参照している場合、「ロケーション」ハイパーリンクをクリックすると、デフォルトのエディターでページが開きます。 このパスが、存在しないファイルを参照しているか、空である場合は、「ロケーション」ハイパーリンクをクリックした際に「新規ページ」ウィザードが開き、そこで HTML ページを作成できます。 このウィザードの「ファイル名」フィールドには、「ロケーション」フィールドのファイル名 (指定されている場合) が自動的に取り込まれます。 「ロケーション」フィールドに有効なフォルダー・パスが指定されている場合、ウィザードでは、新規ファイルのロケーションとしてこのパスが自動的に選択されます。
既存の HTML ページを選択する「ページ選択」ダイアログを開くには、「参照」ボタンをクリックします。 このダイアログには、ワークスペースに含まれている HTML ページの階層ビューが表示されます。 選択が完了すると、目次を含むプロジェクトから、選択された HTML ページへの相対パスが、「ロケーション」フィールドに自動的に入力されます。
「リンクの詳細」セクションでは、リンク先の目次ファイルのロケーションを編集することができます。
リンクする目次ファイルのロケーションを指定するには、「ロケーション」フィールドを編集します。 ユーザーが「ヘルプ目次」ウィンドウで目次を表示すると、目次内のこのリンクが、リンク先ファイル内の要素によって置き換えられます。
「ロケーション」フィールドに指定されたパスが既存の目次ファイルを参照している場合、「ロケーション」ハイパーリンクをクリックすると、デフォルトのエディターでページが開きます。 このパスが、存在しないファイルを参照しているか、空である場合は、「ロケーション」ハイパーリンクをクリックした際に「新規目次」ウィザードが開き、そこで新規の目次を作成できます。 このウィザードの「ファイル名」フィールドには、「ロケーション」フィールドのファイル名 (指定されている場合) が自動的に取り込まれます。 「ロケーション」フィールドに有効なフォルダー・パスが指定されている場合、ウィザードでは、新規ファイルのロケーションとしてこのパスが自動的に選択されます。
既存の目次を選択する「目次選択」ダイアログを開くには、「参照」ボタンをクリックします。 このダイアログには、ワークスペースに含まれている目次の階層ビューが表示されます。 選択が完了すると、プロジェクトから、選択された目次への相対パスが、「ロケーション」フィールドに自動的に入力されます。
「アンカーの詳細」セクションでは、このアンカーの ID を編集することができます。
アンカーの ID を指定するには、「ID」フィールドを編集します。