Die Standardvorlage für PDFs kann in BlueSpice Cloud direkt im Wiki angepasst werden.

Hinweis:In BlueSpice-Editionen außerhalb der Cloud muss die PDF-Vorlage auf dem Server angepasst werden.

Kopfzeile und Fußzeile[Bearbeiten | Quelltext bearbeiten]

Die PDF-Vorlage enthält jeweils 3 Spalten für die Kopf- und für die Fußzeile.


PDF Standardvorlage
PDF Standardvorlage


Sowohl der Inhalt als auch die Anzahl der Spalten kann auf folgenden Seiten angepasst werden:

  • MediaWiki:UniversalExport/PDF/Default/Header.html
  • MediaWiki:UniversalExport/PDF/Default/Footer.html
  • MediaWiki: UniversalExport/PDF/Default/Styles.less (optional external Stylesheet)

Gültige Parameter[Bearbeiten | Quelltext bearbeiten]

Folgende Standardinhalte können zu jeder Spalte in der Kopf-/Fußzeile und zum Buch-Deckblatt hinzugefügt werden:

Beschreibung
logo Wiki-Logo
title Seitentitel (in Büchern, der Buchtitel)
subtitle Untertitel (nur im Buch und wenn in den Buch-Metadaten ein Untertitel erstellt wurde)
currentpagenumber Seitenzahl
totalpagescount Anzahl der Seiten im PDF
url URL der Wikiseite
user Name des Benutzers, durch den das PDF gedruckt wurde
exportdate Erstellungsdatum des PDFs
exporttime Erstellungszeit des PDFs

Jeder Parameter wird von drei geschweiften Klammern umgeben. Beispiel: {{{logo}}}.

Zusätzlich ist es möglich, Freitext in den vorgegebenen Spalten anzugeben.

Kopfzeile[Bearbeiten | Quelltext bearbeiten]

Die Kopfzeile enthält eine Wiki-Tabelle mit drei Spalten. Der Standardinhalt für die erste Spalte ist das Logo des Wikis und die letzte Spalte zeigt den Seitentitel. Die mittlere Spalte ist leer.

Um die Kopfzeile anzupassen, öffnen Sie die SeiteMediaWiki:UniversalExport/PDF/Default/Header.html im Bearbeitungsmodus.

Header table
Header table

Freitext anzeigen[Bearbeiten | Quelltext bearbeiten]

Wenn Sie nicht das Logo sondern benutzerdefinierten Text anzeigen möchten, können Sie einfach den vorhandenen Platzhalter löschen und durch Ihren Text ersetzen. Beachten Sie, dass diese Kopfzeile für alle PDFs in Ihrem Wiki verwendet wird, einschließlich in Büchern.

Jede der Spalten kann leer sein.

{|
| Text in linker Spalte || Text in mittlerer Spalte || Text in rechter Spalte
|}

Entfernen der mittleren Spalte[Bearbeiten | Quelltext bearbeiten]

Die 3 Spalten beansrpruchen jeweils 1/3 der verfügbaren Seitenbreite. Wenn Sie mehr Platz für die linke oder rechte Spalte benötigen, können Sie die mittlere Spalte entfernen. Die so entstandenen 2 Spalten beansrpruchen dann jeweils die Hälfte der verfübaren Seitenbreite. Zusätzlich wurde über eine Style-Deklaration etwas Abstand zum Blattanfang und zur Sietenüberschrift hinzugefügt.

{|
|Die linke Spalte ist jetzt  ohne Mittelspalte 50% breit. || Text rechte Spalte
|}
2 columns in the PDF header
2 columns in the PDF header

Abstand vor und nach der Kopfzeile anpassen[Bearbeiten | Quelltext bearbeiten]

Der Abstand vor und nach der Kopfzeile kann am Anfang der Tabelle definiert werden. In der Anfangszeile, die mit {| beginnt, kann man eine "Style"-Deklaration hinzufügen:

{| style=”margin-top:20px; margin-bottom:20px;"

Fußzeile[Bearbeiten | Quelltext bearbeiten]

Die Fußzeile kann genauso wie die Kopfzeile angepasst werden.

Standardmäßig zeigt die Fußzeile das Erstellungsdatum des PDFs, einen BlueSpice-Hinweis und die Seitenzahl mit der Anzahl aller Seiten.

{|
| {{{exportdate}}} || {{int:universal-export-pdf-default-disclaimer}} || {{{currentpagenumber}}} / {{{totalpagescount}}}
|}

Um die Fußzeile anzupassen, öffnen Sie die Seite MediaWiki:UniversalExport/PDF/Default/Footer.html im Bearbeitungsmodus. Zum Beispiel können Sie den BlueSpice-Hinweis mit dem Namen des PDF-Erstellers auswechseln.

{|
| {{{exportdate}}} || {{{user}}} || {{{currentpagenumber}}} / {{{totalpagescount}}}
|}
PDF footer showing username
PDF footer showing username


Hintergrundfarbe der Kopf- und Fußzeile[Bearbeiten | Quelltext bearbeiten]

Wenn Sie Kopf- und Fußzeile farblich hinterlegen möchten, kopieren Sie folgende Stil-Deklarationen am Ende der Seite MediaWiki: UniversalExport/PDF/Default/Styles.less ein:

#runningheaderfix, #runningfooterfix {
background-color: #eee;
}
#runningheaderfix > table {
border-bottom: none !important;
}
#runningfooterfix > table {
border-top: none !important;
}

Titelseite von Büchern[Bearbeiten | Quelltext bearbeiten]

Die Titelseite von Büchern enthält standardmäßig das Wiki-Logo, den Buchtitel und einen Platzhalter für einen Untertitel. Wenn ein Buch keinen Untertitel enthält, wird dieser Platzhalter entsprechend ignoriert.

PDF book default cover
PDF book default cover


Titelblatt mit Hintergrundbild[Bearbeiten | Quelltext bearbeiten]

Um die Titelseite anzupassen, öffnen Sie die Seite MediaWiki:UniversalExport/PDF/Default/Cover page.html im Bearbeitungsmodus.

Die unten angezeigte Titelseite enthält folgende Elemente:

  • Logo
  • Hintergrundbild
  • Titel
  • Untertitel
Titelseite mit Hintergrundbild
Titelseite mit Hintergrundbild

Dieses Titelblatt wurde mit folgendem Quellcode erzeugt, der in die Titelseite eingefügt wurde:

{{{coverbackground}}}
{| style="width: 100%; text-align: right;"
|{{{logo}}}
|}
<div style="font-size: 18pt; font-weight:bold; margin-top:5cm; color:#333333">{{{title}}}</div>
<div style="font-size: 14pt; margin-top:11.5cm; color:#333333">{{{subtitle}}}</div>
  • Zeile 1: {{{coverbackground}}} fügt den Seitenhintergrund ein. Hier wird ein Bild in der Größe einer DIN A4-Seite erwartet. Wollen Sie zusätzlich das Wiki-Logo ersetzen, entfernen Sie die Zeilen 2-4 und fügen Sie das Logo direkt ihrem Hintergrundbild hinzu.
  • Zeile 2-4: Tabelle, die das Logo des Wikis anzeigt.
  • Zeile 5: Titel - hier können Sie z.B. die Schriftgröße, den Schriftschnitt, den Abstand zum Seitenanfang und die Schriftfarbe angeben.
  • Zeile 6: Untertitel - wie der Titel. Die Angabe margin-top legt den Abstand zum Titel fest.

Untertitel und Hintergrundbild festlegen[Bearbeiten | Quelltext bearbeiten]

Untertitel und Hintergrundbild werden in den Metadaten eines Buches festgelegt. Gehen Sie hierzu in die Bücherverwaltung.

  1. Klicken Sie auf das Buch, für das Sie Metadaten erstellen möchten.
  2. Klicken Sie auf der Buchbearbeitungsseite auf den Schraubenschlüssel. Dies öffnet den Metadatendialog.
    Metadaten
    Metadaten

  3. Wählen Sie Bookshelf Bild aus dem Auswahlmenü (1) und klicken Sie Hinzufügen (2). Geben Sie in der rechten Spalte den Namen des Bildes an, dass Sie für den Hintergrund verwenden möchten. Das Bild muss im Wiki hochgeladen sein. Sollte Ihr Bild einen Namensraumpräfix haben, muss dieser hier ebenfalls angegeben werden.
  4. Wählen Sie Untertitel aus dem Auswahlmenü (1) und klicken Sie Hinzufügen (2). Geben Sie entsprechend den gewünschten Untertitel in der rechten Spaltet ein.
  5. Klicken Sie Fertig.
  6. Klicken Sie abschließend Speichern am Ende der Buchbearbeitungsseite.

Testen Sie nun das Layout, indem Sie das Buch über die Bücherverwaltung als PDF drucken. Um nötige Änderungen vorzunehmen (z.B. Abstand zwischen Titel und Untertitel), ändern Sie die Einstellungen entspreched auf der Seite MediaWiki:UniversalExport/PDF/Default/Cover page.html oder in den Metadaten.Vorlage:Box Note

Titelblatt ohne Hintergrundbild[Bearbeiten | Quelltext bearbeiten]

Wenn Sie kein passendes Hintergrundbild haben oder möchten, können Sie eine Variation mit Farben erstellen. Hier sind einige Beispiele mit zugehörigem Quelltext für die Seite MediaWiki:UniversalExport/PDF/Default/Cover page.html.


Titelblatt 1

<!-- Logo -->
{| style="width: 100%; text-align: right;"
|{{{logo}}}
|}
<!-- Color block -->
<div style="position:absolute; height:2cm; width:1.8cm; background-color:#3a3b3c; 
margin:4cm 0 0 -2cm">
</div>
<div style="position:absolute; height:2cm; width:24cm; background-color:#3366cc; 
margin:4cm 0 0 0cm;">
</div>
<!-- Title -->
<div style="font-size:28pt;font-weight:bold;margin:8.5cm 0 1cm 0;color:#333333;">{{{title}}}
</div>
<!-- Subtitle -->
<div style="font-size:16pt; color:#555555">{{{subtitle}}}
</div>


Titelblatt 2

<div id="coverpage" style="height:29.7cm; width:21cm; margin:-1cm 0 0 -1.5cm;background: #cdcdcd; 
overflow:hidden;">
<div style="min-height:10cm; background:white; margin:2cm 0 0 0; padding:1cm">
<!-- Logo -->
{| style="width: 100%; text-align: right;"|
|{{{logo}}}
|}
<!-- Titelblock -->
<div style="font-size: 32pt; font-weight:bold; padding:0 1cm; margin:4.5cm 0 0.5cm 0;
color:#333333; background:white">{{{title}}}</div>
<div style="font-size: 24pt; margin-top:0; padding:0 1cm; color:#555555;">{{{subtitle}}}
</div>
</div>


Titelblatt 3

<!-- Logo -->
{| style="width: 100%; text-align: right;"
|{{{logo}}}
|}
<!-- Titelblock mit Hintergrundfarbe -->
<div style="background-color:#c6752d; margin:4.5cm -2cm 0 -2cm; padding:2cm 2cm 3cm 2cm;">
<div style="font-size: 24pt; font-weight:bold;  margin-bottom:0.5cm; color:#ffffff;">{{{title}}}
</div>
<!-- Titelblock -->
<div style="font-size: 18pt; margin-top:0.5cm; color:#efefef">{{{subtitle}}}
</div>
</div>

Tags[Bearbeiten | Quelltext bearbeiten]

Querformat[Bearbeiten | Quelltext bearbeiten]

Um eine Einzelseite im Querformat auszudrucken, kann folgendes Tag in beliebiger Position in den Quelltext der Seite eingefügt werden.

<bs:ueparams template="BlueSpiceCloudLandscape" />

Um dem Benutzer das Einfügen über den visuellen Editor zu erleichtern kann dies auch in ein Wikitext-Template verpackt werden. Z.B. {{Querformatexport}}. Wo das Element in der Wikiseite eingefügt wird, ist dabei irrelevant.

Hinweis:Das Tag funktioniert nur für den "Einzelseitenexport".


Titelblatt für den Einzelseiten-Export[Bearbeiten | Quelltext bearbeiten]

Um ein Deckblatt auch beim Einzelseiten-Export zu generieren, geben Sie im Quelltext folgendes Tag an:

<bs:ueparams template=BlueSpiceCloudBook />




Feedback zur Dokumentation ist im Community-Forum möglich.