このページでは Confluence でカスタム CSS スタイルを使用する方法について説明します。

CSS 編集のクイックスタート

スペースのCSSスタイルシートを編集するには:
  1. Go to the space and choose Space tools > Look and Feel on the sidebar.
  2. スタイルシートを選択し、その後編集 を選択します。
  3. カスタムCSSを、テ​​キストフ​​ィールドに貼り付けます。
  4. 変更を保存します。新しいCSSは、スペース内のすべてのコンテンツページに表示されます。

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

  1. Choose Browse > Space Admin at the top of the screen.
    Note: The 'Space Admin' option appears only if you are a space administrator for the space or you are a super user (a member of the confluence-administrators group).
  2. 「ルックアンドフィール」という見出しの左パネルで、スタイルシートをクリックします。
  3. 編集 を選択します 。
  4. カスタムCSSを、テ​​キストフ​​ィールドに貼り付けます。
  5. 変更を保存します。新しいCSSは、スペース内のすべてのコンテンツページに表示されます。

(warning) The information on this page does not apply to Confluence OnDemand.

チュートリアル: ヘッダーの背景色の変更

ヘッダーとは、既定の Confluence ページの最上部にあるメニュー領域を指し、Breadcrumb リンク参照メニュー、ユーザーメニューおよびクイック検索ボックスがあります。次の例では、カスタムグラフィックを組み込むためにヘッダーの背景色を変更します。

  1. カスタムグラフィックを作成します。この例では、 1046 x 61 ピクセルのカスタムヘッダーグラフィックを作成しました。
  2. Upload the custom graphic to a page in the space that you are customising.
  3. 新しいグラフィックをアップロードしたページのページ ID をメモします。(この例では、ページ ID は '658833839' です。
  4. ヘッダー用のカスタム CSS を作成します。以下の例では、新しいグラフィック ('header.png') を同じスペースの特定のページ (ページ ID '658833839' で表示) からロードします。

     #header .aui-header  {
           background-image:url('../download/attachments/658833839/header.png');
           background-repeat: no-repeat;
        }
    
  5. スペース管理者としてログインします。
  6. スペース管理ページを開きます。
  7. スタイルシートをクリックします。
  8. 編集をクリックしてテキストフィールドのコードを変更します。
  9. カスタムCSSを、テ​​キストフ​​ィールドに貼り付けます。
  10. 保存をクリックしてからページを再読み込みします (Shift + 再読み込みキーを押す必要がある場合もあります)。ヘッダーの背景色が変更されます。
  11. カスタムヘッダーは、スペース内のすべてのコンテンツページで表示されます。変更を戻すには、単に 'Stylesheet' ページからカスタムコードを削除して、保存をクリックします。

CSS 編集のヒント

スペーススタイルシートから着手する

A space stylesheet is a good starting point for CSS customisation, as it already includes all of the elements that can be changed. When you work on the space stylesheet it styles all content pages in the space. Build and test it at space-level, before considering applying the new stylesheet to your entire site. Once you are satisfied with your space design, test it thoroughly until you are confident that it has no problems. Then, you can look into advanced customisation of the Confluence CSS such as adjusting the Search page, the Dashboard and other integral pages.

適切なツールを使用する

Confluence CSS はかなり洗練されているため、 Web 開発アプリケーションを通じて、ユーザーはページのスタイルがどのように作成されたかを理解することになります。特に、作業を開始するページの既存のソースを表示する必要があります。これを実行するためのツールをまだ持っていない場合、次のフリーアプリケーションなどのツールが役立ちます。

1. Firebug
Firebug, a plugin for the Firefox web browser, allows you to take a look at the style of each element on your page. This is very useful to see what styles are currently applied, for example styles applied to the header only.

2. Web Developer
The Web Developer plugin for Firefox allows you to edit CSS inline and create new page designs.

3. CSS Edit
CSS Edit is a stand-alone CSS editor for Macintosh that extracts all existing styles from a given page and allows you to overwrite these.

最初に単純な要素を編集する

Begin by editing simple elements and checking that they work. By making changes, then checking that each one worked, you can easily isolate any CSS code that is causing problems. Be aware that some page elements are more suited to customisation than others. For example, adding a gradient to the toolbar is less likely to 'break' the page than changing the page width. Editing reasonably static elements such as background graphics will render more predictably than designs which attempt to completely change the user interface or the Javascript-powered drop-down menus (which we don't recommend editing).

注意

メモ:
  • You need system administrator permissions to edit the CSS for a space or for the site.
  • This function is turned off by default. To turn it on, go to Confluence Admin > Security Configuration and choose Custom Stylesheets for Spaces.
  • ラベルなし