|
|
| Zeile 1: |
Zeile 1: |
| <bookshelf src="Buch:Benutzerhandbuch" />
| | {{BSExtensionInfobox |
| {{DISPLAYTITLE:Seiten exportieren}} | | |desc=Authentifizierung mit OpenID Connect über ''PluggableAuth'' |
| | | |status=stable |
| '''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. | | |developer=Cindy Cicalese |
| | | |type=MediaWiki |
| ==Das Export-Menü== | | |edition=BlueSpice pro, BlueSpice Cloud |
| Jede Inhaltsseite im Wiki kann exportiert werden. Exportfunktionen finden Sie in den [[Handbuch:Erweiterung/BlueSpiceDiscovery|allgemeinen Seitenwerkzeugen]] unter dem Menüpunkt ''Exportmöglichkeiten''.
| | |compatible=MediaWiki |
| [[Datei:Handbuch:export-icon.png|alternativtext=Export-Icon.|zentriert|mini|250x250px|Export-Icon]]
| | |category=Infrastruktur |
| | | |license=MIT |
| | | |docu=https://www.mediawiki.org/wiki/Extension:OpenID_Connect |
| 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.
| | |active=Ja |
| | | }} |
| <br />
| | Die Erweiterung '''OpenID Connect''' erweitert [https://www.mediawiki.org/wiki/Extension:PluggableAuth?action=view PluggableAuth], um Authentifizierung mit [http://openid.net/connect/ OpenID Connect] zu ermöglichen. |
| [[Datei:Handbuch:UniversalExport1.png|alternativtext=konfigurationseinstellungen|zentriert|mini|600x600px|Export-Optionen]]
| | ==Technische Information== |
| | | ===Anforderungen=== |
| | |
| ==Module==
| |
| 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== | |
| 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:
| |
|
| |
|
| *'''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).
| | OpenID Connect benötigt die Erweiterung [https://www.mediawiki.org/wiki/Extension:PluggableAuth?action=view PluggableAuth] vorinstalliert. |
| *'''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).<br />
| |
| [[Datei:Handbuch:UniversalExport2.png|alternativtext=|zentriert|mini|399x399px|Konfigurations-Optionen]]
| |
| <br />
| |
| | |
| ==Tags==
| |
| Die meisten Tags funktionieren sowohl im Buchexport als auch im Seitenexport (PDF). Es folgt ein Hinweis, wenn ein Tag eine Ausnahme bildet.
| |
| | |
| ===Manueller Seitenumbruch===
| |
| Über folgendes Tag an im PDF ein manueller Seitenumbruch erzwungen werden:<syntaxhighlight lang="text">
| |
| <bs:uepagebreak />
| |
| </syntaxhighlight>Im visuellen Bearbeitungsmodus wird an dieser Stelle eine Markierung angezeigt.
| |
| | |
| <br />
| |
| [[Datei:Handbuch: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:
| |
| | |
| *"bs-rotated" -> Querformat verwenden
| |
| *"bs-narrow" -> 0,33 x A4 hochkant
| |
| *"bs-ultrawide" -> 2 x A4 querformat
| |
| | |
| Diese Klassen können kombiniert werden. Beipiel:
| |
| <nowiki><div class="bs-rotated bs-ultrawide">...</div></nowiki>
| |
| 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.
| |
| {{Hinweisbox|boxtype=note|Note text=Darstellung von Kopf- und Fußzeilen können bei dieser Technik eventuell Darstellungsprobleme erzeugen.}}<br />
| |
| ===PDF-spezifisches Styling===
| |
| {{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 />
| |
| </syntaxhighlight>
| |
| | |
| | |
| '''Beispiel: Seitenhintergrund, Kopf- und Fußzeile anpassen'''
| |
| | |
| #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.
| |
| #Um den Seitenhintergrund zu definieren, geben Sie folgendes in <code>MediaWiki:Common.css</code> ein (Admin-Rechte erforderlich):<syntaxhighlight lang="css">
| |
| /*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*/
| |
| </syntaxhighlight>
| |
| | |
| 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>
| |
| ==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]]
| |
| [[Datei:pdf-email-output.png|zentriert|mini|750x750px|Email im PDF-Ausdruck]]
| |
| | |
| | |
| ==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.
| |
| | |
| {{Box Links
| |
| |Thema1=[[Referenz:BlueSpiceUniversalExport]]
| |
| |Thema2=[[Referenz:BlueSpiceUEModulePDF]]
| |
| |Thema3=[[Referenz:BlueSpiceUEModuleBookPDF]]
| |
| |Thema4=[[Referenz:BlueSpiceUEModuleHTML]]
| |
| |Thema5=[[Handbuch:Erweiterung/BlueSpiceBookshelf|Bücher erstellen]]
| |
| }}
| |
|
| |
|
| | <br />Mehr Informationen zu dieser Erweiterung finden Sie auf [https://www.mediawiki.org/wiki/Extension:PluggableAuth?action=view mediawiki.org]. |
|
| |
|
| {{Translation}} | | [[Kategorie:BlueSpice free]] |
| [[Category:Seitenwerkzeuge]] | | [[Kategorie:Extension]] |
| | [[de:Referenz:{{PAGENAME}}]] |
| | [[en:Reference:{{PAGENAME}}]] |
| | __KEIN_INHALTSVERZEICHNIS__ |
Diskussionen