Zuletzt bearbeitet vor 8 Monaten
von Margit Link-Rodrigue

2.5 Handbuch:Erweiterung/DynamicPageList3 und Handbuch:Erweiterung/BlueSpiceUniversalExport: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
VisuellWikitext
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Keine Bearbeitungszusammenfassung
 
Zeile 1: Zeile 1:
{{DISPLAYTITLE:DPL3: Seitenlisten und Transklusionen}}
<bookshelf src="Buch:Benutzerhandbuch" />
{{DISPLAYTITLE:Seiten exportieren}}


Mit '''DynamicPageList3''' können Sie unter anderem Seitenlisten generieren, die auf jeder Wikiseite angezeigt werden können.Zusätzlich können Sie auch einzelne Seitenabschnitte auf einer Wikiseite transkludieren.
'''BlueSpiceUniversalExport''' ermöglicht den Export von Wiki-Seiteninhalten in verschiedene Formate. Es enthält verschiedene Module, die jeweils als Exporteur für ein bestimmtes Format oder eine bestimmte Art des Exports dienen.


==Anwendungsbeispiele==
==Das Export-Menü==
Eine Dokumentation aller Auswahlkriterien und Formatierungsbeispiele sind auf [https://help.gamepedia.com/Extension:DPL3/Manual Gamepedia] (englisch) erhältlich.
Jede Inhaltsseite im Wiki kann exportiert werden. Exportfunktionen finden Sie in den [[Aufbau von BlueSpice#Seitenwerkzeuge|allgemeinen Seitenwerkzeugen]] unter dem Menüpunkt ''Export''. Welche Formate verfügbar sind, hängt von der Wiki-Konfiguration ab. Durch Klicken auf eine der bereitgestellten Optionen wird der Seiteninhalt im ausgewählten Format heruntergeladen.
Im folgenden sehen Sie einige typische Anwendungsbeispiele. Zusätzlich können Sie eine Tabelle mit einer [[Handbuch:Erweiterung/DynamicPageList3#Liste typischer Parameter|Liste möglicher Parameter und deren Werte]] konsultieren.
 
==Seitenabschnitte transkludieren==
<br />
Um einen Abschnitt einer Seite auf einer anderen Seite anzuzeigen (=transkludieren), geben Sie den Seitennamen (title)  und den Abschnittsnamen (include) als Parameter an:
[[Datei:Handbuch:UniversalExport1.png|verweis=link=https://de.wiki.bluespice.com/wiki/Datei:UniversalExport1a.png|alternativtext=|zentriert|mini|805x805px|Export-Optionen]]
<syntaxhighlight lang="text">
{{#dpl:|title=Handbuch:Semantic_MediaWiki|include=#Attribute definieren}}
</syntaxhighlight>


===Unterseiten auflisten===
Folgender Code zeigt die Unterseiten der aktuellen Seite in einem 3-spaltigen Layout an:<syntaxhighlight lang="text">
{{#dpl:
|titlematch={{PAGENAME}}/%
|shownamespace=false
|replaceintitle=/{{PAGENAME}}\//,
|columns=3
|mode=none
|rowcolformat=width=100%
}}
</syntaxhighlight>


Beispiel: Darstellen der Unterseiten der Seite  ''VisualEditor'' im  im Hauptnamensraum.  Es soll eine 1-spaltige Aufzählungsliste erzeugt werden:<syntaxhighlight lang="text">
==Module==
{{#dpl:
Die Erweiterung ''BlueSpiceUniversalExport'' enthält mehrere Module:
|titlematch=VisualEditor/% 
|shownamespace=false
|namespace=
|replaceintitle=/VisualEditor\//,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}
</syntaxhighlight>


*'''BlueSpiceUEModulePDF''': Modul zum Exportieren von Seiten im PDF-Format (.pdf). Es ermöglicht das Herunterladen der angezeigten Wikiseite (PDF Einzelseite), oder der aktuellen Seite mit allen Unterseiten (PDF Seite mit Unterseiten), oder mit allen Seiten, die auf der Wikiseite verlinkt sind (PDF Seite mit Verlinkungen).
*'''BlueSpiceUEModuleHTML''': Modul zum Exportieren von Seiten als html Zip-Archiv (HTML Einzelseite archiviert).
*'''BlueSpiceUEModuleBookPDF''': Modul zum Exportieren von Büchern. Es ermöglicht den Export ganzer Bücher im PDF-Format.


'''Output:'''
==Einstellungen==
Die Konfiguration von BlueSpiceUniversalExport und den entsprechenden Modulen erfolgt über [[Handbuch:Erweiterung/BlueSpiceConfigManager|die Konfigurationsverwaltung]]. BlueSpiceUniversalExport und jedes der Module enthalten separate Einträge in der Liste der Erweiterungen.
Zu den verfügbaren Einstellungen gehören:


{{#dpl:
*'''Inhaltsverzeichnis:''' Wird beim Export von ''BlueSpiceUEModuleBookPDF''  bereitgestellt und gilt daher nur für den Export von Büchern. Hier wählen Sie aus, wie das Inhaltverzeichnis in Büchern erstellt werden soll (als Inhaltverzeichnis für das gesamte Buch oder für jede Seite einzeln).
|titlematch=VisualEditor/%
*'''Namensraum im HTML ausblenden:''' Entfernt Namensraum-Präfixe, wenn Seitentitel in HTML-Exporten angezeigt werden.
|shownamespace=false
*'''Namensraum im PDF ausblenden:''' sollten Namespace-Präfixe angezeigt werden, wenn Seitentitel in PDF-Exporten angezeigt werden.
|namespace=
*'''Metadaten (Standard, JSON)''' : Zusätzliche Daten, die im JSON-Format an die Rendering-Vorlage übergeben werden sollen. Diese Daten stehen für die Verwendung in der Vorlage zur Verfügung (fortgeschrittene Benutzer).
|replaceintitle=/VisualEditor\//,
*'''Metadaten (Überschreiben, JSON)''': Bietet das Überschreiben von Standarddaten, die an die Rendering-Vorlage gesendet werden. Standardmäßig festgelegte Werte können mit dieser Option (JSON-Format) überschrieben werden (fortgeschrittene Benutzer).<br />
|columns=1
[[Datei:Handbuch:UniversalExport2.png|verweis=link=https://de.wiki.bluespice.com/wiki/Datei:UniversalExport2a.png|alternativtext=|zentriert|mini|399x399px|Konfigurations-Optionen]]
|mode=unordered
<br />
|rowcolformat=width=100%
}}


Alternativ-Beispiel:<syntaxhighlight lang="text">
==Tags==
{{#dpl:
Die meisten Tags funktionieren sowohl im Buchexport als auch im Seitenexport (PDF). Es folgt ein Hinweis, wenn ein Tag eine Ausnahme bildet.
|titlematch=%Performance-Optimierungen/%
|replaceintitle=@Installationsanleitung/Kompendium/Performance-Optimierungen/@,
|namespace=Setup
|shownamespace=false
|includesubpages=true
|mode=unordered
}}
</syntaxhighlight>


===Seiten in bestimmten Namensräumen auflisten===
===Manueller Seitenumbruch===
<syntaxhighlight lang="text">
Über folgendes Tag an im PDF ein manueller Seitenumbruch erzwungen werden:<syntaxhighlight lang="text">
{{#dpl:
<bs:uepagebreak />
  |namespace=Handbuch
</syntaxhighlight>Im visuellen Bearbeitungsmodus wird an dieser Stelle eine Markierung angezeigt.
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}
</syntaxhighlight>


<br />
[[Datei:Handbuch:bspagebreak-marker.png|verweis=link=Special:FilePath/bspagebreak-marker.png|alternativtext=|zentriert|mini|414x414px|Markierung des PDF-Seitenumbruchs]]
<br />
===Querformat===
Um eine Einzelseite im Querformat auszudrucken, kann folgendes Tag in beliebiger Position in den Quelltext der Seite eingefügt werden.
<nowiki><bs:ueparams template="BlueSpice_Landscape" /></nowiki>
Um dem Benutzer das Einfügen über den visuellen Editor zu erleichtern kann dies auch in ein Wikitext-Template verpackt werden. Z.B. <code><nowiki>{{Querformatexport}}</nowiki></code>. Wo das Element in der Wikiseite eingefügt wird, ist dabei irrelevant.
{{Hinweisbox|boxtype=note|Note text=Das Tag funktioniert nur für den "Einzelseitenexport".}}
Innerhalb einer Wikiseite können zudem Bereiche (z.B. breite Tabellen) gesondert ausgezeichnet werden, so dass sie im Export querformatig oder extra-breit ausgegeben werden. Dies geschieht über die Verwendung von CSS-Klassen. Es stehen zur Verfügung:


'''Output:'''
*"bs-rotated" -> Querformat verwenden
*"bs-narrow" -> 0,33 x A4 hochkant
*"bs-ultrawide" -> 2 x A4 querformat


{{#dpl:
Diese Klassen können kombiniert werden. Beipiel:
  |namespace=Handbuch
<nowiki><div class="bs-rotated bs-ultrawide">...</div></nowiki>
  |includesubpages=true
Auch dies kann über die Verwendung einer Wikitext-Vorlage (z.B. <code><nowiki>{{QuerformatStart}}</nowiki></code> und <code><nowiki>{{QuerformatEnde}}</nowiki></code>) benutzerfreundlicher gestaltet werden.
  |shownamespace=false
{{Hinweisbox|boxtype=note|Note text=Darstellung von Kopf- und Fußzeilen können bei dieser Technik eventuell Darstellungsprobleme erzeugen.}}<br />
  |count=5
===PDF-spezifisches Styling===
  |ordermethod=title
{{Hinweisbox|boxtype=important|Note text=Das Tag wird nur im Einzelseitenexport (auch mit verlinkten Seiten und mit Unterseiten) beachtet. Im Buchexport wird das Tag aus individuellen Seiten ignoriert. Das Tag kann aber auf der entsprechenden Buchseite im Namensraum Book: eingefügt werden und wird dann auf alle Seiten im Buch angewandt.}}Um CSS-Klassen oder IDs nur im PDF zu stylen, kann folgendes Tag am Anfang einer Seite eingebunden werden:<syntaxhighlight lang="text">
<bs:uemeta body-class=Klassenname-hier-einfügen />
}}
===Seiten in bestimmten Kategorien auflisten===
<syntaxhighlight lang="text">
{{#dpl:
  |category=Bearbeitung
  |addcategories  = true
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
  |mode=ordered 
}}
</syntaxhighlight>
</syntaxhighlight>




'''Output:'''
'''Beispiel: Seitenhintergrund, Kopf- und Fußzeile anpassen'''


{{#dpl:
#Fügen Sie das Tag <code><nowiki><bs:uemeta body-class=bg-grey bg-yellow no-header-image no-footer-text /></nowiki></code> auf der Seite ein.
|category=Bearbeitung
#Um den Seitenhintergrund zu definieren, geben Sie folgendes in <code>MediaWiki:Common.css</code> ein (Admin-Rechte erforderlich):<syntaxhighlight lang="css">
|addcategories  = true
/*PDF-Ausgabe*/
|includesubpages=true
.bg-grey { background-color:#EDEDED !important;} /*setzt den Seitenhintergrund*/
|shownamespace=false
.bg-yellow .bs-page-content { background-color:#F7F0C6; padding:10px;} /*setzt den Inhaltshintergrund und fügt Padding hinzu*/
|count=5
.no-header-image #bs-runningheaderfix { background:none;} /*entfernt den PDF-Header*/
|ordermethod=title
.no-footer-text #bs-runningfooterleft, .no-footer-text #bs-runningfootercenter, .no-footer-text #bs-runningfooterright { display:none;} /*entfernt den Text aus der PDF-Fußleister*/
|mode=ordered
</syntaxhighlight>
}}<br />
 
 
===Seiten mit bestimmten Namensmustern===
<syntaxhighlight lang="text">
{{#dpl:
  |namespace=Datei
|titlematch=A%
  |count=5
}}


Anzeige vor dem Einfügen des Tags und Anzeige nach dem Einfügen des Tags im Vergleich.<br /><gallery widths="250px" heights="400px">
Datei:pdf-class-output-vorher.png
Datei:pdf-class-output-nachher.png
</gallery>
===Inhalt vom PDF-Export ausschließen===
Um Inhalte einer Seite vom PDF-Export auszuschließen, kann dieser über den visuellen Editor unter ''Einfügen > Kein PDF'' eingefügt werden. Im Quelltext wird der Text dann entsprechend markiert:<syntaxhighlight lang="text">
<bs:uenoexport>Dieser Text wird nicht ins PDF exportiert.</bs:uenoexport>
</syntaxhighlight>
</syntaxhighlight>
==Inhalt nur im PDF anzeigen==
Soll Inhalt nur im PDF, aber nicht auf der Wikiseite angezeigt werden, so kann dieser Inhalt manuell über den Quelltext markiert werden. Zuerst muss ein Wiki-Administrator folgenden Code in die Seite MediaWiki:Common.css einfügen:<syntaxhighlight lang="css">
.bs-page-content .no-pdf {
    display: none;
}
.bs-page-content div.only-pdf {
    display:block;
}
.bs-page-content span.only-pdf {
    display:inline;
}
.only-pdf {
    display: none;
}
</syntaxhighlight>Nun kann ein Block-Absatz oder ein Inline-Element für den PDF-Export erstellt werden. Dieser Inhalt wird auf der Wikiseite im Anzeigemodus nicht angezeigt. Quellcode-Beispiele:<syntaxhighlight lang="html">
<div class="only-pdf">Dieser Block wird nur im PDF angezeigt.</div>
Das Adjektiv <span class="no-pdf">schön</span><span class="only-pdf">klein</span> wird je nach Medium geändert angezeigt.
</syntaxhighlight><br />
==Darstellung von Email-Adressen==
Wenn die Bezeichnung einer Email-Adresse nicht die Email-Adresse selbst ist, sondern im Wiki-Quelltext eine separate Beschreibung für den Email-Link eingegeben wurde, wird die Email-Adresse im PDF nach dem Link separat aufgeführt.
<br />
[[Datei:pdf-email-wikipage.png|zentriert|mini|750x750px|Email auf der Wikiseite|verweis=Special:FilePath/pdf-email-wikipage.png]]
[[Datei:pdf-email-output.png|zentriert|mini|750x750px|Email im PDF-Ausdruck|verweis=Special:FilePath/:pdf-email-output.png]]




'''Output:'''
==Drucken==
MediaWiki bietet standardmäßig eine Druckansicht für Wiki-Seiten. Die Druckfunktion ist über den Menüpunkt ''Export'' (Option "Drucken") in den Seitenwerkzeugen möglich.


{{#dpl:
{{Box Links
|namespace=Datei
|Thema1=[[Referenz:BlueSpiceUniversalExport]]
|titlematch=A%
|Thema2=[[Referenz:BlueSpiceUEModulePDF]]
|count=5
|Thema3=[[Referenz:BlueSpiceUEModuleBookPDF]]
}}
|Thema4=[[Referenz:BlueSpiceUEModuleHTML]]
 
|Thema5=[[Handbuch:Erweiterung/BlueSpiceBookshelf|Bücher erstellen]]
==Liste typischer Parameter==
}}
 
===Kriterien zur Seitenauswahl===
{| class="wikitable" style="width:100%;"
!Parameter
!Syntax
! style="width:380px;" |Beschreibung
|-
|category
|''<nowiki>|category=Bearbeitung|Setup...</nowiki>''
| style="width:380px;" |Seiten aus den Kategorien Bearbeitung ODER Setup
|-
|
|''<nowiki>|category=Bearbeitung&Setup&...</nowiki>''
| style="width:380px;" |Seiten aus den Kategorien Bearbeitung UND Setup
|-
|
|''<nowiki>|category=Bearbeitung|Setup...|category=Admin</nowiki>''
| style="width:380px;" |Seiten aus den Bearbeitung ODER Setup und Seiten aus der Kategorie Admin
|-
|notcategory
|''<nowiki>|notcategory=Bearbeitung</nowiki>''
| style="width:380px;" |Seiten, die nicht in der Kategorie Bearbeitung sind
|-
|categoriesminmax
|''<nowiki>|category=Bearbeitung|categoriesminmax=2</nowiki>''
| style="width:380px;" |Seiten, die in der Kategorie Bearbeitung und mindestens 2 weiteren Kategorien sind
|-
|
|''<nowiki>|category=Bearbeitung|categoriesminmax=,1</nowiki>''
| style="width:380px;" |Seiten, die nur in der Kategorie Bearbeitung und in keiner anderen Kategorie sind
|-
|namespace
|''<nowiki>|namespace=</nowiki>''
| style="width:380px;" |Seiten im Namensraum (Main)
|-
|
|''<nowiki>|namespace=Help|Handbuch</nowiki>''
| style="width:380px;" |Seiten im Namensraum Help ODER Handbuch
|-
|namespacenot
|''<nowiki>|namespacenot=Help</nowiki>''
| style="width:380px;" |Seiten, die nicht im Namensraum Help sind
|-
|
|''<nowiki>|namespacenot={{NAMESPACE}}</nowiki>''
| style="width:380px;" |Seiten, die nicht im Namenraum der aktuellen Wikiseite sind
|}
 
===Output-Format===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Beschreibung
|-
|mode
|''<nowiki>|mode=ordered</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Numerierte Liste
|-
|
|''<nowiki>|mode=unordered</nowiki>''
|Aufzählungsliste
|-
|
|<nowiki>|</nowiki>''mode=none''
|Zeilenumbrüche
|-
|
|<nowiki>|</nowiki>''mode=category''
|Seiten werden alphabetisch in A-Z Gruppen formatiert (ähnlicher einer Kategorienseite)
|-
|
|''<nowiki>|mode=inline|inlinetext=&amp;nbsp; &amp;bull; &amp;nbsp;</nowiki>''
|Seitennamen werden aneinandergereiht mit einem Aufzählungspunkt als Separator
|}
===Sortierung===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Beschreibung
|-
|ordermethod
|''<nowiki>|ordermethod=title</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Sortiert nach Seiten(-Präfix+)Titel
|-
|
|''<nowiki>|ordermethod=titlewithoutnamespace</nowiki>''
|Sortiert nach Seitenname unabhängig vom Namensraum
|-
|
|''<nowiki>|ordermethod=counter</nowiki>''
|Sortiert nach Anzahl der Seitenansichten (Popularität)
|-
|
|''<nowiki>|ordermethod=size</nowiki>''
|Sortiert nach Seitengröße
|-
|
|''<nowiki>|ordermethod=firstedit</nowiki>''
|Sortiert nach Erstellungsdatum
|-
|
|''<nowiki>|ordermethod=lastedit</nowiki>''
|Sortiert nach letztem Bearbeitungdatum
|-
|
|''<nowiki>|ordermethod=user,firstedit</nowiki>''
|Sortiert nach Bearbeiter, dann nach Erstellungsdatum durch den Bearbeiter
|-
|
|''<nowiki>|ordermethod=user,lastedit</nowiki>''
|Sortiert nach Bearbeiter, dann nach letztem Bearbeitungsdatum durch den Bearbeiter
|-
|order
|''<nowiki>|order=ascending</nowiki>''
|Aufsteigend sortiert
|-
|
|''<nowiki>|order=descending</nowiki>''
|Absteigend sortiert
|}
 
===Anzeige von Metadaten===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Beschreibung
|-
|addcategories
|''<nowiki>|addcategories=true</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Zeigt alle Kategorien der Seite nach dem Seitennamen an
|-
|addpagecounter
|''<nowiki>|category:Bearbeitung|ordermethod=counter|order=descending</nowiki>''
''|addpagecounter=true|count=5''
|Zeigt die 5 populärsten Seiten aus der Kategorie Bearbeitung
|-
|adduser
|''<nowiki>|category=Bearbeitung|ordermethod=lastedit|adduser=true</nowiki>''
|Stellt den Seiten den Namen des letzten Bearbeiters voran.
|-
|addauthor
|''<nowiki>|category=Bearbeitung|addauthor=true</nowiki>''
|Stellt den Seiten den Namen des Seitenerstellers voran.
|}<br />


{{Box Links|Thema1=[[Referenz:DynamicPageList3]]}}<br />
[[en:Manual:Extension/DynamicPageList3]]
[[de:{{FULLPAGENAME}}]]


[[Category:Organisation]]
{{Translation}}
[[Category:Seitenwerkzeuge]]

Version vom 3. März 2022, 16:43 Uhr


BlueSpiceUniversalExport ermöglicht den Export von Wiki-Seiteninhalten in verschiedene Formate. Es enthält verschiedene Module, die jeweils als Exporteur für ein bestimmtes Format oder eine bestimmte Art des Exports dienen.

Das Export-Menü[Bearbeiten | Quelltext bearbeiten]

Jede Inhaltsseite im Wiki kann exportiert werden. Exportfunktionen finden Sie in den allgemeinen Seitenwerkzeugen unter dem Menüpunkt Export. Welche Formate verfügbar sind, hängt von der Wiki-Konfiguration ab. Durch Klicken auf eine der bereitgestellten Optionen wird der Seiteninhalt im ausgewählten Format heruntergeladen.


Export-Optionen


Module[Bearbeiten | Quelltext bearbeiten]

Die Erweiterung BlueSpiceUniversalExport enthält mehrere Module:

  • BlueSpiceUEModulePDF: Modul zum Exportieren von Seiten im PDF-Format (.pdf). Es ermöglicht das Herunterladen der angezeigten Wikiseite (PDF Einzelseite), oder der aktuellen Seite mit allen Unterseiten (PDF Seite mit Unterseiten), oder mit allen Seiten, die auf der Wikiseite verlinkt sind (PDF Seite mit Verlinkungen).
  • BlueSpiceUEModuleHTML: Modul zum Exportieren von Seiten als html Zip-Archiv (HTML Einzelseite archiviert).
  • BlueSpiceUEModuleBookPDF: Modul zum Exportieren von Büchern. Es ermöglicht den Export ganzer Bücher im PDF-Format.

Einstellungen[Bearbeiten | Quelltext bearbeiten]

Die Konfiguration von BlueSpiceUniversalExport und den entsprechenden Modulen erfolgt über die Konfigurationsverwaltung. BlueSpiceUniversalExport und jedes der Module enthalten separate Einträge in der Liste der Erweiterungen. Zu den verfügbaren Einstellungen gehören:

  • Inhaltsverzeichnis: Wird beim Export von BlueSpiceUEModuleBookPDF bereitgestellt und gilt daher nur für den Export von Büchern. Hier wählen Sie aus, wie das Inhaltverzeichnis in Büchern erstellt werden soll (als Inhaltverzeichnis für das gesamte Buch oder für jede Seite einzeln).
  • Namensraum im HTML ausblenden: Entfernt Namensraum-Präfixe, wenn Seitentitel in HTML-Exporten angezeigt werden.
  • Namensraum im PDF ausblenden: sollten Namespace-Präfixe angezeigt werden, wenn Seitentitel in PDF-Exporten angezeigt werden.
  • Metadaten (Standard, JSON) : Zusätzliche Daten, die im JSON-Format an die Rendering-Vorlage übergeben werden sollen. Diese Daten stehen für die Verwendung in der Vorlage zur Verfügung (fortgeschrittene Benutzer).
  • Metadaten (Überschreiben, JSON): Bietet das Überschreiben von Standarddaten, die an die Rendering-Vorlage gesendet werden. Standardmäßig festgelegte Werte können mit dieser Option (JSON-Format) überschrieben werden (fortgeschrittene Benutzer).
Konfigurations-Optionen


Tags[Bearbeiten | Quelltext bearbeiten]

Die meisten Tags funktionieren sowohl im Buchexport als auch im Seitenexport (PDF). Es folgt ein Hinweis, wenn ein Tag eine Ausnahme bildet.

Manueller Seitenumbruch[Bearbeiten | Quelltext bearbeiten]

Über folgendes Tag an im PDF ein manueller Seitenumbruch erzwungen werden:

<bs:uepagebreak />

Im visuellen Bearbeitungsmodus wird an dieser Stelle eine Markierung angezeigt.


Markierung des PDF-Seitenumbruchs


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="BlueSpice_Landscape" />

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".

Innerhalb einer Wikiseite können zudem Bereiche (z.B. breite Tabellen) gesondert ausgezeichnet werden, so dass sie im Export querformatig oder extra-breit ausgegeben werden. Dies geschieht über die Verwendung von CSS-Klassen. Es stehen zur Verfügung:

  • "bs-rotated" -> Querformat verwenden
  • "bs-narrow" -> 0,33 x A4 hochkant
  • "bs-ultrawide" -> 2 x A4 querformat

Diese Klassen können kombiniert werden. Beipiel: 

<div class="bs-rotated bs-ultrawide">...</div>

Auch dies kann über die Verwendung einer Wikitext-Vorlage (z.B. {{QuerformatStart}} und {{QuerformatEnde}}) benutzerfreundlicher gestaltet werden.

Hinweis:Darstellung von Kopf- und Fußzeilen können bei dieser Technik eventuell Darstellungsprobleme erzeugen.


PDF-spezifisches Styling[Bearbeiten | Quelltext bearbeiten]

Wichtig!Das Tag wird nur im Einzelseitenexport (auch mit verlinkten Seiten und mit Unterseiten) beachtet. Im Buchexport wird das Tag aus individuellen Seiten ignoriert. Das Tag kann aber auf der entsprechenden Buchseite im Namensraum Book: eingefügt werden und wird dann auf alle Seiten im Buch angewandt.

Um CSS-Klassen oder IDs nur im PDF zu stylen, kann folgendes Tag am Anfang einer Seite eingebunden werden:

<bs:uemeta body-class=Klassenname-hier-einfügen />


Beispiel: Seitenhintergrund, Kopf- und Fußzeile anpassen

  1. Fügen Sie das Tag <bs:uemeta body-class=bg-grey bg-yellow no-header-image no-footer-text /> auf der Seite ein.
  2. Um den Seitenhintergrund zu definieren, geben Sie folgendes in MediaWiki:Common.css ein (Admin-Rechte erforderlich):
    /*PDF-Ausgabe*/
.bg-grey { background-color:#EDEDED !important;} /*setzt den Seitenhintergrund*/
.bg-yellow .bs-page-content { background-color:#F7F0C6; padding:10px;}  /*setzt den Inhaltshintergrund und fügt Padding hinzu*/
.no-header-image #bs-runningheaderfix { background:none;} /*entfernt den PDF-Header*/
.no-footer-text #bs-runningfooterleft, .no-footer-text #bs-runningfootercenter, .no-footer-text #bs-runningfooterright  { display:none;} /*entfernt den Text aus der PDF-Fußleister*/

Anzeige vor dem Einfügen des Tags und Anzeige nach dem Einfügen des Tags im Vergleich.

  • pdf-class-output-vorher.png
  • pdf-class-output-nachher.png

Inhalt vom PDF-Export ausschließen[Bearbeiten | Quelltext bearbeiten]

Um Inhalte einer Seite vom PDF-Export auszuschließen, kann dieser über den visuellen Editor unter Einfügen > Kein PDF eingefügt werden. Im Quelltext wird der Text dann entsprechend markiert:

<bs:uenoexport>Dieser Text wird nicht ins PDF exportiert.</bs:uenoexport>

Inhalt nur im PDF anzeigen[Bearbeiten | Quelltext bearbeiten]

Soll Inhalt nur im PDF, aber nicht auf der Wikiseite angezeigt werden, so kann dieser Inhalt manuell über den Quelltext markiert werden. Zuerst muss ein Wiki-Administrator folgenden Code in die Seite MediaWiki:Common.css einfügen:

 .bs-page-content .no-pdf {
     display: none;
 }
 .bs-page-content div.only-pdf {
     display:block;
 }
 .bs-page-content span.only-pdf {
     display:inline;
 }
 .only-pdf {
     display: none;
 }

Nun kann ein Block-Absatz oder ein Inline-Element für den PDF-Export erstellt werden. Dieser Inhalt wird auf der Wikiseite im Anzeigemodus nicht angezeigt. Quellcode-Beispiele:

<div class="only-pdf">Dieser Block wird nur im PDF angezeigt.</div>
Das Adjektiv <span class="no-pdf">schön</span><span class="only-pdf">klein</span> wird je nach Medium geändert angezeigt.


Darstellung von Email-Adressen[Bearbeiten | Quelltext bearbeiten]

Wenn die Bezeichnung einer Email-Adresse nicht die Email-Adresse selbst ist, sondern im Wiki-Quelltext eine separate Beschreibung für den Email-Link eingegeben wurde, wird die Email-Adresse im PDF nach dem Link separat aufgeführt.

Email auf der Wikiseite
Email im PDF-Ausdruck


Drucken[Bearbeiten | Quelltext bearbeiten]

MediaWiki bietet standardmäßig eine Druckansicht für Wiki-Seiten. Die Druckfunktion ist über den Menüpunkt Export (Option "Drucken") in den Seitenwerkzeugen möglich.

Weiterführende Links


Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Cascading Style Sheets. Eine Computersprache für die Gestaltung digitaler, vorwiegend webbasierter Dokumente.

Technische Referenz: DynamicPageList3



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

Abgerufen von „https://de.wiki.bluespice.com/w/index.php?title=Handbuch:Erweiterung/DynamicPageList3&oldid=3954“

Diskussionen