マニュアル キャンセル

アトラシアン Confluence ナレッジベースに公開します

Atlassian Confluence ナレッジベースに直接コンテンツを公開する方法を確認しましょう。

概要

Atlassian Confluence ナレッジベースを使用すると、チームですばやく簡単にソリューションにアクセスできます。 これにより、コンテンツの作成と整理が容易になり、強力な検索エンジンを備えたナレッジ管理用のアクセス可能なプラットフォームで、従業員やお客様を支援できます。

Confluence の統合により、Adobe RoboHelp では公開機能が拡張され、記事を Confluence ナレッジベースに直接公開できるようになりました。

前提条件

Confluence ナレッジベースに接続するには、Atlassian でアカウントを設定する必要があります。詳しくは、Atlassian サポートを参照してください。

主なリソース:

  • プロファイル
  • アカウントの設定

ワークフローの設定

以下に、出力を公開する前に Confluence ナレッジベースを設定する手順を示します。

公開プロファイルを設定する

出力を Confluence ナレッジベースに公開する前に、
プロファイルを作成して構成する必要があります。プロファイルを作成して構成するには、以下の手順を実行します。

  1. ツールバーで、編集/公開プロファイルをクリックします。

  2. 公開プロファイルダイアログで、 をクリックしてプロファイルを作成します。

  3. 「サーバータイプ」ドロップダウンリストフィールドで、「Atlassian Confluence」を選択します。

  4. Confluence 用のプロファイル名を追加します。

  5. プロファイルを Atlassian サーバーに接続する方法は 2 つあります。

    OAuth の使用

    「OAuth」のオプションを選択して Atlassian サイトに接続し、「ログイン」をクリックします。

    注意:

    これは、Confluence Cloud で利用可能なアカウントでのみサポートされています。

    サイトの URL を使用したプロファイルの公開

    サイトの URL の使用

    サイトの URL を入力します。 例:https://yourdomain.atlassian.net

    • ユーザー ID:Atlassian でアカウントを作成するために使用したユーザー ID を入力します。
    • API キー:ログインするための API キーを入力します。 「Manage API tokens for your Atlassian account | Atlassian Support」に記載されている API キーを生成します。
    OAuth を使用したプロファイルの公開

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

    RoboHelp にプロファイルが保存され、プロファイル列にプロファイル名が表示されます。

プロファイルの編集

プロファイルを編集するには、目的のプロファイル名をクリックしてそのフィールドを編集します。

プロファイルの削除

プロファイルを削除するには、プロファイルの近くにある をクリックします。

出力プリセットの作成

RoboHelp で出力プリセットを作成するには、以下の手順を実行します。

  1. 出力プリセットパネルで、をクリックします。

  2. 新しいプリセットダイアログボックスで、以下を指定します。

    タイプ:ドロップダウンリストで、プリセットタイプに「ナレッジベース」を選択します。

    名前:出力プリセットの名前を指定します。

    ターゲット:ターゲットのドロップダウンで、「Confluence ナレッジベース」を選択します。

    出力プリセットの作成

  3. 「終了」をクリックします。

    出力プリセットには、出力ツールバーの出力プリセットパネルからアクセスすることができます。または、オーサリングウィンドウのクイック生成ダイアログボックスから出力プリセットにアクセスすることもできます。

Confluence ナレッジベースの出力プリセットの構成

Confluence ナレッジベースの出力プリセットを構成するために、次の設定を使用できます。

全般

タイトル、ターゲット、出力パス、エンコーディングなど、基本的な出力設定を指定するには、以下のオプションを使用します。

タイトル:生成される出力のタイトルを指定します。

タイトル内で変数を使用することができます。 タイトル内で変数を使用するには、Ctrl+Shift+9 を押し、ドロップダウンリストで変数を選択して Enter キーを押します。「コンテンツ」タブ/「変数セット」フィールドで設定された変数を選択すると、出力の生成時に、その変数の値が変数セットから取得されます。

出力パス:出力の場所を指定します。場所を選択するには、 を選択します。

出力パスがプロジェクトフォルダーのパスに含まれていないことを確認します。出力パスがプロジェクトフォルダーに含まれている場合、出力は生成されません。 また、必要なコンテンツが保管されていないフォルダーを選択してください。RoboHelp はフォルダー内のコンテンツを削除した後、出力を生成します。

プロジェクトに対する相対パスとして出力パスを保存:有効にして出力パスを参照すると、出力へのパスは絶対パスではなく相対パスになります。

言語:出力の言語を選択する場合は、このドロップダウンリストを使用します。Confluence でサポートされている言語のリストが表示されます。

エンコーディング:Confluence では Unicode(UTF-8)エンコーディングを推奨しています。このオプションは、デフォルトで選択されています。

生成後スクリプト:ドロップダウンリストから、スクリプトの .js ファイルを選択し、出力生成後にカスタムスクリプトを実行します。

Confluence の一般設定

コンテンツ

以下のオプションを使用して、目次、条件式、変数セットなど、コンテンツ関連の出力設定を指定します。

目次:出力に含める目次を選択する場合は、このドロップダウンリストを使用します。このドロップダウンリストには、プロジェクトで使用可能な目次が表示されます。 デフォルトでは、このドロップダウンリストの最初の目次が選択されます。

選択された目次にあるファイルとその参照のセットが、生成された出力に表示されます。

条件式:出力の条件式を指定する場合は、このドロップダウンリストを使用します。この設定を使用すると、目的の出力タイプや対象ユーザーに応じて、出力内に表示するコンテンツと出力から除外するコンテンツを簡単に指定することができます。選択した条件式を編集するには、をクリックします。条件式を指定しない場合は、ドロップダウンリストで「なし」を選択します。

変数セット:このドロップダウンリストを使用して、該当する出力で使用する変数セットを指定します。ドロップダウンリストで「デフォルト変数セット」を選択すると、プロジェクトのデフォルト変数セットを使用できます。変数セットを使用すると、出力方法に応じて変数を使用できます。 例えば、お客様と内部ユーザーとで異なる変数セットを使用して出力を生成できます。

展開テキストコンテンツを含める:ナレッジベースの出力に展開テキストを含めるには、このオプションを選択します。このオプションを選択しない場合は、展開タイトルのみが出力されます。

ドロップダウンテキストコンテンツを含める:ナレッジベースの出力にドロップダウンテキストを含めるには、このオプションを選択します。このオプションを選択しない場合は、ドロップダウンのタイトルのみが出力されます。

注意:

Confluence では、記事内に JavaScript またはカスケードスタイルシート(CSS)を追加することは許可されていません。そのため公開では、ドロップダウンテキスト、展開テキスト、またはサムネイルイメージを使用しないようにしてください。ただし、この設定を使用すると、囲まれたテキストはプレーンテキストとして保存されます。

Confluence のコンテンツ設定

レイアウト

このオプションを使用して、出力の外観を設定します。

Confluence のレイアウト設定

Confluence

公開プロファイル:Confluence 接続プロファイルの中から選択するには、このドロップダウンを使用します。公開プロファイルの作成方法については、公開プロファイルの構成を参照してください。

スペース:コンテンツを公開するスペースを入力します。 このスペースは、Confluence サイトに存在している必要があります。

ページ: コンテンツの公開先となる親ページを入力します。 ページが選択されていない場合は、選択したスペースのルートにコンテンツが公開されます。

すべてのスタイルをインラインスタイルに変換:スタイルシートの適用が許可されていないため、出力を Confluence に公開するときに RoboHelp で使用するスタイルを維持するには、このオプションを選択します。

記事の本文からトピックの見出しを削除:このオプションを選択すると、出力を Confluence に公開する際に、RoboHelp に使用されるトピックの見出しが削除されます。

トピックの検索キーワードを記事タグとして使用:このオプションを選択すると、Confluence に公開した出力から記事のタグとして、トピックの検索キーワードが使用されます。

下書きとしてアップロード:このオプションをオンにすると、Confluence に公開されたすべての記事が下書き状態になります。

画像をアップロード:トピック内の画像を公開する出力に含める場合は、このオプションを選択します。

リンクされたドキュメントのアップロード:トピックにリンクされている PPT、PPTX、DOC、DOCX および PDF などのドキュメントを公開する出力に含める場合は、このオプションを選択します。

Confluence の設定項目

記事

Confluence ナレッジベースに公開するトピックを選択します。目次ノードを展開し、公開するトピックを選択します。

Confluence の記事設定

「保存」 を選択 して、出力プリセットに行った変更を保存します。 

Confluence ナレッジベースへの公開

ナレッジベースの出力プリセットを設定して Confluence にリンクし、Confluence ナレッジベースにコンテンツを公開できます。

  1. ツールバーで「出力」タブをクリックします。 事前定義された出力プリセットのリストが表示されます。

  2. 出力を編集するには、出力プリセットパネルで、任意の出力プリセットをダブルクリックします。

  3. プリセットを設定した後、Confluence に公開することができます。プリセットの近くにあるメニューアイコン(「...」)を選択し、「公開」を選択します。

    「編集」をクリックした後に、Confluence 出力プリセットの設定を編集することもできます。

  4. 出力プリセットパネルのプリセットを生成アイコン()をクリックします。

    次に、出力プリセットパネルで、選択した出力プリセットの横に表示されているプログレスバーを確認します。出力の生成が完了すると、画面の右下隅に成功ダイアログボックスが表示されます。 

    出力の生成が完了したら、出力プリセットパネルの をクリックして出力を表示します。

    出力の生成が成功したことを示すメッセージ

  5. 選択したプロファイル(サーバー)に公開するには、「記事」タブから公開する記事を選択します。 出力プリセットを選択し、標準ツールバーで を選択します。 または出力プリセットパネルを右クリックし、「公開」をクリックします。

  6. RoboHelp はコンテンツを Confluence に出力します。公開が完了すると、RoboHelp は公開されたコンテンツのレポートを表示します。

    生成されたレポート

  7. 公開された出力を表示するには、「プレビュー」アイコンを選択して、公開されたコンテンツのプレビューを表示します。 

    Atlassian ナレッジベースの出力

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

新規ユーザーの場合