ドキュメンテーション テーマを設定する

スクリーンショット：ナビゲーションサイドバーに置き換えた空間のサイドバーを示すドキュメントのテーマ。

ドキュメンテーションテーマをスペースに適用する

ドキュメンテーションテーマを適用するには、以下の手順に従ってください。スペース内のすべてのページですぐにテーマが有効化されます。

ドキュメンテーションテーマをサイトに適用する

If you have site administrator permissions, you can apply the theme at site level. It will then be the default theme for all spaces in the site. See the administrator's guide to applying a theme.

ドキュメンテーションテーマのカスマイズ

テーマは、カスタマイズしなくとも、動作します。必要に応じて、検索を1スペースだけのように制限することができ、左側のナビゲーションパネルの内容を変更し、独自のヘッダーとフッターを追加します。以下の手順では、ドキュメンテーションテーマを既に適用していると仮定します。

ドキュメンテーションテーマをカスタマイズするには；

1. Choose Browse > Space Admin at the top of the screen.Note: The 'Space Admin' option appears only if you have space admin permissions for the space or you have System Administrator global permissions.
2. 「ルックアンドフィール」という見出しの左パネルで、テーマをクリックします。
3. ページの上部にある”現在のテーマ” セクションの黄色のエリアでテーマを設定する選択します。以下のスクリーンショットを参照ください。「ドキュメンテーションテーマの設定」画面が表示されます。以下のスクリーンショットを参照してください。
4. ページ ツリーのチェックボックスを選択または選択解除します。これはスペースで、左側のパネル内のコンテンツのデフォルトの検索ボックスとテーブル（ページツリー）を表示するかどうかを決定します。
5. 現在のスペースに検索結果の表示件数を制限するのチェックボックスを選択または選択解除する。
   
   • チェックボックスを選択した場合：
     
     • The Confluence search will look for matches only in the current space by default. Users can override this restriction when entering their search term. See Using the Documentation Theme.
     • 左側のパネルの既定ページツリーには検索ボックスは含まれません。
   • チェックボックスを選択しない場合：
     
     • Confluence 検索では Confluence 全体を検索します。 これは他のテーマでも既定の挙動です。
     • 左側のパネルの既定ページツリーに、検索検索を現在のスペースに制限した、検索ボックスが含まれます。
6. Enter text, images, macros and other wiki markup into any or all of the three text boxes.
   You can use the Include or Excerpt Include to include re-usable content into your footer. See hint below.
   
   • 「ナビゲーション」 - このテキストボックスには、左側のパネルのためのコンテンツが含まれています。
     
     • ページ ツリー チェックボックスが選択されている場合、ナビゲーションパネルには既定の検索ボックス、ページ ツリーが含まれます。「ナビゲーション」テキストボックスに入力した内容はすべて 上記の ページ ツリーと検索ボックスに表示されます。
     • 上記だけでなく、ページツリーの下に独自のコンテンツを含むことができます。 下記のヒントを参照してください。
       要点としましては、ページ ツリーチェックボックスの選択解除します。ページツリーマクロを使用した、独自のページツリーを挿入し、 マクロの下に独自のコンテンツを追加します。
   • 「ヘッダー」 - このテキストボックスには、スペース内のすべてのページのページタイトルの上に表示されるページのヘッダの内容が含まれています。以下 のサンプルのスクリーンショットを参照してください。
   • 「フッター」 - このテキストボックスには、スペース内のすべてのページで、コメントの後に、サイトのフッターの上に表示されますページのフッターのコンテンツが含まれています。 以下のサンプルのスクリーンショットを参照してください。。
7. [保存] を選択します。

スクリーンショット：'テーマの設定' のオプション

スクリーンショット：ドキュメンテーションテーマのカスマイズ

サイトレベルでのテーマのカスマイズ

If you have site administrator permissions, you can apply and customise the theme at site level. The customisation options are the same as the space level options, as described above.

ドキュメンテーションテーマの機能

スクリーンショット：カスタマイズされたヘッダー、フッター、および左側のパネル

上のスクリーンショットは、カスタマイズされた左側のパネル、ヘッダーとフッターを持つWikiスペースを示しています。

ここで、ドキュメントのテーマが提供する機能の概要を紹介します。

• 既定では、左側のパネルには、スペース内のすべてのページを表示する、検索ボックスと目次（ページツリー）が含まれています。具体的には、スペースのホームの子ページのみを検索します。
• 左側のパネルは、完全にカスタマイズ可能です。検索ボックスとページツリーを含めるか除外するかを選択することができます。独自のテキスト、画像やwikiマークアップを入力することができます。
• People viewing the page can drag the thick bar between the left-hand panel and the content, to increase or decrease the width of the panel. They can also remove the panel altogether, by clicking the sidebar icon at top right, next to the search box.
• 左側と右側のパネルは、互いに独立してスクロールします。
• ページタイトルはきちんとページコンテンツの上部にあり、ナビゲーションパネルを挿入することがあるとしても、ナビゲーションパネルの上部で不快ではありません。
• 左側のパネルはテーマの一部であるため、Confluence をアップグレードするたびに、このパネルもアップグレードされます。左側のナビゲーションバーを独自に追加している場合に行うような、アップグレードごとにカスタマイズを削除してから再適用するといった作業の必要はありません。
• テーマはまた、すべてのページの上部と下部に表示されますカスタマイズヘッダーとフッターを提供します。
• テキストと見出しスタイルは、ドキュメントのスペースで典型的なコンテンツを強化するために設計されています。
• スペースジャンプ マクロを使用すると、リンク作成時にページの名前を知らなくても、Wiki スペースのページから別のスペースの同じ名前のページにリンクできます。
• You can limit the Confluence search results to the current space. If you choose this option, the Confluence search will look for matches only in the current space by default. Users can override the restriction. See Using the Documentation Theme.

ヒントとコツ

左側の目次からページを隠す

スペースホームのページよりも同じレベル、またそれ以上に配置することでページを「隠す」ことができます。

各スペースは、[ホーム]ページとして指定された単一のページを持っています。スペースの管理セクションで、ホームのページを指定することができます

テーマはスペースのホームの子ページにあるすべてのページから左側のパネルにページツリーを構築します。

ドキュメントページは、スペースのホームのページと同じレベルにある場合は、左側のナビゲーションバーに表示されません。スペースホームのページよりも同じレベル、またそれ以上に配置することでページを「隠す」ことができます。ページが検索結果に表示され、彼らはページを開いた場合、人々は、コンテンツを見ることができますが、ページが左側のパネルに表示されません。

もっと詳しく：目次を生成するには、ページツリーマクロを使用します。ページツリーマクロを入力するときは、ページツリーのトップページを選択することができます。ドキュメンテーションテーマは、トップページとしてスペースのホーム・ページを選択します。

ヘッダー、フッターやサイドバーに再利用可能なコンテンツを使用する

テーマのヘッダー、フッター、または左側のパネル内の任意のテキストやwikiマークアップを使用することができます。 役立つヒントには、ページを含めるまたは抜粋を含めるのマクロの使用があります。

上記のスクリーンショットには、他のページからコンテンツを含めるために使用されるマクロの例として、テーマのカスタマイズオプションを示しています。また、上記 のスクリーンショットの例でもヘッダー、フッターまた、左側のパネルの例を表示しています。

サイドバーでページツリー配下に内容を追加する

ページツリーの下に独自のコンテンツを含める場合は、「ページツリー」チェックボックスの選択を解除し、「ナビゲーション」テキストボックスでページツリーマクロ を使用して、マクロの下に自分のコンテンツを追加します。

上記のスクリーンショットには、テーマのカスタマイズ オプションが表示されていて、左側のパネルにコンテンツが追加されるとともに、既定のページ ツリーの選択が解除され、カスタムのページ ツリーが挿入されています。上記のカスタマイズ例を示すスクリーンショットは、左側パネルのカスタマイズ結果も表示しています。

すべてのバージョン展開のセクションをサイドバーに追加する

このスペースに含まれているように、他のスペースへのリンクの展開リストを含めたい場合、「ナビゲーション」テキストボックスで展開とページマクロを含める マクロを使用することができます。（サイドバーの「すべてのConfluenceリリースのドキュメント」を参照してください）例えば：

*[Docs for all Confluence releases|_Latest Versions of Confluence Documentation]*
{expand:Choose a version...}
{include:_Latest Versions of Confluence Documentation}
{expand}

このページツリーの下に表示したい場合は、上記の手順に従ってください 。

リンクに下線を追加する

既定では、ドキュメント用 テーマはハイパーリンクに下線を付けません。リンクに下線を付けたい場合は、スペースの CSS スタイルシートを編集し、次の CSS コードを追加します。

.wiki-content a:link, .wiki-content a:visited, .wiki-content a:active {
  text-decoration: underline;
}

別のスペースで同じページにジャンプする

{spacejump}マクロは、ドキュメンテーションテーマに沿って設けられています。スペースジャンプ マクロ を使用すると、 リンク作成時にページの名前を知らなくても、Wiki スペースのページから別のスペースの同じ名前のページにリンクできます。読者がページを閲覧し、マクロによって提供されたリンクを選択した場合、それらは同じ名前のページに移動しますが、マクロで指定されたスペースになります。スペースジャンプマクロの詳細の参照はこちらです 。

左側パネルを完全に非表示にする

It's not possible to remove the left-hand panel entirely, using the user interface supplied by the theme. There is an improvement request here: CONF-25923 - Getting issue details... STATUS If you like, you can comment on and/or vote for that request. In the meantime, Atlassian Answers is a good place to ask the question and see if other people can help you with custom code to remove the panel.

注意

• The Confluence default theme supplies a sidebar, which is different to the left-hand panel in the Documentation theme. For information about the sidebar, see Finding Content and Configuring a Sidebar.
• ドキュメンテーションテーマでは、Confluence のヘッダーに閲覧のメニューが表示され、スペースの管理と高度なオプション機能にアクセスできます。