De/Erste Schritte
From Unknown Horizons
Hallo und herzlich willkommen zu diesem kleinen Tutorium. Dieses soll Dir zeigen, wie Du in dieser Wiki neue Beiträge verfasst.
Contents |
Wohin mit dem Artikel?
Um einen neuen Artikel anzulegen, musst Du entweder einem roten Link folgen oder du rufst eine nicht vorhandene Seite auf. Bitte bedenke, dass Artikel in deutscher Sprache mit dem Präfix „de:“ ausgestattet werden sollten. Englischsprachige Artikel sollten äquivalent dazu die Voranstellung „en:“ erhalten. Wenn Du als beispielsweise den Artikel Sandbox anlegen möchtest, folge dem Link http://www.openanno.org/wiki/index.php/en:Sandbox für einen englischen Artikel.
Innerhalb der Artikel solltest Du dich ebenfalls an gewisse Formatierungsregeln halten.
Formatierungsregeln
Zunächst einmal sollte der Artikel eine klare Struktur aufweisen und gut leserlich geschrieben sein. Vermeide ellenlange verschachtelte Bandwurmsetze und vermeide so gut es geht komplizierte Fremdworte.
Überschriften
Über dem Artikel sollte sich immer ein kleiner Abschnitt befinden, der kurz erklärt, um was es in dem Artikel geht. Dann beginnen die Überschriften und unter den Überschriften steht der jeweilige Text. Eine Überschrift erstellst Du, indem Du vor und nach dem Text Ist-gleich-Zeichen setzt. So zum Beispiel ist die Überschrift über diesem Abschnitt, die unterstrichen erscheint, mit == Formatierungsregeln == erzeugt worden. Die Leerzeichen zwischen Text und Zeichen sind keine Pflicht, erhöhen jedoch die Leserlichkeit enorm.
Je „tiefer“ eine Überschrift sein soll, desto mehr =-Zeichen setzt Du ein. Für Hauptüberschriften wären das dementsprechend zwei, für Unterüberschriften drei, für Unterunterüberschriften vier und so weiter. Beachte jedoch, dass Du maximal sechs =-Zeichen hintereinander setzen kannst, das ist die kleinste Unterüberschrift.
Geht es in dem Artikel um zwei sehr verschiedene Themen, solltest Du überlegen, ob eine Aufspaltung sinn ergibt. Ansonsten ist es auch möglich, Überschriften mit nur einem =-Zeichen zu erzeugen. Diese erscheinen dann genau so groß wie die Hauptüberschrift ganz oben.
Abschnitte
Unterhalb dieser Überschriften werden dann die Textabschnitte geschrieben. Diese werden als ganz normaler Text verfasst. Um einen neuen Abschnitt zu beginnen, setzt Du einfach zwei Zeilenumbrüche, sodass zwischen den Abschnitten eine leere Zeile bleibt.
Textauszeichnungen
Manchmal ist es sinnvoll, Texte auszuzeichnen, als Fettkursiv, Fett oder Kursiv darzustellen. Hier gilt, dass man vor einen fetten Text drei einfache Anführungszeichen (') stellt und ihn damit wieder abschließt, also beispielsweise '''so'''. Kursive Texte bekommen nur zwei einfache Anführungszeichen. Wenn man beide Methoden kombiniert, als fünf Anführungszeichen setzt, erscheint der Text Fettkursiv.
Listen
Eine liste zu erzeugen ist sehr einfach:
- Zunächst einmal gibt es zwei Arten von Listen:
- ungezählte Listen
- gezählte Listen
- Außerdem ist es, wie bereits gezeigt möglich, Listen zu verschachteln.
Um solch eine wahllose Liste zu erstellen, setzt man einfach vor jeden neuen Listenpunkt ein Sternchen (*). Je mehr Sternchen sich vor dem Text befinden, desto weiter wird dieser eingerückt. Als Beispiel ist der Text „ungezählte Liste“ mit zwei Sternchen versehen. Eine geordnete Liste erstellt man, indem man statt dem Sternchen ein Raute (#) vorstellt. Der Übersichtlichkeit wegen sollte sich vor und nach der Liste jeweils eine leere Zeile befinden. Außerdem sollte zwischen Listenzeichen und Text jeweils ein Leerzeichen gesetzt werden.
Tabellen
Eine Tabelle zu erstellen, ist nicht schwierig. Die Tabelle beginnt mit einem {| und endet mit einem |}. Zwischen diesen Zeichen besteht die Tabelle aus Zeilen, die sich in Spalten teilen. Jeder Tabellenzelle wird ein senkrechter Strich (|) oder ein Ausrufezeichen (!) vorangestellt. Dabei steht der Strich für ein normales Feld, das Ausrufezeichen für ein besonders hervorgehobenes Überschriftsfeld.
In jeder Zeile sollten sich gleich viele Zellen befinden. Nach jeder Zeile folgt ein |-, um die Zeile abzuschließen. Danach sollten wieder die einzelnen Zellen folgen - und zwar genau so viele wie in der Zeile darüber. Man kann allerdings auch Zellen zusammenfügen. Wie das funktioniert, ist im Beispiel ersichtlich.
Nach dem einführenden Tag sollte übrigens {{prettytable}} folgen. Diese Anweisung verschönert die Tabelle optisch.
{| {{prettytable}}
|- {{highlight1}}
!Diese Zeile ist nun komplett blau,
!da es sich um eine Überschrift handelt
|-
|Man kann auch ganz oben bereits eine neue Zeile beginnen,
|damit man mit {{header1}} die komplette Zeile blau färben kann.
|-
| colspan="2"| Mit diesem Cellpadding plus Strich werden nun aus zwei Zellen eine. Das geht wie in normalem HTML.
|}
Diese Konstruktion ergibt folgendes Ergebnis:
| Diese Zeile ist nun komplett blau, | da es sich um eine Überschrift handelt |
|---|---|
| Man kann auch ganz oben bereits eine neue Zeile beginnen, | damit man mit {{highlight1}} die komplette Zeile blau färben kann.
|
| Mit diesem Cellpadding plus Strich werden nun aus zwei Zellen eine. Das geht wie in normalem HTML. | |
Bilder
Es ist ein Leichtes, Bilder einzufügen. Man muss jedoch zunächst unterscheiden, ob das Bild am Rand oder direkt im Text auftauchen soll.
Bild im Text
Um z.B. einen Kompass so wie hier 
im Text erscheinen zu lassen, genügt die Zeile [[Image:Oa_startmenu_compass.png|14px]]. Bedenke, dass die Angabe der Größe nicht zwingend erforderlich ist.
Dabei gibt der Text vor dem Strich den Bildnamen an. Dieser beginnt immer mit „Image:“. Bedenke, dass nur Bilder eingebunden werden können, die hier in der Wiki hochgeladen wurden. Das Einbinden externer Quellen ist nicht möglich. Die Angabe hinter dem Strich gibt die darzustellende Bildbreite an. Die höhe errechnet die Software automatisch.
Bilder am Rand
Diese Bilder werden prinzipiell wie wie oben eingebunden. Auch hier kann die Bildgröße weggelassen werden. Um das Bild jedoch auf die Seite zu schieben, benötigt man die Zusatzangabe „thumb“. Um Beispielsweise den Kompass rechts anzuzeigen, benötigt man diese Angabe: [[Image:Oa_startmenu_compass.png|thumb]]. Füge diese Zeile am besten über dem zugehörigen Abschnitt ein und mache dann einen Zeilenumbruch zum Text. Damit wird das Bild mit dem Text verknüpft.
Hier gibt es jedoch noch einige Zusatzangaben. Zum Einen kann unter dem Bild eine Beschreibung angezeigt werden. Dazu wird an den obigen Code einfach noch ein „|Text hier“ angehängt. Außerdem kann das Bild mit der Angabe „|left“ auf der linken Seite angezeigt werden. Außerdem ist hier wieder eine Größenangabe möglich.
Das Bild links ist mit folgendem Code erzeugt: [[Image:Storage_tent5.jpg|thumb|left|Lagerzelt]].
Links
Es ist immer wieder nützlich, Verknüpfungen zu setzen. Die Wiki-Software unterscheidet zwischen internen und externen Links.
Interne Links
Innerhalb der Wiki kannst Du auf andere Artikel verknüpfen, indem du innerhalb einer doppelten eckigen Klammer den Artikelnamen schreibst. Um also z.B. auf die Hauptseite zu verknüpfen, schreibst Du einfach [[Main Page]] und Du erhälst einen Link zur Main Page.
Manchmal ist es wünschenswert, den Text abweichend vom Artikelnamen anzugeben. Um einen einfachen Plural anzugeben, kannst Du den Text direkt an die Klammer hängen, also z.B. [[Hauptseite]]n, was zu Hauptseiten wird. Manhmal möchtest Du aber vielleicht den kompletten Text verändern, um z.B. auf den Sandkasten zu verweisen. Dies machst Du mit [[Sandbox|Sandkasten]].
Andere Sprache
Es gibt zwei Möglichkeiten, auf eine andere Sprachversion zu verweisen. Zum einen ist da die Eintragung in die Liste auf der linken Seite. Dies wird einfach erledigt, wenn man ganz am Ende des Artikels z.B. [[en:Main_Page]]n einfügt.
Um innerhalb des Textes einen Sprachlink einzufügen, muss dem Länderkürzel ein Doppelpunkt vorangestellt werden.
Externe Links
Externe Links funktionieren etwas anders als interne Links. Vor allem unterscheiden sie sich, da externe Links nur in eine einfache eckige Klammer geschrieben werden.
Es gibt zwei verschiedene Darstellungsmöglichkeiten. Um auf den Blog zu verlinken, könnte man folgendes schreiben:
-
[http://openanno.org]ergibt [1] -
[http://openanno.org zur Startseite]ergibt zur Startseite
