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

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

You need space administrator permissions to apply a theme to a space.

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

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

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.

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

The theme works well without any customisation. If necessary, you can restrict the search to just one space, change the content of the left-hand navigation panel and add your own header and footer.

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

1. 
2. 「ルックアンドフィール」という見出しの左パネルで、テーマをクリックします。
3. If the space is not yet using the Documentation theme, apply the theme as described above.
4. Choose Configure theme in the yellow area of the 'Current Theme' section at the top of the page. See screenshot below. The 'Documentation Theme Configuration' screen appears. See screenshot below.
5. ページ ツリーのチェックボックスを選択または選択解除します。これはスペースで、左側のパネル内のコンテンツのデフォルトの検索ボックスとテーブル（ページツリー）を表示するかどうかを決定します。
6. 現在のスペースに検索結果の表示件数を制限するのチェックボックスを選択または選択解除する。
   
   • チェックボックスを選択した場合：
     
     • 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 全体を検索します。 これは他のテーマでも既定の挙動です。
     • 左側のパネルの既定ページツリーに、検索検索を現在のスペースに制限した、検索ボックスが含まれます。
7. 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.
   
   • 「ナビゲーション」 - このテキストボックスには、左側のパネルのためのコンテンツが含まれています。
     
     • ページ ツリー チェックボックスが選択されている場合、ナビゲーションパネルには既定の検索ボックス、ページ ツリーが含まれます。「ナビゲーション」テキストボックスに入力した内容はすべて 上記の ページ ツリーと検索ボックスに表示されます。
     • You can include your own content underneath the page tree as well as above. See hint below. In summary: Deselect the Page Tree check box. Insert your own page tree using the Pagetree macro, then add your own content under the macro.
   • 'Header' – This text box contains content for a page header that will appear above the page title on all pages in the space. See example screenshot below.
   • 'Footer' – This text box contains content for a page footer that will appear after the comments and above the site footer, on all pages in the space. See example screenshot below.
8. [保存] を選択します。

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

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

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

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 をアップグレードするたびに、このパネルもアップグレードされます。左側のナビゲーションバーを独自に追加している場合に行うような、アップグレードごとにカスタマイズを削除してから再適用するといった作業の必要はありません。
• テーマはまた、すべてのページの上部と下部に表示されますカスタマイズヘッダーとフッターを提供します。
• テキストと見出しスタイルは、ドキュメントのスペースで典型的なコンテンツを強化するために設計されています。
• You can use the Space Jump macro to link from a page in one wiki space to a page with the same name in another space, without knowing the name of the page when you create the link.
• 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.

ヒントとコツ

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

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

Each space has a single page designated as the 'Home' page. You can specify the home page in the space administration section.

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

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

More detail: The theme uses the Pagetree macro to produce the table of contents. When entering the Pagetree macro, you can choose the top page in the page tree. The Documentation theme chooses the space home page as the top page.

Using reusable content in your header, footer or left-hand panel

You can use any text or wiki markup in your theme header, footer or left-hand panel. One useful hint is to use the Include or Excerpt Include to include re-usable content into your footer.

The screenshot above shows the theme customisation options, with examples of the macros used to include content from other pages. And the example screenshot also above shows the resulting header, footer and left-hand panel.

Adding content below the page tree in your left-hand panel

If you want to include your own content underneath the page tree, you can deselect the 'Page Tree' check box, add your own page tree using the Pagetree macro in the 'Navigation' text box, and then add your own content under the macro.

The screenshot above shows the theme customisation options, with the default page tree deselected and a custom page tree inserted, along with additional content in the left-hand panel. The example screenshot also above shows the resulting left-hand panel.

リンクに下線を追加する

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

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

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

The {spacejump} macro is provided along with the Documentation theme. You can use space jumping to link from a page in one wiki space to a page with the same name in another space, without knowing the name of the page when you create the link. When a reader is viewing a page and chooses the link provided by the macro, they will go to a page with the same name, but in the space specified in the macro. See more about the Space Jump macro.

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

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: 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.

注意