Confluence Cloud Dokumentation

Anpassen der Exporte in PDF



Confluence- und Bereichsadministratoren können die PDF-Exporte für einzelne Bereiche individuell anpassen.


Bitte beachte:

  • PDF-Anpassungen sind für jeden Bereich einzigartig.
  • Die PDF-Anpassung gilt nur für den Export von Bereichen (nicht für den Export einzelner Seiten über Weitere Aktionen > Exportieren > in PDF exportieren).
  • Die PDF-Anpassungen von Confluence verwenden eine Kombination aus HTML und CSS.
  • Um eine bestimmte Anforderung in der exportierten PDF-Datei zu erreichen, nimmst du Änderungen an den folgenden Punkten vor:
    • Das PDF-Layout, bei dem HTML verwendet wird, um die Struktur des exportierten Inhalts zu definieren, einschließlich Funktionen wie die Titelseite, Kopf- und Fußzeilen.
    • Das PDF-Stylesheet (Formatvorlage), in dem CSS verwendet wird, um den Stil der Elemente im exportierten Inhalt zu definieren, z. B. Seitengröße und Ränder, Schriftart, Farbe und Listennummerierung.


Weitere Anpassungen findest du auf der Seite Erweiterte PDF-Exportanpassungen.


Anpassen des PDF-Layouts

Du kannst deine eigene HTML-Datei hinzufügen, um die Titelseite, die Kopfzeilen und die Fußzeilen in der PDF-Ausgabe anzupassen.

Einstellung eines globalen PDF-Layouts:

  1. Klicke auf (Einstellungen) in der Confluence-Navigation.
  2. Wähle PDF-Export in der Seitenleiste aus. 
  3. Klicke auf Bearbeiten.
  4. Gib deine Anpassungen ein.
    1. Du kannst einen HTML und CSS Code eingeben, die auf der PDF-Titelseite sowie in den Kopf- und Fußzeilen der Seite angezeigt werden sollen.
  5. Klicke auf Speichern.




Einstellen des PDF-Layouts auf Bereichsebene:

  1. Gehe zu dem betreffenden Bereich in Confluence Cloud.
  2. Klicke in der Seitenleiste auf Bereichseinstellungen.
  3. Wähle PDF-Export aus dem Tab Design aus. 
    Du benötigst dazu die Berechtigung eines Bereichsadministrators. 
  4. Klicke auf Bearbeiten.
  5. Füge den HTML Code hinzu, um den Titel, die Kopfzeile und/oder die Fußzeile anzupassen.
    1. Du kannst Inline-CSS in den HTML-Code integrieren.
  6. Klicke auf Speichern.




Anpassen des PDF-Stylesheets

Du kannst das Aussehen der PDF Seiten anpassen, indem du das CSS im Feld PDF-Stylesheet (Formatvorlage) anpasst.

Für den Anfang kannst du die Standard-CSS-Regeln für das PDF-Stylesheet herunterladen: confluencedefaultpdf.css. Jede in dieser Datei definierte Regel kann angepasst und dem Feld PDF-Export-Stylesheet hinzugefügt werden. Deine Anpassungen setzen die Standard-CSS-Regeln außer Kraft. Wenn keine Anpassungen definiert sind, werden die Standard-CSS-Regeln angewendet. 

Standardmäßig enthält der Export keine Titelseite, Kopf- oder Fußzeilen. Diese kannst du im PDF-Layout festlegen. 

Ein globales PDF-Stylesheet festlegen

  1. Klicke auf (Einstellungen) in der Confluence-Navigation.
  2. Wähle PDF-Export in der Seitenleiste aus. 
  3. Klicke auf Bearbeiten.
  4. Füge CSS hinzu, um den gleichen Inhalt auf jeder Seite darzustellen.
  5. Klicke auf Speichern.




Einstellen eines Bereichs PDF-Stylesheet (Formatvorlage)

  1. Gehe zu dem betreffenden Bereich in Confluence Cloud.
  2. Klicke in der Seitenleiste auf Bereichseinstellungen.
  3. Wähle PDF-Export aus dem Tab Design aus. 
    Du benötigst dazu die Berechtigung eines Bereichsadministrators. 
  4. Klicke auf Bearbeiten.
  5. Gib deine Anpassungen ein.
    1. Das Feld PDF-Formatvorlage akzeptiert CSS-Regeln (Cascading Style Sheets).
  6. Klicke auf Speichern.


Beispielanpassungen

In diesem Abschnitt findest du Beispiele für typische Anpassungen, die du hinzufügen kannst. Schau dir außerdem den Abschnitt Erweiterte PDF-Anpassungen an.


Größe der Seite

Die Standardgröße der Seite richtet sich nach dem Standort deines Confluence Servers. Wenn sich dieser Server beispielsweise in den USA befindet, ist das Standardpapierformat für deinen PDF-Export US Letter (8,5 Zoll breit und 11 Zoll lang). Wenn sich der Server in Australien befindet, ist das Standardpapierformat A4 (210 mm breit und 297 mm lang). Weitere Informationen über Papierformate findest du auf Wikipedia.

Um die Größe der Seite auf A4 zu ändern, bearbeite das PDF-Stylesheet und füge der CSS@page-Regel eine Größeneigenschaft hinzu, etwa so:


        CSS - PDF Stylesheet
        
    
                    
        @page
{
/*Das Papierformat A4 ist 210 mm breit und 297 mm lang*/
size: 210mm 297mm;
}





Ausrichtung der Seite: Querformat oder Hochformat

Um die Ausrichtung der Seite deines PDF-Dokuments zu ändern, kehrst du einfach die Reihenfolge der Werte um, die in der Eigenschaft size der @page-Regel angegeben sind. Der erste und zweite Wert dieser Eigenschaft steht für die Breite bzw. Höhe der Seite.

Um zum Beispiel PDF-Bereichsexporte im A4-Querformat zu erzeugen, könnte deine @page-Regel so aussehen:


            


			CSS - PDF Stylesheet
        
    
            @page
{
/*A4-Seiten im Querformat sind 297 mm breit und 210 mm lang*/
size: 297mm 210mm;
}



Seitenränder

Um alle Ränder auf 15 mm einzustellen und ein Papierformat von A4 zu verwenden, bearbeite die CSS @page-Regel im PDF-Stylesheet wie folgt:



            CSS - PDF Stylesheet
        
    
            @page
{
size: 210mm 297mm;
margin: 15mm;
}



Um die Ränder unabhängig voneinander einzustellen, bearbeite die @page-Regel wie folgt:

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


Um die Ränder so einzustellen, dass ein Bund für die Bindung eines gedruckten Dokuments entsteht, verwendest du die Pseudoklassen :left und :right wie folgt:

            
            CSS - PDF Stylesheet
        
    
            @page :left 
{ 
margin-left: 4cm; 
margin-right: 3cm; 
} 
@page :right 
{ 
margin-left: 3cm; 
margin-right: 4cm; 
}
@page :first 
{ 
margin-top: 10cm /* Oberer Rand auf der ersten Seite 10 cm */ 
}

 

Beachte die Verwendung der Pseudoklasse :first im obigen Beispiel, um unterschiedliche Ränder für ein Deckblatt oder eine Titelseite zu definieren.

Seitenumbrüche

Standardmäßig werden Confluence Seiten ohne Seitenumbrüche exportiert, so dass kürzere Seiten auf der gleichen PDF Seite erscheinen.

Damit jede Confluence Seite auf einer eigenen Seite in der PDF-Datei erscheint, füge die folgende Regel in das PDF-Stylesheet ein:


            
            CSS - PDF Stylesheet
        
    
            .pagetitle
{
page-break-before: always;
}


Titelseite

Du kannst deinem PDF-Dokument eine Titelseite hinzufügen, indem du HTML Code in das Feld Überschrift des PDF-Layouts einfügst. Das folgende Beispiel erstellt die Titelseite und fügt eine Überschrift ein:


            
            HTML - PDF Layout: Sektion Titel Seite
        
    
            <div class="fsTitelSeite">
 <img src="/download/attachments/590719/titelseite.png" />
<div class="fsTitle">Geplant für Confluence 4.0</div>
</div>
 

Verwende CSS-Regeln im PDF-Stylesheet, um das Aussehen der Titelseite und des Titeltextes zu steuern:

            
            CSS - PDF Stylesheet Formatvorlage
        
    
            .fsTitelSeite 
{
margin-left: auto;
margin-top: 50mm;
margin-right: auto;
page-break-after:always 
} 

.fsTitel
{
font-size: 42px;
font-weight: bold;
margin: 72px 0 4px 0;
text-align:center;
}  
   
Hinzufügen eines Bildes zur Titelseite

Im obigen Beispiel enthält die Titelseite ein Bild namens titelseite.png, das in der Mitte der Seite zentriert ist. Die "590719" im src-Attribut ist die ID der Seite, an die das Bild angehängt ist.

Befolge diese Anweisungen, um ein Bild auf deiner Seite einzufügen:

  1. Hänge das Bild an eine Confluence Seite an.

  2. Sieh dir die Liste der Anhänge auf dieser Seite an, klicke dann mit der rechten Maustaste auf das Bild und kopiere seine Position.

  3. Füge den Link in das entsprechende Attribut src="" in deinem PDF-Stylesheet ein, wie oben gezeigt.

  4. Bearbeite die Bild-URL so, dass sie relativ ist, indem du den ersten Teil der URL vor /download/... entfernst.


Inhaltsverzeichnis

Standardmäßig wird ein Inhaltsverzeichnis nach der Titelseite bzw. am Anfang des PDF-Dokuments erstellt, wenn im PDF-Layout keine Titelseite definiert ist. Um die Standard-CSS-Regeln zu sehen, die auf das Inhaltsverzeichnis angewendet werden, lade die Standard-CSS-Regeln (confluencedefaultpdf.css) herunter und untersuche die spezifischen Regeln mit toc in ihrem Namen.

Um das Erscheinungsbild des Inhaltsverzeichnisses zu ändern, definierst du CSS-Regeln im PDF-Stylesheet.


Deaktivieren des Inhaltsverzeichnisses

Um zu verhindern, dass das Inhaltsverzeichnis in deinem PDF-Dokument erstellt wird, füge die Regel div.toc-macro zum PDF-Stylesheet hinzu und setze die Eigenschaft display auf none:


            
            CSS - PDF Stylesheet
        
    
            div.toc-macro
{
display: none;
}


Ändern des Leitzeichens im Inhaltsverzeichnis

Das Vorspannzeichen wird verwendet, um eine Überschrift im Inhaltsverzeichnis mit der zugehörigen Seitenzahl zu verbinden. Standardmäßig ist das führende Zeichen das Zeichen '.' (Punkt). Als Führungszeichen gelten gepunktet, durchgezogen und mit Leerzeichen zulässige Werte. Du kannst auch eine Zeichenkette verwenden, z. B. leader(". . . ").

Um das Führungszeichen in eine durchgezogene Linie zu ändern, änderst du den Wert von leader() in der Eigenschaft content der CSS-Regel wie folgt:


            
            CSS - PDF Stylesheet
        
    
            span.toclead:before
{
content: leader(solid);
}

Kopfzeilen und Fußzeilen

Du kannst deinen PDF-Seiten Kopf- und Fußzeilen hinzufügen, indem du die Kopf- und Fußzeilenfelder des PDF-Layouts verwendest. Standardmäßig gelten Kopf- und Fußzeilen nur für den Export eines Bereichs und nicht für den Export einzelner Seiten (siehe jedoch Erweiterte Anpassungen des PDF-Exports). Im folgenden Beispiel wird ein einfacher Copyright-Hinweis hinzugefügt.


            
            HTML - PDF Layout: Fußzeile
        
    
            Copyright © 2013, Atlassian Pty Ltd.

Seitennummerierung

Um eine Seitennummerierung hinzuzufügen, musst du angepassten HTML Code im PDF-Layout mit angepasstem CSS Code im PDF-Stylesheet kombinieren.


  1. PDF-Layout HTML: Verwende im Fußzeilenabschnitt (oder im Kopfzeilenabschnitt) ein leeres span-Element mit einer eindeutigen ID, zum Beispiel pageNum, als Platzhalter für die Seitenzahl.

                
                HTML - PDF Layout: Fußzeile
            
        
                <span id="pageNum"/>
    
     
  2. PDF Stylesheet CSS: Erstelle die folgende CSS-Selektorregel für den leeren Span: 

                
                CSS - PDF Stylesheet
            
        
                #pageNum:before
    {
    content: counter(page);
    }
    
       

Wir analysieren die oben genannte CSS-Selektor-Regel genauer:

  • Die Regel #pageNum wählt das HTML-Element mit der angegebenen ID "pageNum" aus, das das span Element ist, das wir für die Kopf- oder Fußzeile erstellt haben.
  • Der :before Teil des Selektors ist eine Pseudoklasse, die das Einfügen von Inhalten ermöglicht, bevor das span Element verarbeitet wird.
  • counter(page) ist eine Funktion, die die aktuelle Seitenzahl als Inhalt zurückgibt.
  • Die Eigenschaft content teilt dem CSS-Prozessor mit, dass ein dynamischer Inhalt (d. h. eine fortlaufende Seitenzahl) in das span Tag eingefügt werden soll.


Lange Wörter einwickeln

Um lange Wörter oder Wörter, die nicht durch Leerzeichen getrennt sind, umzubrechen, füge dem PDF-Stylesheet einen Selektor hinzu, der die Eigenschaft word-wrap mit dem Wert break-word enthält:


            
            CSS - PDF Stylesheet
        
    
            div 
{  
word-wrap: break-word;  
}
 

Allgemeine Formatierung

Du kannst das Stylesheet verwenden, um die Ausgabe von so ziemlich allem, was das Aussehen des endgültigen Dokuments beeinflusst, anzupassen. Dazu gehören Schriftarten, Tabellen, Zeilenabstände, Makros usw. Die Export-Engine arbeitet direkt mit der von Confluence erzeugten HTML-Ausgabe. Der erste Schritt bei der Anpassung besteht also darin, einen Selektor für das von Confluence erzeugte HTML-Element oder das Confluence-Makro zu finden. Dann fügst du eine CSS-Regel in das PDF-Stylesheet ein. Deine Anpassungen werden im PDF-Export angezeigt.


  • Herabstufung von Überschriftenelementen: h1, h2 und so weiter. Aufgrund der hierarchischen Art und Weise, in der ein Bereich exportiert wird, ändert Confluence die Überschriftenelemente, um ein einheitliches Erscheinungsbild für den gesamten Bereichsexport zu erzeugen. Das bedeutet, dass Überschriften degradiert werden. Dies hat Auswirkungen auf die Anwendung von benutzerdefinierten PDF-Stylesheets. Es ist möglich, den Betrag zu berechnen, um den eine Überschrift herabgestuft wird, damit das richtige CSS-Styling angewendet wird. Eine Überschrift wird um den Wert ihrer Tiefe im Exportbaum herabgestuft. Eine Seite auf der ersten Ebene wird um 1 herabgestuft (alle <h1> Elemente werden zu <h2> Elementen usw.). Eine Seite auf der zweiten Ebene wird um 2 herabgestuft, und so weiter.
  • Die Unterstützung von Atlassian für die Anpassung von PDFs ist begrenzt. Wir unterstützen den Vorgang zur Anpassung des PDF-Layouts mit HTML und CSS und helfen, wenn der Vorgang nicht funktioniert oder nicht so funktioniert, wie wir es in unseren veröffentlichten Beispielen beschreiben. Da benutzerdefiniertes HTML und CSS jedoch potenziell grenzenlose Möglichkeiten bieten, unterstützt Atlassian keine Probleme, die durch PDF-Anpassungen verursacht werden oder damit zusammenhängen.






Zurück zum Hauptmenü   Nächstes Thema  







Confluence

Diese Seite wurde zuletzt am 06.03.2023 geändert.