ドキュメンテーションテーマの設定

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

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

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

スペースにテーマを適用する方法

1. Go to the space and choose Space tools > Look and Feel from the bottom of the sidebar
   You'll need Space Admin permissions to do this. 
2. テーマ を選択し、テーマオプションを選択します
3. Choose Confirm
   
   Screenshot: Applying a theme
   

スペースでドキュメンテーションテーマを使用している場合：

1. ヘッダーから 参照 > スペース管理者 を選択します。

   注意: スペース管理オプションは、スペース管理権限を持っているか、 "confluence-administrators" グループに属している場合にのみ表示されます。

2. スペース管理オプションから テーマ を選択します
3. テーマオプションを選択します
4. 確認 を選択します

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

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.

Customizing the Documentation theme

The theme works well without any customization. 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. The following instructions assume you have already applied the Documentation theme.

To customize the Documentation theme:

1. ヘッダーから 参照 > スペース管理者 を選択します。

   注意: スペース管理オプションは、スペース管理権限を持っているか、 "confluence-administrators" グループに属している場合にのみ表示されます。

2. 「ルックアンドフィール」という見出しの左パネルで、テーマをクリックします。
3. 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.
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 The Documentation Theme.
     • 左側のパネルの既定ページツリーには検索ボックスは含まれません。
   • チェックボックスを選択しない場合：
     
     • The Confluence search will look for matches in the entire Confluence site. This is the default behavior for other themes too.
     • 左側のパネルの既定ページツリーに、検索検索を現在のスペースに制限した、検索ボックスが含まれます。
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.
   
   • 「ナビゲーション」 - このテキストボックスには、左側のパネルのためのコンテンツが含まれています。
     
     • ページ ツリー チェックボックスが選択されている場合、ナビゲーションパネルには既定の検索ボックス、ページ ツリーが含まれます。「ナビゲーション」テキストボックスに入力した内容はすべて 上記の ページ ツリーと検索ボックスに表示されます。
     • 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.
7. [保存] を選択します。

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

Screenshot: Customizing the Documentation theme

Customizing the theme at site level

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

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

Here's a summary of the features that the Documentation theme provides:

• 既定では、左側のパネルには、スペース内のすべてのページを表示する、検索ボックスと目次（ページツリー）が含まれています。具体的には、スペースのホームの子ページのみを検索します。
• The left-hand panel is fully customizable. You can choose to include or exclude the search box and page tree. You can enter your own text, images and wiki markup.
• 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.
• 左側と右側のパネルは、互いに独立してスクロールします。
• ページタイトルはきちんとページコンテンツの上部にあり、ナビゲーションパネルを挿入することがあるとしても、ナビゲーションパネルの上部で不快ではありません。
• Because the left-hand panel is part of the theme, it will be upgraded whenever Confluence is upgraded. There is no need to remove and then re-apply your customizations on each upgrade, as you would do if you added your own left-hand navigation bar.
• The theme also provides a customizable header and footer, which will appear at the top and bottom of every page.
• テキストと見出しスタイルは、ドキュメントのスペースで典型的なコンテンツを強化するために設計されています。
• 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 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.

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

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

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

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

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

If you want to include a an expanding list of links to other spaces, as we have included in this space (see 'Docs for all Confluence releases' in the sidebar), you can use an Expand Macro and an Include Page Macro in the 'Navigation' text box.   For example:

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

If you would like this to display below the page tree, follow the steps above.

リンクに下線を追加する

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

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

Note: By default, only system administrators can edit the CSS for a space or for the site. To allow any user with Space Admin permissions to edit the CSS for a space, go to  > General Configuration > Security Configuration and select Custom Stylesheets for Spaces.

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

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: 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 Configure the Sidebar.
• ドキュメンテーションテーマでは、Confluence のヘッダーに閲覧のメニューが表示され、スペースの管理と高度なオプション機能にアクセスできます。