Benutzerdefinierte PDF-Vorlagen aus früheren BlueSpice-Versionen erfordern manuelle Updates auf die neue PDFCreator-Funktionalität. Je nach Anforderungen können neue Vorlagen im Wiki erstellt werden. Bei komplexen Anpassungen ist Technik-Unterstützung notwendig.
Für bestehende BlueSpice cloud-Vorlagen gibt es einige Anweisungen für die notwendigen Änderungen.
Seite oder Buch exportieren[Bearbeiten | Quelltext bearbeiten]
Um eine Seite als PDF zu drucken, klicken Sie in den Seitenwerkzeugen auf das Seitensymbol. Das Dialogfeld „Export“ wird geöffnet.
Wählen Sie die Exporteinstellungen.
- Modus:
- Seite: Druckt die Seite.
- Seite mit Unterseiten: Druckt die Seite und alle Unterseiten. Diese Option wird nur angezeigt, wenn die Seite Unterseiten enthält.
- Seite mit allen verlinkten Seiten: Druckt die Seite und die direkt von dieser Seite verlinkten Seiten.
- Vorlage:
- Standard-PDF: Druckt die Seite(n) ohne Deckblatt (sofern die Vorlage nicht bearbeitet wurde).
- StandardBuchPDF: Fügt dem PDF ein Deckblatt hinzu (sofern die Vorlage nicht bearbeitet wurde).
Ob verlinkte Seiten oder verlinkte Dateien im PDF Export berücksichtigt werden solten, ist in der jeweils ausgewählten Vorlage definiert.
Standardmäßig zeigt die Vorlage „StandardPDF“ das Wiki-Logo (aus der Skin-Einstellungsseite). Wenn keine benutzerdefinierten Einstellungen vorgenommen wurden, wird das Standard-BlueSpice-Logo verwendet.
Medien-Links exportieren[Bearbeiten | Quelltext bearbeiten]
Medienlinks (= Links, die direkt auf die Datei auf dem Server verweisen) fügen der exportierten PDF-Datei einen Anhang hinzu. Dies ist unabhängig vom gewählten Exportmodus (Seite, Seite mit verlinkten Seiten).
Dies gilt auch für PDF-Dateien, die über das Inhalts-Droplet PDF-Vorschau eingebettet werden.
Wenn keine Anhänge hinzugefügt werden sollen, muss dies in den Eigenschaften der PDF-Vorlage definiert werden.
Seiten mit verlinkten Seiten exportieren[Bearbeiten | Quelltext bearbeiten]
Beim Exportieren von Seiten mit ihren verlinkten Seiten werden die Linktypen wie folgt verarbeitet:
- Medienlinks fügen der exportierten PDF-Datei einen Anhang hinzu (z.B. [[Medium:mydocument.pdf]])
- Dateilinks sind anklickbar und verlinken zur entsprechenden Dateiseite im Wiki. (z.B. [[File:mydocument.pdf]])
- Erwähnungen sind anklickbar und leiten zur Benutzerseite weiter.
Wenn keine Anhänge hinzugefügt werden sollen, muss dies in den Eigenschaften der PDF-Vorlage definiert werden.
Wenn keine Links zu Seiten hinzugefügt werden, die nicht im PDF enthalten sind, muss dies in den Eigenschaften der PDF-Vorlage definiert werden.
Neue Vorlage hinzufügen[Bearbeiten | Quelltext bearbeiten]
Das Wiki bietet standardmäßig zwei PDF-Vorlagen:
- StandardPDF: Vorlage ohne Deckblatt für den Einzelseitenexport.
- StandardBookPDF: Vorlage mit Deckblatt für den Buchexport.
Ab BlueSpice 5.1 können PDF-Vorlagen über die Seite Spezial: PDF-Vorlagen erstellt werden.
Vorhandene Vorlage kopieren[Bearbeiten | Quelltext bearbeiten]
So erstellen Sie eine neue PDF-Vorlage:
- Gehen Sie zur Seite Spezial: PDF-Vorlagen.
- Kopieren Sie eine vorhandene Vorlage.
Schaltfläche zum Kopieren einer PDF Vorlage - Geben Sie einen Namen für die neue Vorlage an.
- Klicken Sie Kopieren.
Klicken Sie anschließend die Schaltfläche zum Bearbeiten (Stift-Symbol) der neuen Vorlage.
Allgemeine Eigenschaften auswählen[Bearbeiten | Quelltext bearbeiten]
- Wählen Sie die Seitenausrichtung und die allgemeinen Exporteigenschaften aus (z. B. ob das Inhaltsverzeichnis für jede Seite angezeigt werden soll oder ob Links zu Seiten eingefügt werden sollen, die nicht im PDF selbst exportiert werden).
- Klicken Sie auf Weiter.
Vorlagen-Elemente auswählen[Bearbeiten | Quelltext bearbeiten]
Aktivieren Sie die Kontrollkästchen für jedes Element, das Sie in Ihre Vorlage aufnehmen möchten:
- Kopfzeile
- Fußzeile
- Dokumentvorspann: Deckblatt
- Dokumentanhang: Zusätzliche Seite am Ende der PDF-Datei. Sie ist wie die Inhaltsseiten (mit Kopf- und Fußzeile) formatiert und erhöht die Seitenzahl der PDF-Datei.
Klicken Sie für jedes Vorlagenelement auf Konfigurieren, um das Layout zu gestalten.
Kopfzeile konfigurieren[Bearbeiten | Quelltext bearbeiten]
Die Kopfzeilenelemente können aus einem Bild (normalerweise Ihrem Logo) und Text (einer Kombination aus vordefinierten Parametern und Ihrem eigenen Text) bestehen.
Wenn Sie ein anderes Bild als Ihr Wiki-Logo verwenden möchten, wählen Sie Benutzerdefiniertes Logo verwenden und geben Sie einen vorhandenen Bildnamen ein oder laden Sie ein neues Bild hoch.
Fußzeile konfigurieren[Bearbeiten | Quelltext bearbeiten]
Standardmäßig bietet das Wiki für jeden Fußzeilenabschnitt lokalisierte Systemmeldungen an. Nutzen Sie Systemmeldungen, wenn Sie die Spracheinstellungen Ihrer Benutzer unterstützen möchten. Beispielsweise kann in einem deutschsprachigen Wiki die deutsche Systemmeldung für {{int:pdfcreator-pdf-disclaimer}} auf der Seite MediaWiki:pdfcreator-pdf-disclaimer geändert werden. Die englische Version finden Sie auf der Seite MediaWiki:pdfcreator-pdf-disclaimer/en.
Alternativ können Sie einfach Ihren eigenen Text eingeben, wenn der PDF-Export keine Benutzersprachen berücksichtigen muss. Oder lassen Sie den Abschnitt leer, wenn Sie keinen Text drucken möchten.
Konfigurieren des Dokumentvorspanns (Deckblatt)[Bearbeiten | Quelltext bearbeiten]
Sie können folgende Elemente für Ihr Deckblatt festlegen:
Hintergrundbild:
- Wenn ein Buchregalbild vorhanden ist, wird dieses als Coverbild für den PDF-Export des Buches verwendet.
- Wenn kein Buchregalbild vorhanden ist, wird das im Konfigurationsmanager definierte Standardbild als Coverbild für den PDF-Export des Buches verwendet.
- Wenn in der PDF-Vorlage ein benutzerdefiniertes Bild definiert ist, wird dieses für den PDF-Export des Buches verwendet.
Wenn Sie kein Hintergrundbild für Ihr PDF-Cover verwenden möchten, müssen alle drei Felder für die Definition eines Hintergrundbildes leer sein.
Eigenschaften[Bearbeiten | Quelltext bearbeiten]
Die folgenden Eigenschaften können konfiguriert werden:
{
"embed-page-toc": true,
"nsPrefix": true,
"attachments": true,
"suppress-links": false,
"no-redirect": true,
"coverBackground": ""
}
| Bezeichnung | Name | Standardwert | Beschreibung |
|---|---|---|---|
| Namensraumpräfix anzeigen | nsPrefix | true | Das Namensaumpräfix von Seiten wird nicht in den Seitentiteln abgedruckt. |
| Inhaltsverzeichnis anzeigen | embed-page-toc | true | Das Inhaltsverzeichnis jeder exportierten Seite wird ausgegeben. |
| Weiterleitung ignorieren | no-redirect | false | Wenn Links auf eine andere Seite weiterleiten, ist die Zielseite nicht im PDF enthalten. |
| Anhänge erlauben | attachments | true | Wenn Dateien direkt mit dem Präfix „Medium:“ verlinkt sind, werden die Dateien auch im PDF angehängt. |
| Links in PDF deaktivieren | suppress-links | false | Ersetzt alle Links im PDF durch ein span-Element, wenn sie nicht auf ein Ziel innerhalb des PDFs verweisen. |
| - | coverBackground | <File:filename.png> | Diese Eigenschaft wird programmgesteuert festgelegt, wenn ein benutzerdefiniertes Hintergrundbild für das Deckblatt angegeben ist. |
Bestehende PDF-Vorlagen bearbeiten[Bearbeiten | Quelltext bearbeiten]
Alle Vorlagen sind als Unterseiten der Seite MediaWiki:PDFCreator gespeichert.
Hier ist die Syntax für die Vorlagenelemente einsehbar und auch direkt bearbeitbar, falls komplexere Änderungen nötig sind.
Vorlagenelemente[Bearbeiten | Quelltext bearbeiten]
Jede Vorlage besteht aus denselben Elementen:
| Vorlagen-Slot | Beschreibung |
|---|---|
| Kopfzeile | Die Kopfzeile jeder PDF-Seite. Die Grundstruktur ist: <div class="pdfcreator-runningheaderfix">
<table>
<tr>
<td>
<div class="pdfcreator-runningheader-logo">
{{logo}}}
</div>
</td>
<td>
<h1 class="title">{{{title}}}</h1>
</td>
</tr>
</table>
</div>
Wichtig!
Die Klasse „.pdfcreator-runningheaderfix“ ist notwendig, um die Kopfzeile auf der Seite oben auszurichten. Sie arbeitet mit der Klassendeklaration im Reiter „Styles“ der Vorlage zusammen. Beide müssen gemeinsam angepasst werden. |
| Inhalt | Das Inhaltslayout. Die Grundstruktur lautet: {{{content}}}
|
| Fußzeile | Die Fußzeile jeder PDF-Seite. Die Grundstruktur lautet: <div class="pdfcreator-runningfooterfix">
<table>
<tr>
<td>
<span>{{int:pdfcreator-pdf-disclaimer}}</span>
</td>
<td>
<span>{{int:pdfcreator-pdf-export-time}}:{{#time:d.m.Y|now}}</span>
</td>
<td>
<span>{{int:pdfcreator-pdf-param-currentpagenumber-label}} </span>{{{currentpagenumber}}}
<span> {{int:pdfcreator-pdf-param-totalpagescount-label}} </span>{{{totalpagescount}}}
</td>
</tr>
</table>
</div>
Wichtig!
Die Die Klasse „.pdfcreator-runningfooterfix“ ist erforderlich, um die Kopfzeile oben auf der Seite auszurichten. Sie arbeitet mit der Klassendeklaration im Reiter „Stile“ der Vorlage zusammen. Beide müssen gemeinsam angepasst werden. |
| Dokumentenvorspann | Das Deckblatt. Es ist für den Buchexport vorgesehen, kann aber auch für den Seitenexport verwendet werden. Die Grundstruktur eines Buchcovers lautet: <div class="pdfcreator-intro">
<div class="pdfcreator-intro-title">
{{{title}}}
</div>
</div>
Wichtig!
Die Klasse „.pdfcreator-intro“ ist erforderlich, um das Bild für den {{{logo}}}-Parameter anzuzeigen. Ohne diese Klasse in der Vorlage hat der {{{logo}}}-Parameter keine Wirkung. |
| Dokumentenanhang | Die letzte Seite des PDF-Exports. Sie hat keine vordefinierte Grundstruktur. |
| Styles | Stildeklarationen für die CSS-Klassen, die in den Vorlagenelementen verwendet werden. Die Standard-Stile können Sie hier einsehen. |
| Eigenschaften | Ermöglicht die Steuerung einiger Aspekte der PDF-Ausgabe. Folgende Eigenschaften sind verfügbar (Standardeinstellungen): {
"embed-page-toc": true,
"no-redirect":false,
"attachments": true,
"suppress-links": false
}
|
| Beschreibung | Interne Hinweise zur Verwendung dieser Vorlage. Die Beschreibung hat keine Auswirkungen auf die Vorlage selbst. |
Konfiguration[Bearbeiten | Quelltext bearbeiten]
- Namensraum-Präfix im PDF ausblenden: Entfernt das Namensraum-Präfix aus Titeln.
- Standard Export-Vorlage für Seiten: Die Standardvorlage wird als erstes angezeigt, wenn Benutzer im Modus „Seite“ eine Exportvorlage auswählen. Sie wird auch für das Inhalts-Droplet "PDF-Link" verwendet.
- Cover-Hintergrundbild in PDF-Vorlagen: Standard-Hintergrundbild für PDF-Vorlagen. Eine PDF-Vorlage muss im Slot "Dokumentenvorspann" folgenden Standard-Wrapper nutzen, damit das hier angegebene Bild ausgegeben wird:
<div class="pdfcreator-intro"> ... </div>
Standard-Bild:
/app/bluespice/w/extensions/BlueSpiceBookshelf/data/common/images/bs-cover.png
Ausgabe:
Der Bild-Pfad kann gelöscht werden. Dann wird standardmäßig kein Bild ausgegeben.
Alternativ kann ein eine hochgeladene Bild-Datei angegeben werden (ohne Namensraum-Präfix), zum Beispiel: alpaka1.jpg
Wenn ein Buch ein eigenes Bücherregal-Bild besitzt, wird dieses beim direkten Export von der Spezialseite "Bücher" im PDF generiert.
Anpassungsbeispiele[Bearbeiten | Quelltext bearbeiten]
Semantische Eigenschaft anzeigen[Bearbeiten | Quelltext bearbeiten]
Es ist möglich, eine semantische Eigenschaft (Attribut) in die Fußzeile zu drucken. Das folgende Beispiel gibt den Wert der Eigenschaft „Revision_ID“ einer Seite in der PDF-Fußzeile aus.
<div class="pdfcreator-runningfooterfix">
{{#show:{{FULLPAGENAME}}|?Revision_ID}}
</div>
Hintergrundfarbe für Kopf- und Fußzeile hinzufügen[Bearbeiten | Quelltext bearbeiten]
Fügen Sie im Reiter „Styles“ hinzu:
/* Hintergrundfarbe für Kopf- und Fußzeile hinzufügen */
.pdfcreator-runningheaderfix,
.pdfcreator-runningfooterfix {
background-color: #eee;
}
Dadurch wird eine graue Hintergrundfarbe hinzugefügt.
Unterstreichung von Kopf- und Fußzeile entfernen[Bearbeiten | Quelltext bearbeiten]
Fügen Sie im Reiter „Styles“ hinzu:
/* Rahmen der Kopfzeile entfernen */
.pdfcreator-runningheaderfix > table {
border-bottom: none !important;
}
/* Rahmen der Kopfzeile entfernen */
.pdfcreator-runningfooterfix > table {
border-top: none !important;
}
Inhaltsverzeichnis von Einzelseiten eines Buches entfernen[Bearbeiten | Quelltext bearbeiten]
Das Inhaltsverzeichnis zu Beginn eines PDFs soll angezeigt werden, aber nicht das Inhaltsverzeichnis für die einzelnen Seiten im Buch.
Fügen Sie im Reiter „Styles“ hinzu:
/* TOC der einzelnen Seiten nicht ausgeben */
.pdfcreator-type-page .toc {
display:none;
}
Alle Inhaltsverzeichnisse ausblenden[Bearbeiten | Quelltext bearbeiten]
/* alle Inhaltsverzeichnisse im PDF ausblenden */
.toc {
display:none;
}
Inhaltsverzeichnis formatieren[Bearbeiten | Quelltext bearbeiten]
Hier sind einige praktische CSS-Klassen zur Anpassung der Inhaltsverzeichnisse
/*TOC*/
/*Umrandung entfernen */
.toc {
border:none
}
/*Schriftgröße und Textfarbe */
.toc span.tocnumber,
.toc span.toctext {
font-size: 9pt;
color: #000000;
}
#toc a:after,
.toc a:after {
color: #000000;
}
Seitentitel formatieren[Bearbeiten | Quelltext bearbeiten]
Der Seitentitel wird wie folgt formatiert:
/*Seitentitel */
.firstHeading {
font-size: 12pt;
line-height: 1.5em;
}
Schriftgröße anpassen[Bearbeiten | Quelltext bearbeiten]
Die wichtigsten Textelement können über das HTML-Element angepasst werden. Hier können bei Bedarf weitere CSS-Selektoren hinzugefügt werden:
/*Schriftgrößen im Seitenhinhalt*/
.pdfcreator-page-content th,
.pdfcreator-page-content td,
.pdfcreator-page-content div,
.pdfcreator-page-content li,
.pdfcreator-page-content pre,
.pdfcreator-page-content p {
font-size:9pt;
color:#000000;
}
Die Schriftgröße der Überschriften können über h2, h3, h4, usw. angepasst werden. Beispiel:
.pdfcreator-page-content h2 {
font-size:11pt
}
Schriftart anpassen[Bearbeiten | Quelltext bearbeiten]
Die verwendete Schriftart für den PDF-Export ist DejaVu Sans.
Es ist derzeit nicht möglich eine eigene Schriftart für den PDF-Ausdruck anzugeben (BlueSpice cloud). On-Premise Installationen können eventuell über eine Server-Konfiguration eine Kundenschrift hinterlegen.
Tipps zur Vorbereitung des Inhalts für den PDF-Export[Bearbeiten | Quelltext bearbeiten]
Damit die Inhalte Ihrer Wiki-Seiten auch im PDF-Format gut dargestellt werden, finden Sie hier einige Tipps.
Tabellen mit reinem Textinhalt[Bearbeiten | Quelltext bearbeiten]
Die folgenden Hinweise beziehen sich auf Tabellen mit reinem Textinhalt. Enthält eine Tabelle Bilder, gelten die folgenden Regeln nicht (siehe weiter unten zu Bildern in Tabellen).
Spaltenbreiten[Bearbeiten | Quelltext bearbeiten]
Wenn Sie Tabelleninhalte haben, drucken Sie ein Test-PDF, um zu sehen, wie die Tabelle aussieht. Sollten Ihre Spalten mehr Platz benötigen als verfügbar ist (definierte Seitenbreite abzüglich Abstand zum Seitenrand), werden sie beim PDF-Export so neu berechnet, dass sie der ursprünglichen Tabellenformatierung bestmöglich entsprechen. In der Regel verursacht reiner Textinhalt keine Probleme. Wenn Sie die Spaltenbreiten steuern möchten, beachten Sie die folgenden Optionen:
- Keine Spaltenbreiten und keine Tabellenbreite festgelegt: Die Spaltenbreiten werden basierend auf ihrem Inhalt festgelegt. Die Proportionen der Tabelle werden im PDF-Dokument unverändert angezeigt.
- Größenverhältnis der Spaltenbreiten: Wenn Sie die Verhältnisse Ihrer Spaltenbreiten beibehalten möchten, legen Sie für jede Spalte eine feste Pixelbreite fest. Die Spalten werden dann im PDF so weit wie möglich proportional angepasst.
- Spaltenbreiten der Spalten beibehalten: Wenn Sie möchten, dass einige Spalten ihre Breite beibehalten, benötigen Sie mindestens eine Spalte ohne vordefinierte Breite.
Prozentuale Breite: Sie können auch für einige oder alle Spalten Prozentbreiten festlegen, da diese ebenfalls im PDF berücksichtigt werden.
Lange Wörter[Bearbeiten | Quelltext bearbeiten]
Wenn lange Wörter die festgelegte Zellenbreite nicht erfüllen, können Sie einen bedingten Trennstrich einfügen. Der Trennstrich wird nur bei Bedarf eingefügt:
Bilder in Tabellenzellen[Bearbeiten | Quelltext bearbeiten]
Wenn Sie Bilder in Tabellenzellen einbetten, wird die Bildvorschau nur auf der Wiki-Seite und nicht im PDF auf die definierte Zellenbreite angepasst. Beispielsweise wird ein 400 Pixel breites Bild in einer 200 Pixel breiten Spalte als 200 Pixel angezeigt. Im PDF-Export wird die tatsächliche Bildgröße von 400 Pixel verwendet. Passen Sie die Bildgröße daher immer an Ihre Zellenbreite an. Drucken Sie regelmäßig Testseiten, wenn Sie Text und Bilder in Tabellenzellen kombinieren.
Wenn Sie Bilder in mehreren Spalten haben, sollte die Gesamtbreite der Bilder 600 Pixel nicht überschreiten. Das folgende Beispiel zeigt zwei Bilder mit jeweils 300 Pixel Breite. Im PDF nutzen sie den gesamten verfügbaren Platz.
Der Ausdruck sieht wie folgt aus:
Hinweis: Für diesen Ausdruck wurden die Stile der StandardPDF-Vorlage angepasst, um eine kleinere Schriftgröße und mehr Innenabstand in den Tabellenzellen zu verwenden:
/*Tabellenstil für Wikitable-Stil */
.wikitable th, .wikitable td {
font-size:9pt;
padding:10px
}
Drucken im Querformat[Bearbeiten | Quelltext bearbeiten]
Es ist nur möglich, die gesamte PDF-Datei im Querformat zu drucken. Dies ist in der PDF-Vorlage definiert. Sie können beispielsweise die Vorlage StandardPDF in StandardPDF Querformat kopieren und die Ausrichtung auf Querformat einstellen. Siehe Hinzufügen einer neuen Vorlage weiter oben.
PDF Inhalts-Droplets[Bearbeiten | Quelltext bearbeiten]
Folgende Inhalts-Droplets sind verfügbar:
| Droplet-Name | Beschreibung |
|---|---|
| Buch-PDF-Link | Fügt einen Link zu einem Buch auf der Seite ein. Ein Klick auf den Link lädt die PDF-Datei sofort herunter. |
| PDF-Link | Fügt einen Link zu derselben oder einer anderen Seite auf der Seite ein. Ein Klick auf den Link lädt die Seite sofort herunter. |
| PDF-Vorschau | Öffnet die PDF-Datei direkt auf einer Seite in einem PDF-Viewer. |
| Inhalte im PDF ausschließen | Umschließt Inhalte mit den Tags <pdfexcludestart />...<pdfexcludeend />. Sie können den ausgeschlossenen Inhalt erweitern, indem Sie die Tags im Quelltextbearbeitungsmodus an eine andere Stelle verschieben.
Hinweis: Das Tag <uenoexport /> ist veraltet, wird aber weiterhin unterstützt. Es sollte nicht mehr verwendet werden. Die eingefügten Ausschluss-Start- und -Endmarkierungen sind im Ansichtsmodus nicht sichtbar. v5.1.1+ |
| PDF-Seitenumbruch | Fügt einen manuellen Seitenumbruch ein.
Die eingefügte Seitenumbruchsmarkierung ist im Ansichtsmodus nicht sichtbar. v5.1.1+ |
Semantic MediaWiki[Bearbeiten | Quelltext bearbeiten]
Die Bücher, in denen eine Seite existiert, werden über das semantische Attribut Bücher (Property:Books) abfragbar.
