Customising Exports to PDF

PDF のレイアウトをカスタマイズする

独自の HTML を追加して、PDF 出力のタイトルページ、ページヘッダ、ページフッタをカスタマイズできます。

To customise the PDF Layout:

PDF スタイルシートをカスタマイズする

You can adjust the appearance of the PDF pages by making CSS customisations in the PDF Stylesheet screen as required.

• To get started, you can download the default CSS rules of the PDF stylesheet: confluencedefaultpdf.css. Any rule defined in this file can be customised and added to the 'PDF Export Stylesheet' section.
• Your customisations override any default CSS rule.
• If no PDF customisations are defined in the PDF Stylesheet screen, the default CSS rules will be applied to your PDF exports. By default, the export does not include a title page, headers or footers.

PDF スタイルシートをカスタマイズするには：

カスタマイズ例

このセクションでは、一般的なカスタマイズ追加例を示します。高度な PDF カスタマイズを参照してください。

ページサイズ

The default page size is based on the locale of your Confluence server. For example, if this server is located in the US then the default paper size of your PDF export will be US Letter (8.5 inches wide by 11 inches long). If the server is located in Australia, the default paper size will be A4 (210 mm wide by 297 mm long). More information about paper sizes can be found on Wikipedia.

ページ サイズを A4に変更するには、次のように PDF スタイルシートを編集して、CSS@page ルールに size プロパティを追加します。

@page
{
/*A4 用紙サイズは幅 210 mm、長さ 297 mm*/
size: 210mm 297mm;
}

ページの向き：縦または横

PDF 文書のページの向きを変更するには、@page ルールの size プロパティで定義された値の順序を入れ替えます。このプロパティの 1 番目と 2 番目の値はそれぞれ、ページの幅と高さを表しています。

たとえば、スペースの PDF エクスポートを A4 横向きで生成する場合、@page ルールは次のようになります。

@page
{
/*横向き A4-サイズのページは幅 297 mm、長さ 210 mm*/
size: 297mm 210mm;
}

ページ余白

A4 サイズの用紙ですべての余白を 15 ミリに設定するには、PDF ファイルのスタイルシートの CSS @page ルールを次のように編集します。

@page
{
size: 210mm 297mm;
margin: 15mm;
}

余白を個々に設定するには、@page ルールを次のように編集します。

@page
{
margin-top: 2.54cm;
margin-bottom: 2.54cm;
margin-left: 1.27cm;
margin-right: 1.27cm;
}

To set margins to provide a gutter for binding a printed document, use the :left and :right pseudo-classes, as follows:

@page :left 
{ 
margin-left: 4cm; 
margin-right: 3cm; 
} 
@page :right 
{ 
margin-left: 3cm; 
margin-right: 4cm; 
}
@page :first 
{ 
margin-top: 10cm /* Top margin on first page 10cm */ 
}

上の例では疑似クラス :first を使用して表紙やタイトル ページ用の余白を明確に定義している点にご注意ください。

改ページ

既定では、Confluence ページは改ページなしでエクスポートされるため、短いページは PDF の同じページに表示されます。

Confluence の各ページを PDF ファイルの各ページに分けて表示するには、PDF スタイルシートに次のルールを追加します。

.pagetitle
{
page-break-before: always;
}

タイトル ページ

PDF レイアウト画面のタイトル ページセクションに HT​​ML を追加して、PDF 文書にタイトル ページを追加できます。次の例ではタイトル ページを作成してタイトルを追加します。

<div class="fsTitlePage">
 <img src="/download/attachments/590719/titlepage.png"/>
<div class="fsTitle">Confluence 4.0 の計画</div>
</div>

PDF スタイルシートで CSS ルールを使用して、タイトル ページとタイトル テキストの体裁を整えます。

.fsTitlePage 
{
margin-left: auto;
margin-top: 50mm;
margin-right: auto;
page-break-after:always 
} 

.fsTitle
{
font-size: 42px;
font-weight: bold;
margin: 72px 0 4px 0;
text-align:center;
}  

タイトル ページに画像を追加する

上の例では、タイトル ページの中央に、センタリングされた " titlepage.png" という画像が含まれます。src 属性の "590719" は、画像が添付されているページの ID 番号です。

次の手順にしたがって、タイトル ページに画像を含めます。

1. 画像を Confluence ページに添付します。
2. そのページの添付ファイル一覧を表示し、画像を右クリックして、その場所をコピーします。
3. 上記のように、適切な src="" 属性へのリンクを PDF スタイルシートに貼り付けます。
4. 画像の URL の /download/... の前に来る最初の部分を除去し、相対 URL になるように編集します。

目次

By default, a table of contents will be generated after the title page, or at the beginning of the PDF document if no title page is defined in the PDF Layout. To see the default CSS rules applied to the table of contents, download the default CSS rules (confluencedefaultpdf.css) and examine the specific rules with toc in their name.

目次の体裁を変更するには、PDF スタイルシートで CSS ルールを定義します。

目次を無効にする

PDF 文書で目次が生成されないようにするには、PDF スタイルシートに div.toc ルールを追加し、その display プロパティを none に設定します。

div.toc
{
display: none;
}

目次のリーダー文字を変更する

リーダー文字は、目次の見出しをページ番号に関連付けるために使用されます。既定では、リーダー文字は "." (ドット) 文字です。リーダーの値としては、dotted、solid、space が許可されます。また、leader(". . . ") などの文字列を使用することもできます。

リーダー文字を実線に変更するには、CSS ルールの content プロパティにある leader() の値を、次のように変更します。

span.toclead:before
{
content: leader(solid);
}

ヘッダーとフッター

PDF レイアウト画面の「ヘッダー」と「フッター」セクションを使用して、PDF ページにヘッダーとフッターを追加できます。既定では、ヘッダーとフッターはスペースのエクスポートにのみ適用され、単一ページのエクスポートには適用されません（ただし、PDF エクスポートの高度なカスタマイズを参照してください）。次の例では、簡単な著作権表示を追加します。

Copyright © 2011, Atlassian Pty Ltd.

ページ番号

ページ番号を追加するには、 PDF レイアウトでカスタマイズされた HTML と PDF スタイルシートでカスタマイズされた CSS を組み合わせる必要があります。

1. PDF レイアウト HTML: フッター セクション (またはヘッダー セクション) で、ページ番号のプレースホルダーとして機能するための一意の ID、例えば pageNum, を空の span 要素で使用します。

   HTML － PDF レイアウト：フッターセクション

   <span id="pageNum"/>
   

2. PDF スタイルシート CSS：空の span に適用するために、以下の CSS セレクタ ルールを作成します。

   CSS - PDF スタイルシート

   #pageNum:before
   {
   content: counter(page);
   }
   

上記の CSS セレクタルールを詳細に分析します：

• #pageNum ルールは、指定した "pageNum" ID を値として持つ HTML 要素、つまりヘッダーやフッター用に作成した span 要素を選択します。
• セレクタの :before 部分は、span 要素が処理される前にコンテンツを挿入できるようにする疑似クラスです。
• counter(page) は、現在のページ番号をコンテンツとして返す関数です。
• content プロパティは CSS プロセッサに対し、動的コンテンツ (つまり、インクリメントされるページ番号) が span タグに挿入されることを示します。

ワードラップ

長い単語や空白で分割されない単語を改行するために、break-word 値を持つ word-wrap プロパティを含むセレクタを PDF スタイルシートに追加します。

div 
{  
word-wrap: break-word;  
}

一般的な形式設定

スタイルシートを使用すれば、最終文書のルックアンドフィールに影響を与える出力は何でもカスタマイズできます。これにはフォント、表、行間隔、マクロなどが含まれます。エクスポート エンジンは Confluence によって生成された HTML 出力から直接機能します。したがって、何かをカスタマイズする第一歩は、Confluence または Confluence マクロによって生成された HTML 要素のセレクタを見つけることです。次に、PDF スタイルシートに CSS ルールを追加します。こうして PDF エクスポートにカスタマイズが表示されます。

注意

• 見出し要素の変更: h1、h2 など。Confluence はエクスポートされたスペースの階層構造に応じて見出し要素を変更し、スペース エクスポート全体に統一された外観を適用します。つまり、見出しのレベルが下げられます。これはカスタム PDF スタイルシートの適用に影響を与えます。CSS スタイルを正しく適用するために、見出しの変更量を算出できます。見出しのレベルはエクスポート ツリーの深さの値に応じて下げられます。第 1 レベルのページは 1 つ下げられます (すべての <h1> 要素は <h2> 要素になる)。第 2 レベルのページは 2 つ下げられ、同様に続きます。

• PDF カスタマイズに対するアトラシアンのサポートは限定されています。 私たちは HTML と CSS を使用して PDF レイアウトをカスタマイズする機能をサポートし、機能が壊れているか、公開例に記載したように動作しない場合は支援を行います。しかし、カスタマイズした HTML と CSS が提供する可能性は潜在的に際限がない状態であるため、アトラシアンは PDF カスタマイズから生ずる問題やカスタマイズに関連する問題をサポートしません。

関連トピック

PDF エクスポートの高度なカスタマイズ