MP:Tutorial

Aus MontiWeb

Wechseln zu: Navigation, Suche

Dieses Kapitel stellt das Benutzerhandbuch für die Erzeugung eines PDF-Dokuments aus Wiki-Artikeln dar. Voraussetzung für Wiki2PDF ist eine MediaWiki ab Version 1.9[1]. Damit das PDF-Dokument richtig erstellt wird, müssen bestimmte Regeln beachtet werden. Alle Artikel, aus welchen ein PDF-Dokument generiert werden soll, müssen in einem speziellen Artikel (TOC-Page) deklariert werden. Dies wird durch die Auflistung der Verweise auf die entsprechenden Artikel realisiert. Aus einer TOC-Page wird anschließend das PDF-Dokument erzeugt. Für die Verfassung der Wiki-Artikeln kann die übliche Wiki-Syntax verwendet werden. Das einzige Element "Listing" mit der Wiki-Syntax <source> wird von Wiki2PDF um ein zusätzliches Attribut caption erweitert.

Inhaltsverzeichnis

Aufbau von TOC-Page

Eine TOC-Page ist ein normaler Artikel mit der üblichen Wiki-Syntax. Mit Hilfe einer TOC-Page wird ein grobes Inhaltsverzeichnis eines Dokuments mit einer Präambel, Artikeln und einem Anhang erstellt. Eine Präambel und ein Anhang sind optional. In einer TOC-Page werden alle Artikel aufgelistet, die in das PDF-Dokument exportiert werden sollen. Aus jedem aufgelisteten Artikel wird ein Kapitel im PDF-Dokument erstellt. Die Überschriften im jeweiligen Artikel entsprechen den Unterkapiteln. Die Reihenfolge der aufgelisteten Artikel bestimmt die Reihenfolge der Kapitel im PDF-Dokument. Die Syntax für die Deklaration eines Artikels in der TOC-Page sieht folgendermaßen aus: 

==[[Artikellink | Bezeichnung des Artikels]]==

Diese Syntax entspricht einer Überschrift der 2. Ebene mit einem internen Link aus der Wiki-Syntax. Die Bezeichnung des Artikels ist optional. Bei der Angabe der Artikelbezeichnung wird diese für den Namen des aus diesem Artikel generierten Kapitel übernommen. Im anderen Fall wird das Kapitel mit dem Namen des Artikellinks benannt.

Eine TOC-Page darf auch weitere Elemente, deren Inhalte im PDF-Dokument generiert werden, beinhalten. Diese Elemente sind "Externe Dateien" und "Spezielle Seiten".

Externe Dateien

Eine "Externe Datei" ist ein beliebiges ein- oder mehrseitiges PDF-Dokument, welches am Anfang (Präambel) oder am Ende (Anhang) einer TOC-Page eingefügt werden kann. Im generierten PDF-Dokument werden die Inhalte von "Externen Dateien" entsprechend auch am Anfang oder am Ende eingefügt. Die Benutzung von "Externen Dateien" ist beispielsweise zum Einfügen einer Titelseite am Anfang oder eines Eintrags im Anhang am Ende eines Dokuments bestimmt. Die Syntax für das Einfügen einer "Externen Datei" in einer TOC-Page ist folgende: 

[[Media:Dateiname | Bezeichnung der Datei]]

Diese Syntax entspricht einem internen Link auf eine Datei aus der Wiki-Syntax. Es werden nur PDF-Dateien unterstützt. Eine "Externe Datei" darf entweder am Anfang vor der ersten Deklaration eines Artikels oder am Ende nach der letzten Deklaration eines Artikels eingefügt werden. In beiden Varianten muss eine "Externe Datei" in einer eigenen Zeile stehen. Beim Einfügen einer "Externen Datei" am Anfang einer TOC-Page wird der Inhalt der Datei ein-zu-eins in das generierte PDF-Dokument eingeführt. Wenn eine "Externe Datei" am Ende einer TOC-Page deklariert wird, wird der Inhalt dieser Datei unter einem eigenen Kapitel im generierten PDF-Dokument eingefügt. Der Name des Kapitels wird entweder von der Bezeichnung der Datei oder, falls keine Bezeichnung angegeben wird, von dem Dateinamen übernommen.

Spezielle Seiten

Eine "Spezielle Seite" ist ein Artikel, der auch wie eine "Externe Datei" am Anfang oder am Ende einer TOC-Page eingefügt werden kann. "Spezielle Seiten" können zum Beispiel für das Einfügen einer Kurzfassung am Anfang oder eines Eintrags im Anhang am Ende eines Dokuments benutzt werden. Im Gegensatz zu "Externen Dateien" werden "Spezielle Seiten" im Wiki verfasst. Hier ist ein Beispiel für eine "Spezielle Seite": 

[[Artikellink | Bezeichnung des Artikels]]

Die Syntax für "Spezielle Seiten" entspricht einem internen Link auf einen Artikel aus der Wiki-Syntax. In Analogie zu "Externen Dateien" wird der Inhalt einer "Speziellen Seite" ohne Änderungen in das generierte PDF-Dokument eingefügt, wenn die "Spezielle Seite" am Anfang einer TOC-Page vor der Deklaration des ersten Artikels kommt. Beim Einfügen einer "Speziellen Seite" am Ende einer TOC-Page nach der letzten Deklaration eines Artikels wird der Inhalt der "Speziellen Seite" in einem eigenen Kapitel platziert. Die Überschriften von "Speziellen Seiten" werden nicht zu Unterkapiteln wie bei normalen Artikeln, sondern bleiben als Überschriften im generierten PDF-Dokument.

Wie schon bereits erwähnt, stellt eine TOC-Page das Inhaltsverzeichnis eines Dokuments dar. Außer der vorgestellten Elemente, die auf einer TOC-Page deklariert und deren Inhalte in das PDF-Dokument eingefügt werden, darf eine TOC-Page auch zusätzliche Informationen beinhalten. Diese Informationen, beispielsweise bestehend aus einer Gruppierung bzw. einer Beschreibung von bestimmten Artikeln, kann zur besseren Veranschaulichung einer TOC-Page im Wiki dienen. Diese zusätzlichen Inhalte können aus beliebigen Elementen der Wiki-Syntax bestehen, werden aber nicht in das PDF-Dokument exportiert. Die Überschriften der 1. Ebene (=Überschrift=) dürfen auf einer TOC-Page nicht benutzt werden. Im Folgenden wird ein Beispiel von einer TOC-Page eines Dokuments gezeigt: 

<h1>Präambel</h1>
[[Media:titelblatt.pdf | Titelblatt]]

[[Kurzfassung]]
<h1>Kapitel</h1>
==[[Artikellink1 | Bezeichnung des Artikels1]]==
==[[Artikellink2 | Bezeichnung des Artikels2]]==
==[[Artikellink3 | Bezeichnung des Artikels3]]==
<h1>Anhang</h1>
[[Media:listings.pdf | Listings]]

[[Tabelle | Tabellen]]

Abbildung Beispiel einer TOC-Page zeigt die Darstellung der vorgestellten TOC-Page im Wiki.

Beispiel einer TOC-Page

Wiki-Syntax-Elemente

Wiki2PDF unterstützt die meist verwendeten Elemente aus der Wiki-Syntax, wie zum Beispiel Textformatierungen, Bilder, Tabellen, Fußnoten, die zur Verfassung eines Wiki-Artikels benutzt werden. Es werden außerdem weitere Elemente der speziellen Wiki-Syntax unterstützt, für welche eine zusätzliche Installation von MediaWiki-Erweiterungen benötigt wird. Die Anleitung zur Installation und Konfiguration vom MediaWiki ist im Abschnitt Administration vom MediaWiki beschrieben. In Tabelle Wiki-Syntax-Elemente im Anhang sind alle Elemente, die von Wiki2PDF unterstützt werden, zu finden. Im Folgenden werden die Einzelheiten zu bestimmten Wiki-Syntax-Elementen erläutert. Bei allen Elementen ist zu beachten, dass nur die Zeichen unterstützt werden, welche über die Tastatur eingegeben werden. Bei dem Kopieren eines Textes aus einem Textverarbeitungsprogramm wie zum Beispiel MS Word können bestimmte Zeichen auftreten, die durch das Textverarbeitungsprogramm automatisch erstellt werden. Solche Zeichen werden im generierten PDF-Dokument durch die !!!REPLACEMENT!!! Markierung ersetzt. Somit wird der Benutzer auf die nicht unterstützten Zeichen aufmerksam gemacht und muss diese an den entsprechenden Stellen im Wikitext beseitigen oder durch analoge Zeichen ersetzen.

Überschriften

Im vorherigen Abschnitt wurde bereits erwähnt, dass Artikelüberschriften als Unterkapitel im PDF-Dokument eingefügt werden. Im Wiki gibt es sechs verschiedenen Überschriften - von Ebene 1 bis Ebene 6, wobei die Überschriften der 1. Ebene nicht erwünscht sind. Die Überschriften der 2. Ebene werden als Unterkapitel, die Überschriften der 3. Ebene als Unter-Unterkapitel und die Überschriften der 4., 5. und 6. Ebene als Unter-Unter-Unterkapitel im PDF-Dokument dargestellt. Der Name einer Überschrift darf aus reinem Text bestehen und soll keine Textformatierungen und andere Elemente beinhalten.

Wiki2PDF bietet die Möglichkeit der Wiederverwendbarkeit von Artikeln. Das bedeutet, dass ein Artikel innerhalb eines anderen Artikels eingebunden werden kann. Die Einbindung eines Artikels in einen anderen Artikel ist mit der folgenden Syntax möglich: 

==[[Artikellink | Bezeichnung des Artikels]]==

Die Syntax entspricht einer Überschrift der 2. Ebene mit einem internen Link auf den Artikel. Die Einbindung von Artikeln funktioniert nur mit einer Überschrift der 2. Ebene. Im generierten PDF-Dokument wird eine solche Überschrift mit dem Link auf einen Artikel durch ein Unterkapitel mit dem Inhalt von dem verlinkten Artikel ersetzt. Die angegebene Artikelbezeichnung stellt den Namen für das Unterkapitel dar. Aus den Überschriften des eingefügten Artikels entstehen Unter-Unterkapitel. Der Inhalt zu einer Überschrift der 2. Ebene mit einem internen Link sowie zur Überschriften tieferer Ebene werden von "Wiki2PDF" bei der Generierung des PDF-Dokuments ignoriert.

Bilder

Im Wiki werden viele Möglichkeiten zur Anordnung eines Bildes im Text angeboten. Wiki2PDF unterstützt einige Bildanordnungen, wobei die zentrierte Anordnung empfohlen wird. Folgende Parameter werden beim Einfügen eines Bildes von Wiki2PDF berücksichtigt:

  • framed
  • center
  • right
  • left

Bei der zentrierten Anordnung eines Bildes im Wiki wird das Bild in der Mitte der Seite platziert und nicht mit dem Text umflossen. Bei der rechten und linken Anordnung wird das Bild mit dem Text umflossen. Bei einem mit dem Text umflossenen Bild übernimmt Wiki2PDF die gleiche Anordnung im generierten PDF-Dokument, wobei das Bild auf ein Drittel der Textbreite skaliert wird.

Der framed Parameter bewirkt im Wiki nicht nur das Umrahmen eines Bildes, sondern das Bild wird auch mit der Bildunterschrift (falls angegeben) versehen. Im generierten PDF-Dokument werden Bilder unabhängig vom Parameter framed mit der Bildunterschrift versehen. Da alle Parameter bei einem Bild im Wiki-Syntax mit dem "|"-Zeichen voneinander getrennt werden und Wiki2PDF nur die oben aufgelisteten Parameter berücksichtigt, wird der letzte unbekannte Parameter zur Bildunterschrift. Es wird empfohlen die Bildunterschrift nach dem letzten "|"-Zeichen einzugeben. Folgendes Beispiel zeigt, wie man ein Bild mit einer Unterschrift zentriert und eingerahmt in einen Artikel eingefügt: 

[[Image:file.png | framed | center | Bildunterschrift]]

Anstelle vom Präfix Image können die Präfixe File oder Bild benutzt werden. Folgende Bildformate werden von Wiki2PDF unterstützt:

  • JPG (JPEG)
  • PNG
  • GIF
  • SVG
  • PDF

Beim Einfügen einer PDF-Datei als Bild im Wiki, wird diese nicht als ein Bild, sondern als ein Link auf diese Datei angezeigt. Wiki2PDF fügt aber die PDF-Dateien als Bilder in das generierte PDF-Dokument ein. Dabei wird die erste Seite einer PDF-Datei als Bild eingefügt.

Skalierung der Bilder

Ein wichtiger Aspekt beim Einfügen eines Bildes ist seine Auflösung. Auf einem Bildschirm werden Bilder standardmäßig abhängig von ihrer absoluten Auflösung (Bildgröße in Pixeln) angezeigt. Im Wiki werden Bilder ohne Angabe von Skalierungsparameter in Originalgröße wiedergegeben. Beim Generieren eines PDF-Dokuments mittels Wiki2PDF wird bei Bildern nicht die absolute Auflösung in Pixeln, sondern ihre relative Auflösung in DPI berücksichtigt. DPI (dots per inch) bezeichnet die Anzahl von Punkten pro Inch. Je größer die DPI ist, desto kleiner erscheint das Bild im PDF-Dokument.

Damit ein Bild in der gewünschten Größe auf einer Seite des PDF-Dokuments angezeigt wird, muss seine DPI richtig eingestellt werden. Hierfür bietet sich das Open Source Programm "IrfanView" [2] an. Beim Öffnen einer Bilddatei in "IrfanView" ist es möglich, über die "Print"-Menü in der "Vorschau" die Dimension des Bildes auf der Seite zu betrachten. Wenn das Bild zu groß dargestellt wird, kann man über die "Information"-Menü (oder Tastenkürzel "i") die DPI-Werte (horizontal und vertikal) ändern. Zur besseren Abschätzung von DPI in Abhängigkeit zur absoluten Auflösung ist folgendes Beispiel:

Bei einer Bildauflösung von 720 x 540 Pixel muss DPI 100 x 100 betragen, damit das Bild eine halbe DIN-A4 Seite groß ist.

Nach der geeigneten Einstellung der DPI-Werte kann das Bild gespeichert und in das Wiki hochgeladen werden. Wenn der DPI-Wert nicht eingestellt wird und das Bild zu groß ist, wird dieses im PDF-Dokument automatisch auf die Textbreite skaliert. Die SVG-Bilder werden nach ihrer absoluten Auflösung (in mm) in das PDF-Dokument eingefügt.

Listings

Wiki2PDF unterstützt die Einbindung von Listings in Wiki-Artikel. Ein Listing ist ein Ausdruck von Quellcode. Mit Hilfe von bestimmten Parametern lässt sich die Anzeige vom eingegebenen Quellcode beeinflussen. Der Parameter lang ist obligatorisch und definiert die Sprache des Quellcodes. Abhängig von der angegebenen Sprache werden bestimmte Schlüsselwörter des Quelltextes hervorgehoben.

Zwei weitere optionale Parameter (line und caption) werden von Wiki2PDF unterstützt. Mit dem line Parameter wird die Nummerierung der Zeilen vom Quellcode angezeigt. Bei diesem Parameter ist keine Wertangabe notwendig. Der caption Parameter ist kein Teil der Wiki-Syntax und wurde extra für Wiki2PDF eingeführt. Die Angabe dieses Parameters beeinflusst nicht die Anzeige des Quellcodes im Wiki, wird aber im generierten PDF-Dokument als Unterschrift vom Listing interpretiert. Bei dem caption Parameter muss der Wert in Anführungszeichen angegeben werden. Das folgende Beispiel zeigt einen Listing mit allen unterstützen Parameter: 

<div id="listing1">
<source lang="java" line caption="Listingunterschrift">
public class Wiki {
    public static void main(String[] args) {
        System.out.println("Hello, WikiWorld!");
    }
}
</source>
</div>

Mit Hilfe vom HTML-Tag <div id="listing1"> wird das oben angegebene Listing markiert und kann innerhalb von Artikeln mit der Wiki-Syntax [[{Artikellink}#listing1 | Bezeichnung der Listing]] referenziert werden. Der "Artikellink" kann bei einer Referenzierung innerhalb desselben Artikels weggelassen werden. Bei einer Markierung eines Listings muss der <div id="listing1"> Tag in einer eigenen Zeile vor dem <source> Tag stehen. Nach dem Ende eines Listings muss in diesem Fall gleich nach dem </source> Tag der </div> Tag in einer eigenen Zeile folgen.

Es werden nur die Listings unterstützt, die ab einem neuen Absatz beginnen. Der <source> Tag muss daher in einer eigenen Zeile stehen.

Tabellen

Tabellen im Wiki haben eine aufwendigere Syntax als die meisten Elemente. Die Anzeige einer Tabelle lässt sich stark durch Parameter und Konstrukte verändern. Wiki2PDF unterstützt nicht alle Parameter und Konstrukte einer Wiki-Tabelle, bietet dennoch die Möglichkeiten die Darstellung einer Tabelle zu beeinflussen. Folgende Parameter werden von Wiki2PDF am Anfang einer Tabelle berücksichtigt:

  • border
  • align
  • id

Der border Parameter bestimmt, ob eine Tabelle eingerahmt werden soll. Bei der Angabe border="1" wird die Tabelle eingerahmt. Der align Parameter bestimmt die Ausrichtung einer Tabelle. Die Werte "center, right und left" sind zulässig. Mit Hilfe des id Parameters lässt sich eine Tabelle für Referenzierungen markieren.

Die Tabellenunterschrift wird im Wiki standardmäßig über der Tabelle angezeigt. Im generierten PDF-Dokument ist die Tabellenunterschrift unter der Tabelle. Die Unterschrift einer Tabelle darf andere Wiki-Syntax-Elemente, wie zum Beispiel einen Code-Ausschnitt oder einen Link, beinhalten.

Literatur

Mit Hilfe der "Bibwiki"-Erweiterung ist es möglich analog zu BibTeX eine Literaturdatenbank unter MediaWiki zu erstellen und zu pflegen. Der Verweis auf die Anleitung zur Installation von "Bibwiki"-Erweiterung unter MediaWiki ist im Abschnitt Administration von MediaWiki beschrieben. An dieser Stelle wird gezeigt, wie ein Literatureintrag zu erstellen ist und wie man auf diesen innerhalb von Artikeln referenziert.

Literatureintrag erstellen

In der Navigationsleiste vom MediaWiki klickt man auf "Spezialseiten". Im neuen Fenster wählt man unter "Andere Spezialseiten" den Eintrag "Bibliography" aus. Ein neues Fenster mit der "Bibliographie"-Sicht wird geöffnet und die Navigationsleiste vom MediaWiki um viele weitere Menüpunkte erweitert. Um ein Buch in die Literaturdatenbank einzutragen wählt man in der Navigationsleiste unter "Neuen Eintrag erstellen" den Menüeintrag "Buch" aus. Der Eingabebereich zum Eintragen eines neuen Buches wird geöffnet. Abbildung Neuer Eintrag in der Literaturdatenbank zeigt alle Felder eines neuen Eintrags.

Neuer Eintrag in der Literaturdatenbank

Wichtig beim Erstellen eines neuen Literatureintrags ist die Eingabe des Schlüssels. Unter Angabe des Schlüssels kann man innerhalb von Artikeln auf einen Literatureintrag referenzieren. Den Schlüssel gibt man in der ersten Zeile des Eingabebereiches anstelle des "*"-Zeichens an. Die übliche Bezeichnung eines Schlüssels zu einem Literatureintrag ist "Autorenname:Buchtitel" [1].

Auf den Literatureintrag referenzieren

Innerhalb von Wiki-Artikeln ist es möglich mit Hilfe von <bibref> Tag auf die Einträge aus der Literaturdatenbank zu referenzieren. Die Syntax dafür ist folgende: <bibref>Literaturschlüssel</bibref>. Für die Auflistung aller in einem Artikel referenzierten Literatureinträge ist der <bibreferences/> Tag zu gebrauchen.

Interne Links

Mit Hilfe von internen Links besteht nicht nur die Möglichkeit zwischen den Artikeln zu navigieren, sondern es ist auch möglich auf bestimmte Inhalte innerhalb eines Artikels zu referenzieren. Der Verweis auf eine Überschrift innerhalb desselben Artikels wird mit der Syntax [[#Überschriftname | Verweistext]] realisiert. Zum Verweisen auf die Überschrift in einem anderen Artikel muss der Artikelname vor dem "#"-Zeichen stehen. Im generierten PDF-Dokument können Verweise auf Artikel und Überschriften als Verweise auf Kapitel bzw. Unterkapitel benutzt werden. Über die Einstellungen, die im Abschnitt Wiki2PDF-Einstellungen beschrieben sind, lässt sich die Darstellung der Querverweise im generierten PDF-Dokument konfigurieren. Die Klein-Großschreibung bei den Verweisen muss beachtet werden. Wiki2PDF unterstützt außerdem die Verweise auf Bilder, Tabellen und Listings.

Bildverweis

In MediaWiki werden alle Bilder in eine zentrale Stelle hochgeladen und können in mehreren Artikeln eingefügt werden. Somit gehören Bilder nicht einem bestimmten Artikel und können nicht direkt über ihre Namen innerhalb eines Artikels referenziert werden. Bei Wiki2PDF bietet sich die Möglichkeit, auf ein Bild innerhalb des PDF-Dokuments zu verweisen. Mit der folgenden Syntax ist es möglich auf ein Bild zu referenzieren: 

Die Abbildung [[:Image:bildverweis.png | Verweis auf ein Bild im Wiki]]
zeigt wie diese Wiki-Syntax im Wiki aussieht.

Wichtig bei einem Bildverweis ist der Doppelpunkt vor dem Schlüsselwort Image. Anstelle dieses Schlüsselwortes können auch Schlüsselwörter Bild und File benutzt werden.

Verweis auf ein Bild im Wiki

Mit der Standardeinstellung wird im generierten PDF-Dokument die Bildbezeichnung durch den Index des Bildes ersetzt. In Abbildung Verweis auf ein Bild im PDF-Dokument ist die Darstellung des vorgestellten Beispielverweises im PDF-Dokument zu sehen.

Verweis auf ein Bild im PDF-Dokument

Tabellen- und Listingsverweis

Die Verweise auf Tabellen und Listings werden mit der gleichen Syntax wie Verweise auf Überschriften realisiert. 

[[#tabellenId | Tabellenbezeichnung]]

Die referenzierten Tabellen bzw. Listings müssen extra mit einer id versehen werden. Wie man die Tabellen bzw. Listings mit einer id markiert, ist in der Beschreibung des jeweiligen Elements zu finden.

Externe Links

Externe Links mit der Angabe einer Link-Adresse und ohne Linkbezeichnung werden in Wiki2PDF anders als im Wiki dargestellt. Am Beispiel des folgenden Wikitextes lässt sich der Unterschied in der Darstellung betrachten. 

MediaWiki ist unter dem Link [http://mediawiki.org] zu finden.

Abbildung Die Darstellung eines externen Links im Wiki zeigt wie dieser Wikitext im Wiki aussieht.

Die Darstellung eines externen Links im Wiki

Die Darstellung dieses Satzes im generierten PDF-Dokument ist in Abbildung Die Darstellung eines externen Links im PDF-Dokument zu sehen.

Die Darstellung eines externen Links im PDF-Dokument

Damit die Anzeige eines externen Links im Wiki und im PDF-Dokument gleich aussieht, muss der Link als normaler Text ohne eckigen Klammern eingegeben werden.

Fußnoten

Für die Fußnoten im PDF-Dokument wird der <ref> Tag aus der Wiki-Syntax benutzt. Der <ref> Tag wird üblicherweise für die Einzelnachweise im Wiki verwendet. Über den <references/> Tag[3] lassen sich alle in einem Artikel benutzten Einzelnachweise auflisten. Diese Einzelnachweise werden im generierten PDF-Dokument unten auf der jeweiligen Seite als Fußnote platziert. Die Fußnoten dürfen unterschiedliche Wiki-Syntax-Elemente beinhalten, wie zum Beispiel fette Formatierung oder einen externen Link.

Vorformatierte Paragraphen

Bei den vorformatierten Paragraphen werden alle Leerzeichen und Zeilenumbrüche genauso wiedergegeben wie sie eingegeben werden. Der Text wird nicht formatiert. Die Schriftart ist auch anders und entspricht einer Schriftart aus der "Monospace"-Familie. Dies ist eine nichtproportionale Schriftart, bei der alle Zeichen eine feste Breite haben (inklusiv Leerzeichen). Im generierten PDF-Dokument werden vorformatierte Paragraphen ohne einen punktierten Rahmen wie im Wiki angezeigt. Die Zeilenumbrüche sind auch wie im Wiki nur an den Stellen im Text, an denen sie angegeben sind. Die Auflösung im Browser ist meistens höher als auf einer ausgedruckten A4-Seite. Aus diesem Grund passen auf einer A4-Seite weniger Zeichen in einer Zeile als im Browser. In normalen Paragraphen werden Zeilen automatisch umbrochen, während in einem vorformatierten Paragraph der Benutzer selber auf die Zeilenumbrüche achten muss. Insgesamt passen maximal 70 Zeichen (inklusiv Leerzeichen) von einem vorformatierten Paragraph in einer Zeile einer A4-Seite. Wenn der Text länger als 70 Zeichen ohne einesn Zeilenumbruch eingegeben wird, geht dieser im PDF-Dokument über den Seitenrand hinaus. Zur Veranschaulichung, wie lang eine Zeile im vorformatierten Paragraph sein darf, wird folgender Text angegeben: 

Lorem ipsum dolor sit amet consectetuer ipsum augue enim eros mauris.

Verfassen eines Papers im Wiki

Wiki2PDF bietet die Möglichkeit ein Wiki-Artikel als Paper in Form eines PDF-Dokuments zu exportieren. Für das Layout des Papers wird die Dokumentklasse "svmultln" vom "Spinger Verlag" verwendet. Damit ein Artikel den Anforderungen eines Papers entspricht, müssen bestimmte Regeln bei der Verfassung des Artikels beachtet werden. Zum Einfügen eines Titels, Autoren und anderen für ein Paper spezifischen Elementen sind Annotations zu gebrauchen. Die Annotations werden als Kommentare im Artikel eingefügt und sind somit bei der Anzeige des Artikels nicht sichtbar. Die Annotations haben nur für Wiki2PDF eine Bedeutung. Folgende Wiki-Syntax zeigt ein Beispiel zum Erstellen eines Papers im Wiki: 

<center>
<!--@:title-->
<big>'''Titel des Papers'''</big>

<!--@:author-->
Autor1, Autor2

<!--@:institute-->
 Institut
 Adresse
 Webseite

<!--@:abstract-->
Kurzfassung
<br/>
<!--@:keywords-->
Keywords
</center>
==Abschnitt 1==
Text

In Abbildung Darstellung vom Paper im Wiki ist die Darstellung dieser Wiki-Syntax im Wiki zu sehen.

Darstellung vom Paper im Wiki

Der Inhalt eines Papers kann alle von Wiki2PDF unterstützten Elemente beinhalten.

Fußnoten

  1. ↑ Über die URL {wikiURL}/Special:Version lässt sich die Version vom MediaWiki überprüfen
  2. ↑ Verfügbar unter http://www.irfanview.de
  3. ↑ Der <references/> Tag wird meistens am Ende eines Artikels eingefügt

Literaturreferenzen

  1. ↑ my.bib/kop00: Referenz-Fehler 9: <BIBCITE_ERROR_9> Bib
Von „http://www.montiweb.de/wiki/MP:Tutorial“
Persönliche Werkzeuge