Seitengröße

Die Standard-Seitengröße richtet sich nach dem Standort Ihres Confluence-Servers. Ist Ihr Server z.B. in den USA, ist das Standard-Papierformat des PDF-Exports US-Letter (8.5" x 11"). Befindet sich Ihr Server in Australien, ist das Standard-Papierformat A4 (210 mm x 297 mm). Mehr Infos zu den Papierformaten in Wikipedia.

Um die Seitengröße in A4 zu ändern, ändert man die PDF-Seitenvorlage wie folgt, um das Größen Merkmal der CSS@page Regel hinzuzufügen:

CSS - PDF-Formatvorlage

1     @page
2    {
3    /*The A4 paper size is 210 mm wide by 297 mm long*/
4    size: 210mm 297mm;
5    }

 

Seitenausrichtung: Quer- oder Hochformat

Um die Seitenausrichtung des PDF-Dokuments zu ändern, werden einfach nur die Werte der Reihenfolge der @page Regel umgedreht. Der erste und zweite Wert dieser Eigenschaft zeigt die Breite und Höhe der Seite.

Soll beispielsweise ein Bereichs-Export in A4-Größe und im Querformat vorgenommen werden, sieht die @page Regel so aus:

 

 

Seitenränder

Um alle Seitenränder auf 15 mm festzusetzen, bei einer Seitengröße von A4, wird die @page Regel in der PDF-Formatvorlage so geändert:

Um die Ränder unabhängig voneinander zu ändern, sieht die Änderung so aus:

Um einen Spaltenzwischenraum zu lassen, damit ein gedrucktes Dokument z.B. gebunden werden kann, werden die :left und :left Pseudo-Klassen wie folgt eingesetzt:

Bitte beachten Sie, dass die Benutzung der :first Pseudo-Klasse im obigen Beispiel dazu dient, verschiedene Margen für eine Titelseite zu definieren.

 

Seitenumbrüche

Standardgemäß werden Confluence-Seiten ohne Seitenumbrüche exportiert. Kürzere Seiten erscheinen somit auf der gleichen PDF-Seite.

Damit jede Confluence-Seite auf einer separaten Seite des PDF-Dokuments erscheint, wird die folgende Regel in der PDF-Formatvorlage hinzugefügt:

 

 

Wortumbruch

Lange, untreenbare Wörter oder Zeichenketten (wie z.B. eine URL) werden automatisch so umgebrochen, dass sie der Seitenbreite oder der Zellenbreite, falls es sich um eine Tabelle handelt, entsprechen.

Wenn Sie nicht möchten, dass Wörter oder lange Zeichenfolgen umgebrochen werden, können Sie das folgende CSS verwenden:

div {
    word-wrap: normal !important;
}

Dies kann bedeuten, dass die Tabellenformatierung in Ihrer PDF-Datei problematisch ist und sehr lange Inhalte übergangen und von der Seite abgeschnitten werden können.

Titelseite

Es kann dem PDF-Dokument eine Titelseite hinzugefügt werden, indem dem PDF-Layout Screen HTML hinzugefügt wird. Das folgende Beispiel erstellt eine Titelseite und fügt einen Titel hinzu:

3    margin-left: auto;
4    margin-top: 50mm;
5    margin-right: auto;
6    page-break-after:always
7    }
8    
9    .fsTitle
10  {
11  font-size: 42px;
12  font-weight: bold;
13  margin: 72px 0 4px 0;
14  text-align:center;
15  }

Der Titelseite eine Abbildung hinzufügen

In dem obigen Beispiel beinhaltet die Titelseite eine Abbildung, die 'titlepage.png' heißt und in der Seite zentriert wird. Die Zahl "590719" in dem src Attribut ist die ID-Nummer der Seite, bei der diese Datei angehängt wurde.

Folgen Sie dieser Anleitung, um eine Abbildung auf der Titelseite einzufügen:

1. Hängen Sie die Abbildung an eine Confluence-Seite an.
2. Schauen Sie sich die Liste der Anhänge an und kopieren Sie per Rechtsklick die Position der Datei.
3. Fügen Sie diesen Link in dem entsprechenden src="" Attribut in der PDF-Formatvorlage, wie oben gezeigt, ein. 
4. Editieren Sie den URL der Datei so, dass er relativ ist. Dazu löschen Sie den ersten Teil des URL vor dem /download/...

 

Inhaltsverzeichnis

Standardgemäß wird nach der Titelseite oder am Anfang des PDF-Dokuments, wenn keine Titelseite definiert wurde, ein Inhaltsverzeichnis generiert. Um die Standard CSS-Regeln, die für das Inhaltsverzeichnis angewendet werden, zu sehen, klicken Sie bitte auf confluencedefaultpdf.css. Sehen Sie dort die spezifischen Regeln, die  toc in ihrem Namen enthalten.

Um das Aussehen des Inhaltsverzeichnisses zu ändern, können Die CSS-Regeln in der PDF-Formatvorlage definiert werden.

Das Inhaltsverzeichnis deaktivieren

Um zu verhindern, dass das Inhaltsverzeichnis in dem PDF-Dokument generiert wird, fügen Sie die  div.toc-macro Regel in der PDF-Formatvorlage ein und setzten seine display Eigenschaft auf "none".

Das Bezugszeichen im Inhaltsverzeichnis ändern

Das Bezugszeichen wird dazu genutzt, um eine Überschrift im Inhaltsverzeichnis mit der dazugehörigen Seitenzahl zu verknüpfen. Standardgemäß ist das Bezugszeichen hier der '.' (Punkt). Es sind aber die Bezugszeichen "dotted, solid" und "space" erlaubt. Es kann auch eine Reihe, wie z.B. leader(". . . ") benutzt werden.

Um das Bezugszeichen in eine durchgezogene Linie zu ändern, wird der leader() Wert in der content Eigenschaft der CSS-Regel wie folgt bearbeitet:

 

Kopfzeilen und Fußzeilen

Sie können diese zu Ihren PDF-Seiten im Kopfzeilen- und Fußzeilen-Abschnitt des PDF-Layouts hinzufügen. Standardgemäß erscheinen Kopf- und Fußzeilen nur bei Bereichsexporten und nicht bei Exporten von einzelnen Seiten (sehen Sie hierzu Weiterführende PDF-Export Individualisierung). Im folgenden Beispiel wird eine einfache Copyright Notiz hinzugefügt:

 

Seitennummerierung

Um eine Seitennummerierung hinzuzufügen, muss individualisiertes HTML in dem PDF-Layout mit individualisiertem CSS in der PDF-Formatvorlage kombiniert werden.

1. PDF-Layout HTML: Benutzen Sie in dem Bereich der Fußzeile (oder der Kopfzeile), ein leeres Spann-Element mit einem einzigartigem ID, wie z.B.  pageNum, um Platzhalter für die Seitennummer zu sein.
   
   

2. HTML - PDF-Layout: Fußzeile

   1 <span id="pageNum"/>
   
   

3. PDF-Formatvorlage CSS: Erstellen Sie die folgende CSS-Auswahl Regel für das leere Spann-Element:
   
   

   CSS -PDF-Formatvorlage
   
   1    #pageNum:before
   2    {
   3    content: counter(page);
   4    }

Detaillierte Analyse der oben genannten CSS-Auswahl Regel:

• Die #pageNum Regel wählt das HTML-Element mit dem spezifizierten ID von "pageNum", welches das Spann-Element ist, das wir vorher für die Kopf- oder Fußzeile erstellt haben.
• Das :before ist eine Pseudo-Klasse, die das Einfügen von Inhalt vor dem Spann-Element erlaubt.
• Das counter(page) ist eine Funktion, die die aktuelle Seitennummer als Inhalt zurückführt.

Das content sagt dem CSS-Prozessor, dass dynamischer Inhalt (in diesem Fall die Seitennummerierung) eingefügt werden soll.

 

Allgemeine Formatierung

Sie können die Formatvorlage dazu benutzen, die Gestaltung des Dokuments so zu gestalten, wie Sie möchten. Dazu gehören Schriftarten, Tabellen, Zeilenabstände, Makros, etc. Der Export passiert direkt vom HTML-Output, welches von Confluence erstellt wird. Deshalb ist der erste Schritt zur Individualisierung das Finden einer Auswahl für das HTML-Element, welches von Confluence oder einem Confluence-Makro hergestellt wurde. Dann wird die CSS-Regel in der PDF-Formatvorlage hinzugefügt. Und die Individualisierung erscheint im PDF-Export.