====== Formatoptionen im PofoWiki ====== Das PofoWiki unterstützt eine sehr einfache Auszeichnungssprache mit der sich das Aussehen von Artikeln beeinflussen lässt. Für eine Vielzahl von Funktionen stehen im Editor verschiedene Buttons zur Verfügung um das Editieren von Artikeln zu vereinfachen. ===== Textformatierung ===== ==== Schriftgewicht ==== ^Format ^Button ^Shortcut((Tastenkürzel funktionieren nur bei bestimmten Browsern, wie beispielsweise [[http://www.firefox-browser.de|Mozilla Firefox]])) ^Code ^Vorschau ^ | fett | {{info:wiki:contrib:manual:bold.png}} | A-b | %% **Dieser Text ist fett** %% | **Dieser Text ist fett** | | kursiv | {{info:wiki:contrib:manual:italic.png}} | A-i | %% //Dieser Text ist kursiv// %% | //Dieser Text ist kursiv// | | unterstrichen | {{info:wiki:contrib:manual:underline.png}} | A-u | %% __Dieser Text ist unterstrichen__ %% | __Dieser Text ist unterstrichen__ | | hochgestellt | | | Text kann auch %% hochgestellt %% werden | Text kann auch hochgestellt werden | | tiefgestellt | | | Text kann auch %% tiefgestellt %% werden | Text kann auch tiefgestellt werden | | durchgestrichen | {{info:wiki:contrib:manual:strike.png}} | A-d | Text kann %% durchgestrichen %% werden | Text kann durchgestrichen werden | Die Schriftgewichte können auch gemischt werden um mehrere Gewichte gleichzeitig auf den Text anzuwenden. ==== Schriftart ==== Um beispielsweise Programmnamen, Befehlszeilen oder Bildschirmausgaben des Portfolio(tm) darzustellen empfielt es sich, diese zur besseren Erkennung in einer anderen Schriftart zu setzen. Hierfür hat sich im Internet allgemein eingebürgert, eine Schrift mit fester Breite((Sogenannter monospaced Font)) zu verwenden. ^Format ^Button ^Shortcut ^Code ^Vorschau ^ | feste Breite | {{info:wiki:contrib:manual:code.png}} | A-c | %% ''Text in Festbreitenschrift'' %% | ''Text in Festbreitenschrift'' | ==== Überschriften ==== Für Überschriften in einem Artikel stehen die Tasten H1...H5 zur Verfügung. ^Button ^Shortcut ^Funktion ^Anwendungsbeispiel ^ | {{info:wiki:contrib:manual:fonth1.png}} | A-1 | Überschrift Ebene 1 | Titel eines Artikels | | {{info:wiki:contrib:manual:fonth2.png}} | A-2 | Überschrift Ebene 2 | | | {{info:wiki:contrib:manual:fonth3.png}} | A-3 | Überschrift Ebene 3 | | | {{info:wiki:contrib:manual:fonth4.png}} | A-4 | Überschrift Ebene 4 | | | {{info:wiki:contrib:manual:fonth5.png}} | A-5 | Überschrift Ebene 5 | | Innerhalb des PofoWiki gilt, dass Artikel grundsätzlich mit einer Überschrift der Ebene 1 beginnen müssen. Es ist jedoch möglich, innerhalb eines Artikel mehrere Überschriften der Ebene 1 zu verwenden um bspw. Teilartikel voneinander abzutrennen. \\ Die Verwendung von führenden Zahlen innerhalb einer Überschrift((Bspw. um Kapitel wie in einem Buch zu simlulieren)) ist zu vermeiden, da in einem Wiki unnötig. ==== Absatzformatierungen ==== Um einen einen neuen Absatz zu beginnen genügt es, wenn innerhalb des Editors eine Leerzeile eingefügt wird. Es ist jedoch ebenfalls möglich einen Umbruch innerhalb eines Absatzes \\ einzufügen. Um einen einen neuen Absatz zu beginnen genügt es, wenn innerhalb des Editors eine Leerzeile eingefügt wird. Es ist jedoch ebenfalls möglich einen Umbruch innerhalb eines Absatzes \\ einzufügen. ==== Fussnoten ==== Innerhalb eines Artikels können, wie in Printmedien auch Fussnoten((Das sind diese kurzen Texte am Ende einer Seite)) angelegt werden um weiterführende Informationen am Ende des Artikels aufzuführen ohne den Lesefluss zu stören. Innerhalb eines Artikels können, wie in Printmedien auch Fussnoten((Das sind diese kurzen Texte am Ende einer Seite)) angelegt werden um weiterführende Informationen am Ende des Artikels aufzuführen ohne den Lesefluss zu stören. Die fortlaufende Numerierung der Fussnoten wird vom Wiki übernommen und muss von Autor nicht beachtet werden. Wird ein Fussnotenverweis innerhalb des Textes mit der Maus überfahren, so erscheint neben dem Mauszeiger ein kleines Fenster, in dem die Fussnote angezeigt wird. Alle Fussnoten stehen zudem am Ende des Artikels. ===== Aufzählungen ===== Bestimmte Informationen sind besser darzustellen, wenn diese innerhalb einer Aufzählungsumgebung dargestellt werden. Das PofoWiki stellt zwei verschiedenen und verschachtelbare Aufzählungsumgebungen zur Verfügung. ^Button ^Listentyp ^ | {{info:wiki:contrib:manual:list_ul.png}} | Aufzählung mit Punkten | | {{info:wiki:contrib:manual:list.png}} | Numerierte Aufzählung | Aufzählungen können auch vermischt werden. Dabei ist darauf zu achten, dass nicht versehentlich eine Leerzeile zwischen den verschachtelten Listen eingefügt wird, da andernfalls die Zählung wieder mit 1 beginnt. ==== mit Punkten ==== Die Aufzählung mit Punkten kann beispielweise verwendet werden für * Aufzählung von Optionen * Listen * mit Unterpunkten * die selbst auch Unterpunkte enthalten können * und so weiter * Aufzählung von Optionen * Listen * mit Unterpunkten * die selbst auch Unterpunkte enthalten können * und so weiter ==== mit Nummern ==== Die Aufzählung mit Punkten kann beispielweise verwendet werden für - Schrittweise Vorgehensweisen - Aufzählungen - mit Unterpunkten - und so fort - Schrittweise Vorgehensweisen - Aufzählungen - mit Unterpunkten - und so fort Die Zählung erfolgt dabei automatisch und muss von Autor nicht weiter beachtet werden. ===== Verweise ===== Natürlich können Artikel und externe Quellen auch aus einem Artikel heraus verlinkt werden. ^Verweis ^Button ^Shortcut ^Code ^Muster ^ | intern | {{info:wiki:contrib:manual:link.png}} | A-l | %% [[info:wiki]] %% | [[info:wiki]] | | extern | {{info:wiki:contrib:manual:extlink.png}} | | %% [[http://www.portfolioclub.de|PCD]] %% | [[http://www.portfolioclub.de|PCD]] | ==== innerhalb des PofoWiki ==== Um einen Verweis innerhalb des PofoWiki zu erstellen muss dieser von doppelten eckigen Klammern umgeben werden. Dies kann über den passenden Button in der Werzeugleiste erfolgen. Für einen internen Link muss der Namensraum-Pfad [[info:wiki]] angegeben werden. \\ Weiterhin ist es möglich, einen [[info:wiki|Alternativtext]] anzugeben, der dann anstelle des Verweises angezeigt wird. Für einen internen Link muss der Namensraum-Pfad [[info:wiki]] angegeben werden. \\ Weiterhin ist es möglich, einen [[info:wiki|Alternativtext]] anzugeben, der dann anstelle des Verweises angezeigt wird. ==== auf externe Präsenzen ==== Externe Links werden vom PofoWiki automatisch erkannt http://www.google.de und korrekt verlinkt und können auch ohne ein führendes http eingegegeben werden, so wie www.google.de. Externe Links werden vom PofoWiki automatisch erkannt http://www.google.de und korrekt verlinkt und können auch ohne ein führendes http eingegegeben werden, so wie www.google.de. Sollten jedoch Links eingefügt werden, die einen [[http://www.google.de|Alternativtext]] enthalten sollen, so muss der Link speziell als externer Link gekennzeichnet werden oder direkt über den entsprechenden Button eingefügt werden. Sollten jedoch Links eingefügt werden, die einen [[http://www.google.de|Alternativtext]] enthalten sollen, so muss der Link speziell als externer Link gekennzeichnet werden oder direkt über den entsprechenden Button eingefügt werden. ==== InterWiki ==== InterWiki-Verweise sind eine spezielle Form von externen Verweisen. Das PofoWiki unterstützt solche InterWiki-Links für den Zugriff auf externe Quellen und Lexika. Ein InterWiki-Link kann beispielsweise direkt auf einen Wikipedia-Artikel verweisen, der [[wpde>Wiki|Wikis]] zum Thema hat. Ein InterWiki-Link kann beispielsweise direkt auf einen Wikipedia-Artikel verweisen, der [[wpde>Wiki|Wikis]] zum Thema hat. Die möglichen InterWiki-Verweise sind in der folgenden Tabelle aufgeführt. ^Code ^Ziel ^Übergabe ^ | wp | Englische Wikipedia | Artikelname | | wpde | Deutsche Wikipedia | Artikelname | | freecache | WWW-Archiv von www.archive.org | URL | | google.de | Suchmaschine Google Deutschland | Suchanfrage | | go | Suchmachine Google | Suchanfrage | | amazon.de | amazon Deutschland | Suchanfrage | | amazon | amazon USA | Suchanfrage | Testen Sie jeden InterWiki-Link auf seine korrekte Funktion, bevor Sie einen Artikel veröffentichen. Sollte Ihnen die Verwendung nicht klar sein, so wenden Sie sich an das PofoWiki-[[team@pofowiki.de|Team]]. ==== auf Dateien ==== Es können innerhalb von Artikeln bzw. Namensräumen keine Dateien zum Download angeboten werden. Dafür wurde ein [[software:download|besonderer Bereich]] eingerichtet auch den dann aus dem jeweiligen Artikel heraus verwiesen werden kann. Die Eingabe eines Links auf eine Date erfolgt folgendermassen mit dem speziellen InterWiki-Link %% [[pwfd>Pfad?Dateiname|Linktext]] %%, wobei darauf zu achten ist, dass die Gross- und Kleinschreibung in Pfad und Dateinamen berücksichtigt wird. Der Verweis [[pwfd>tools/pbktools?PBKTOOLS.zip|Download PBKTOOLS]] sieht dann innerhalb des PofoWiki so [[pwfd>tools/pbktools?PBKTOOLS.zip|Download PBKTOOLS]] aus. Verweisen Sie auf keine externen Downloadquellen weil so keine Möglichkeit besteht die Dauerhaftigkeit des Links zu sichern. Sollten Sie eine Datei von einer anderen Stelle als Link einfügen wollen, so laden sie diese Datei herunter und folgenden Sie den Schritten zum [[software:download|Upload]] neuer Dateien ins PofoWiki. ===== Tabellen ===== In bestimmten Situationen ist es notwendig, Informationen in tabellarischer Form darzustellen. Für diesen Zweck stellt das PofoWiki eine komfortable Tabellen-Umgebung bereit. ==== Standard ==== ^Spalte 1 ^Spalte 2 ^Spalte 3 ^ | Inhalt | Inhalt | Inhalt | | Inhalt | Inhalt | Inhalt | ^Spalte 1 ^Spalte 2 ^Spalte 3 ^ | Inhalt | Inhalt | Inhalt | | Inhalt | Inhalt | Inhalt | ==== Zellen verbinden ==== ^Spalte 1 ^Partiell verbunden ^^ | Inhalt | Mehr Inhalt || | Inhalt | Inhalt | Inhalt | ^Spalte 1 ^Partiell verbunden ^^ | Inhalt | Mehr Inhalt || | Inhalt | Inhalt | Inhalt | Es ist nur möglich Zellen über mehrere Spalten hinweg zu verbinden. Die Verbindung von Zellen über Zeilen hinweg wird nicht unterstützt. ==== Text ausrichten ==== ^ Beispiel zur Textausrichtung innerhalb von Zellen ^^^ | rechts| zentriert |links | |links | rechts| zentriert | ^ Beispiel zur Textausrichtung innerhalb von Zellen ^^^ | rechts| zentriert |links | |links | rechts| zentriert | ===== Grafiken ===== {{ info:wiki:contrib:manual:image.png}}Die Einbindung((Das Einfügen von Dateien ist nur für Personen der Gruppe "priveligierte User" möglich.)) von Grafiken in das PofoWiki ist sehr einfach. Mit einem Klick auf die Taste "Bilder hinzufügen" öffnet sich ein Dialog über den man Grafiken hochladen und auch ins Wiki einbinden kann. {{ info:wiki:contrib:manual:pofowiki_media_upload.png?400 }} Für Grafikformate, die Metadaten unterstützten ist es möglich und auch dringend angeraten diese mit Informationen zu füllen. Dadurch wird es für andere Autoren deutlich einfacher ein Bild in einem anderen Namensraum zu finden um ein erneutes hochladen zu vermeiden. Als Grafikformate werden JPG, PNG und GIF unterstützt. Es gibt, dass alle Bilder in ihrer **Originalgrösse** hochgeladen werden sollten und eine Skalierung dann vom Wiki vorgenommen wird. Dadurch bleiben die Originaldateien für eine spätere Verwendung erhalten. Dies kommt der Dauerhaftigkeit der Daten innerhalb des Wikis sehr entgegen. ==== Darstellungsgrösse ändern ==== Um die Grösse einer Grafik zu ändern übergibt man im Grafik-Befehl die Breite des Bildes mit einem "?" vom Dateinamen abgetrennt. === Originalbild === **Code:** %%{{info:wiki:contrib:manual:tux2.jpg}}%% {{info:wiki:contrib:manual:tux2.jpg}} === Skaliert auf Breite von 100 Pixel === **Code:** %%{{info:wiki:contrib:manual:tux2.jpg?100}}%% {{info:wiki:contrib:manual:tux2.jpg?100}} Es ist unbedingt darauf zu achten, dass Grafiken im Artikel nicht zu gross erscheinen um den Lesefluss nicht nachhaltig zu stören. Hier gilt wie so oft der Grundsatz "weniger ist mehr", schliesslich kann sich der interessierte Leser jede Grafik per Mausklick in Originalgrösse ansehen. ==== Ausrichtung ==== Die Ausrichtung für Grafiken wird ähnlich der Ausrichtung innerhalb von Tabellenzellen vorgegeben. === Zentriert === {{ info:wiki:contrib:manual:tux2.jpg }} {{ info:wiki:contrib:manual:tux2.jpg }} === Linksbündig mit Umfluss === {{info:wiki:contrib:manual:tux2.jpg }} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. {{info:wiki:contrib:manual:tux2.jpg }} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. === Linksbündig ohne Umfluss === {{info:wiki:contrib:manual:tux2.jpg}} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. {{info:wiki:contrib:manual:tux2.jpg}} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. === Rechtsbündig mit Umfluss === {{ info:wiki:contrib:manual:tux2.jpg}} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. {{ info:wiki:contrib:manual:tux2.jpg}} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. ===== Komfortfunktionen ===== Es stehen neben den Standard-Funktionen noch einige Komfortfunktionen zur Verfügung, die von der verwendeten Wiki-Software automatisch erkannt und umgesetzt werden. Dafür müssen vom Autor keine besonderen Regeln beachtet werden. ==== Smilies ==== Werden innerhalb eines Artikels sogenannte Smilies in Textform gefunden, so werden diese beim Anzeigen des Artikels automatisch in die entsprechende grafische Darstellung umgewandelt. * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% Wenn Sie einen Artikel erstellen und innerhalb diesen noch einige Stellen enthalten sind, die zu einem späteren Zietpunkt noch überarbeitet werden müssen, so empfiehlt es sich ein FIXME einzufügen. Dies gilt auch, wenn Sie einen defekten Link finden, den Sie selbst nicht korrigieren können um darzustellen, dass dieser überarbeitet werden muss. \\ Wenn Sie den Teil eines Artikels zur Löschung vorschlagen möchten, diesen aber nicht selbst löschen möchten, so können sie ein DELETEME einfügen um einem Administrator die Entscheidung zu überlassen. ==== Typographie ==== Bestimmte Zeichenfolgen können vom Wiki in Sonderzeichen umgewandelt werden um die Lesbarkeit zu verbessern und Typographisch korrekte((Im Rahmen der begrenzten Möglichkeiten von Internetpublikationen)) Artikel zu erstellen. ^Zeichenfolge ^Sonderzeichen ^ | %% -> %% | -> | | %% <- %% | <- | | %% <-> %% | <-> | | %% => %% | => | | %% <= %% | <= | | %% <=> %% | <=> | | %% >> %% | >> | | %% << %% | << | | %% -- %% | -- | | %% --- %% | --- | | %% 10x15 %% | 10x15 | | %% (c) %% | (c) | | %% (tm) %% | (tm) | | %% (r) %% | (r) | | %% "Test" %% | "Test" | ==== Zitate ==== Sollen beispielsweise Unterhaltungen hierarchisch dargestellt werden oder Zitate im Allgemeinen eingefügt werden, ist dies selbstverständlich auch möglich und wird vom Wiki korrekt umgesetzt. > Wir würden und freuen von Ihnen zu hören >> Selbstverständlich melden wir uns >>> Das finden wir toll >> Wir würden Sie gerne in der nächsten Woche treffen >>> Sehr schön. Dann verabreden wir uns für nächsten Donnerstag um 16:00 ==== Tastatursequenzen ==== Für eine optimale Lesbarkeit und ein besseres Verständnis der Artikel im PofoWiki müssen Tastatursequenzen speziell gekennzeichnet werden. ^Button ^Shortcut ^Code ^Muster ^ | {{info:wiki:contrib:manual:keyboard.png}} | A-k | Warmstart mit %% C-A-Del %% | Warmstart mit C-A-Del | Die Besonderheit an der Keyboard-Funktion ist, dass bestimmte Tastenbeschriftungen automatisch in der eingestellten Landessprache eingefügt werden. Dies ist insbesondere wichtig um die Übertragbarkeit im Rahmen der CC-Lizenz zu gewährleisten. Die folgenden Tastencodes werden automatisch erweitert: ^Kürzel ^Taste ^deutsche Tastenbezeichnung ^ | C | C | Steuerung | | Ctrl | Ctrl | Steuerung | | A | A | Alt | | Enter | Enter | Eingabetaste | | Space | Space | Leertaste | | Shift | Shift | Umschalttaste | | Del | Del | Entfernen | | Ins | Einfg | Einfügen | | Back | Back | Rückschritt | | Undo | Undo | Rückgängig | | Redo | Redo | Wiederherstellen | | Home | Home | Textanfang | | End | End | Textende | | PageUp | PageUp | Eine Seite aufwärts blättern | | PageDown | PageDown | Eine Seite abwärts blättern | | ScrollLock | ScrollLock | Rollen | | CapsLock | CapsLock | Feststelltaste | | Print | Print | Druck | | SysReq | SysReq | Sytemabfrage | | Break | Break | Unterbrechen | | Up | Up | Hoch | | Down | Down | Runter | | Left | Left | Links | | Right | Right | Rechts | | Minus | Minus | Minus | | Ampersand | Ampersand | Kaufmännisches Und | | LessThan | LessThan | Kleiner als | | GreaterThan | GreaterThan | Grösser als | | ATARI | ATARI | ATARI-Taste | Um eine Tastensequenz dazustellen, müssen die einzelnen Tasten der Sequenz mit einem "-" abgetrennt werden, wie im folgenden Muster zu sehen: Um einen Druck zu starten, drücken Sie A-p, für einen Warmstart C-A-Del. \\ Aus diesem Grund muss die Taste Minus speziell vorgegeben werden, wie bei C-Minus. Um einen Druck zu starten, drücken Sie A-p, für einen Warmstart C-A-Del. \\ Aus diesem Grund muss die Taste Minus speziell vorgegeben werden, wie bei C-Minus.