PofoWiki

Die ultimative Informationsquelle zum ATARI Portfolio

Benutzer-Werkzeuge

Webseiten-Werkzeuge


info:wiki:contrib:manual:format

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 Shortcut1) Code Vorschau
fett Alt+B **Dieser Text ist fett** Dieser Text ist fett
kursiv Alt+I //Dieser Text ist kursiv// Dieser Text ist kursiv
unterstrichen Alt+U __Dieser Text ist unterstrichen__ Dieser Text ist unterstrichen
hochgestellt Text kann auch <sup>hochgestellt</sup> werden Text kann auch hochgestellt werden
tiefgestellt Text kann auch <sub>tiefgestellt</sub> werden Text kann auch tiefgestellt werden
durchgestrichen Alt+D Text kann <del>durchgestrichen</del> 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™ 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 Breite2) zu verwenden.

Format Button Shortcut Code Vorschau
feste Breite Alt+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
Alt+1 Überschrift Ebene 1 Titel eines Artikels
Alt+2 Überschrift Ebene 2
Alt+3 Überschrift Ebene 3
Alt+4 Überschrift Ebene 4
Alt+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 Überschrift3) 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 Fussnoten4) 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
Aufzählung mit Punkten
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

  1. Schrittweise Vorgehensweisen
  2. Aufzählungen
    1. mit Unterpunkten
  3. 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 Alt+L [[info:wiki]] Informationen zum PofoWiki
extern [[http://www.portfolioclub.de|PCD]] 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 Informationen zum PofoWiki angegeben werden.
Weiterhin ist es möglich, einen 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 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 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.

auf Dateien

Es können innerhalb von Artikeln bzw. Namensräumen keine Dateien zum Download angeboten werden. Dafür wurde ein 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 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 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

Die Einbindung5) 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.

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}}

Tux

Skaliert auf Breite von 100 Pixel

Code: {{info:wiki:contrib:manual:tux2.jpg?100}}

Tux

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 }}

Tux

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.

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

Tux

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.

Tux 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 korrekte6) Artikel zu erstellen.

Zeichenfolge Sonderzeichen
->
<-
<->
=>
<=
<=>
>> »
<< «
--
---
10x15 10×15
(c) ©
(tm)
(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
Alt+K Warmstart mit <key>C-A-Del</key> Warmstart mit Strg+Alt+Entf

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 Strg Steuerung
Ctrl Strg Steuerung
A Alt Alt
Enter Enter Eingabetaste
Space Leertaste Leertaste
Shift Shift Umschalttaste
Del Entf Entfernen
Ins Einfg Einfügen
Back Back Rückschritt
Undo Rückg Rückgängig
Redo Wiederherstell Wiederherstellen
Home Pos1 Textanfang
End Ende Textende
PageUp Bild↑ Eine Seite aufwärts blättern
PageDown Bild↓ Eine Seite abwärts blättern
ScrollLock Rollen Rollen
CapsLock Feststell Feststelltaste
Print Druck Druck
SysReq S-Abf Sytemabfrage
Break Untbr Unterbrechen
Up Hoch
Down Runter
Left Links
Right Rechts
Minus Minus
Ampersand & Kaufmännisches Und
LessThan < Kleiner als
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 Alt+P, für einen Warmstart Strg+Alt+Entf.
Aus diesem Grund muss die Taste speziell vorgegeben werden, wie bei Strg+.

Um einen Druck zu starten, drücken Sie <key>A-p</key>, für einen Warmstart <key>C-A-Del</key>. \\
Aus diesem Grund muss die Taste <key>Minus</key> speziell vorgegeben werden, wie bei <key>C-Minus</key>.
1)
Tastenkürzel funktionieren nur bei bestimmten Browsern, wie beispielsweise Mozilla Firefox
2)
Sogenannter monospaced Font
3)
Bspw. um Kapitel wie in einem Buch zu simlulieren
4)
Das sind diese kurzen Texte am Ende einer Seite
5)
Das Einfügen von Dateien ist nur für Personen der Gruppe „priveligierte User“ möglich.
6)
Im Rahmen der begrenzten Möglichkeiten von Internetpublikationen
info/wiki/contrib/manual/format.txt · Zuletzt geändert: 18/02/2006 00:02 (Externe Bearbeitung)