Confluence 5.7 のサポートは終了しています。
ドキュメントの最新バージョンを確認してください。
This page is part of the guide on Developing Technical Documentation on Confluence Wiki.
Confluence is a platform for publishing online documentation. It also provides functionality for producing PDF versions of your documentation, allowing you to print the documentation, or to provide a copy to customers who are unable to access the online version. This guide describes how to export your technical documentation to PDF using Confluence's built-in PDF export. We also introduce a third-party add-on that provides additional PDF layout and style functionality.
Quick guide to PDF exports:
The rest of this page gives more details of the above procedures.
On this page:
If you plan to create PDF versions of your documentation, you may want to customise the PDF layout and styles for your space. These customisations will be applied every time you export documentation to PDF.
Under PDF layout you can add HTML to customise the PDF title page, and the page headers and footers. Under PDF stylesheet, you can adjust the appearance of the PDF pages.
スペースでドキュメント用テーマを使用している場合:
注意:スペース管理者オプションは、スペース管理者権限を持っているか、 「confluence-administrators」グループに属している場合にのみ表示されます。
スペースが PDF にエクスポートされるとき、次のエリア用に生成される HTML をカスタマイズできます。
必要に応じて、それぞれのテキストボックスにカスタマイズ内容を入力してください。PDF レイアウトセクションでは HTML コードが有効です。HTML にインライン CSS を含めることもできます。
スペースでドキュメント用テーマを使用している場合:
注意:スペース管理者オプションは、スペース管理者権限を持っているか、 「confluence-administrators」グループに属している場合にのみ表示されます。
この 「PDF エクスポート スタイルシート」ページには、PDF スタイルシートの現在の(例えば、カスタマイズされた)コンテンツが表示されます。
Below are typical customisations you may want to make for your technical documentation. For more examples, see Customising Exports to PDF.
以下の例は、インライン CSS ルールを含む HTML を使用してタイトル ページを生成する手順を示しています。
<div class="fsTitlePage" style="margin-left:auto;margin-top:75mm;margin-right:auto;page-break-after:always"> <img src="/download/attachments/12345/titlepage.png"/> </div>
以下の例は、タイトル ページに目次に加えて独自のコンテンツを含めるため、デフォルト タイトル ページに表示されるコンテンツの自動生成テーブルの上にコンテンツを追加する手順を示しています。
<div class="fsTitlePage" style="margin-left:auto;margin-top:75mm;margin-right:auto;"> <img src="/download/attachments/12345/titlepage.png"/> </div>
上記の例では、タイトル ページの中央に「titlepage.png」という画像を追加しています。この画像は Confluence ページに添付された、対応する URL (Confluence サイトのベース URL を除く URL の最後の部分のみ使用します) を介して参照されます。
次の手順にしたがって、タイトル ページに画像を含めます。
src="" 属性にリンクを貼り付けます。/download/... の前の、URL の最初の部分を削除します。You can add headers and footers to your PDF pages using HTML. Use the 'PDF Space Export Header' and 'PDF Space Export Footer' sections of the PDF layout to do this. For simple headers and footers, plain text is enough. The following example adds a simple copyright notice.
Copyright © 2010, Atlassian Pty Ltd.
PDF レイアウト HTML: フッター セクション (またはヘッダー セクション) で、ページ番号のプレースホルダーとして機能するための一意の ID、たとえば pageNum, を空の span 要素で使用します。
<span id="pageNum"/>
PDF スタイルシート CSS:空の span に適用するために、以下の CSS セレクタ ルールを作成します。
#pageNum:before
{
content: counter(page);
}
上記の CSS セレクタルールを詳細に分析します:
#pageNum ルールは、指定した「pageNum」ID を値として持つ HTML 要素、つまりヘッダーやフッター用に作成した span 要素を選択します。:before 部分は、span 要素が処理される前にコンテンツを挿入できるようにする疑似クラスです。counter(page) は、現在のページ番号をコンテンツとして返す関数です。content プロパティは CSS プロセッサに対し、動的コンテンツ (つまり、インクリメントされるページ番号) が span タグに挿入されることを示します。You can use the built-in Confluence PDF export to export a single page, a selection of pages or an entire space to a single PDF file.
Confluence ページを PDF にエクスポートすることができます。このオプションは 1 枚のページをエクスポートし、そのページを表示する権限を持つすべてのユーザーが使用できます。
スペースでドキュメント用テーマを使用している場合:
The Scroll PDF Exporter provides flexible themes for configuring PDF layout and styles. You can select one of Scroll PDF Exporter's built-in themes and configure your table of contents, header and title pages. For even more flexibility, see the section How Tos in the Scroll PDF Exporter documentation.
For this advanced PDF export functionality, you will need to install the Scroll PDF Exporter add-on into your Confluence site.
Now you know all about providing PDF versions of your documentation. What next? See other ways of Exporting and Printing Technical Documentation.