Wiki-Hilfe

Aus Trigardon
Wechseln zu: Navigation, Suche

Der richtige Umgang mit dem Wiki

Damit möglichst viele hier ihr Wissen und ihre Ideen veröffentlichen, zur Diskussion stellen und weiter ausbauen können, muss auch sichergestellt sein, dass jeder damit umzugehen weiß. Bei Weitem ist der Umgang mit einem Wiki nicht so kompliziert, wie das Erstellen einer auf HTML oder php basierenden Webpage, birgt aber in seiner Syntax und im Aufbau manche Tücken, die hin und wieder mal zu Verzweiflung und Frust führen können. Damit dies nicht geschieht, sollte sich jeder, der im Begriff ist aktiv am Inhalt des Wikis mitzugestalten, ein paar Minuten Zeit nehmen, um sich den Möglichkeiten dieses Sytems bewusst zu werden.

Wer sich sehr eingehend mit dem Script und all seinen Funktionen auseinandersetzen möchte, der kann auf der offiziellen Website des [| Mediawikis] fündig werden. Für all diejenigen, die schnell mit den gängigsten Funktionen vertraut werden möchten, um einen Artikel anzulegen, ihn zu strukturieren und zu kategorisieren kann folgende Kurzanleitung nützlich sein.

Erstellen von Artikeln

Im Wiki wird man keinen generellen Link "Artikel oder Seite erstellen" finden. Alle in roter Schrift dargestellten Links wie dieser hier, Ungefüllter Link, verweisen auf eine Seite ohne Inhalt. Wenn man den Artikel füllen, also somit auch gleichzeitig erstellen möchte, klickt man ihn an und bearbeitet ihn. Das kannst man generell mit allen derartigen Links tun, die während des Stöberns im Wiki auftauchen. Man kann auch während des Verfassens von Texten rote Links produzieren, um sie hinterher selbst zu füllen oder füllen zu lassen. (Siehe dazu den Abschnitt Verlinken.)

Sehr einfach ist es auch, den gewünschten Seitentitel in die Suchleiste einzugeben, um zunächst auch zu überprüfen, ob es ihn schon irgendwo gibt. Falls dies nicht so ist, kann im Suchfenster einfach die Option "die Seite verfassen" angewählt und ein neuer Artikel erstellt werden.

Erstellen von Kategorien

Kategorien bilden die Grundstruktur des Wikis. Möchte man, dass ein Inhalt von allen wiedergefunden wird, so ist es unabdingbar ihn sinnvoll in einer oder mehreren Kategorie/n auftauchen zu lassen. (Siehe dazu auch Kategorisieren von Inhalten.)

Zuallererst müssen diese Kategorien erstellt werden. Dies funktioniert im Wikicode ähnlich wie bei Artikeln, genaueres dazu hier.

Das Trigardon-Wiki bietet bereits eine Fülle von Kategorien. Damit sich im Laufe der Zeit keine durch Neuerstellung doppeln bzw. keiner mehr weiß welche Kategorien nun welche Inhalte führen, wendet euch bitte an einen der Bürokraten (wie z.B. RiaRetterspitz) bevor ihr neue Kategorien erstellt.

Verlinken

Wikiinterne Links werden im Wiki-Code mit [[ am Beginn und ]] zum Schluss definiert, externe hingegen jeweils mit nur einer eckigen Klammer. Will man beispielsweise auf die Startseite des Wikis verlinken, kann das etwa so aussehen:

[[Hauptseite | Die Startseite des Wikis]]

Ergebnis wäre dann: Die Startseite des Wikis

Hier wurde der senkrechte Strich | verwendet, um zuerst den eigentlichen Wikilink Hauptseite vom Linktext zu trennen. Dieser kann aussehen, wie man will: Wer das anklickt, ist doof! usw. Schaut euch auch gern dazu diesen Artikel im Quelltext an.

Verlinken von Kategorien

Kategorien im Wiki tragen maßgeblich zur Übersichtlichkeit aller Inhalte bei. Kategorien können, genauso wie Artikel, ähnlich wie im oberen Abschnitt erläutert, verlinkt werden. So sähe ein beispielhafter Wikicode aus:

[[:Category:Hintergrund | Die Kategorie Hintergrund]]

Ergebnis: Die Kategorie Hintergrund

Dabei ist der Doppelpunkt : zu Beginn des Kategorieaufrufs sehr wichtig, damit das Wiki erkennt, dass man keine Seite kategorisieren, sondern eine Kategroie verlinken will.

Verlinken auf Abschnitte

Gestaltet man einen sehr langen Text, wie diese Wiki-Hilfe hier beispielsweise, ist im Wiki möglich, direkt auf einen bestimmten Abschnitt zu verlinken. Dafür benötigt das Wiki einen Anhaltspunkt, eine Ebene 2 Überschrift zum Beispiel. (Siehe dazu auch Strukturierung von Texten) Folgendermaßen kann das aussehen:

[[Hilfe:Hilfe#Kategorisieren von Inhalten | Kategorisieren von Inhalten]]

Ergebnis: Kategorisieren von Inhalten

Hierbei ist es wichtig auf die Raute # als Trennung zwischen Artikel und dem Titel der Ebene 2 Überschrift zu achten.

Verlinken auf Dateien

Mit gleichem Wiki-Code ist es möglich auf Dateien zu verlinken. Leider ist es derzeit nicht möglich, mittels Wikicode dem Dateilink auch einen schönen Text zu verpassen. Standardmäßig sähe das dann so aus: Datei:Download.pdf

Um dieses Problem zu umgehen, kann man den absoluten Pfad der Datei angeben. (Um diesen herauszufinden, dem Wiki-Dateilink folgen und die Datei aufrufen. In der Adresszeile des Browsers kann man sich nun den absoluten Pfad kopieren.) So platziert man den Inhalt dann schöner in einem externen Link:

| Testdownload

Strukturieren von Texten

Damit lange Texte übersichtlich bleiben und der Betrachter nicht das Gefühl hat, in einer Textflut zu versinken, sind Strukturelemente entscheidend. Folgend werden einige kleine Helfer erläutert. Viele der Funktionen werden auch durch die Toolbar oberhalb des Texteingabefeldes unterstützt: Mit ihren Funktionen kann man auch direkt Wiki-Codes erzeugen.

Die Überschriften

Unter dem eigentlichen Seitentitel kann es noch verschiedenste Zwischenüberschriften geben. Wie weiter oben beschrieben kann man speziell auf sie verlinken, um einen bestimmten Abschnitt im Text wieder zu finden. Hierarchisch steht unter dem Seitentitel (Ebene 1 Überschrift) die Ebene 2, 3, 4 usw. Überschriften. Sie werden durch zwei, drei, vier usw. Gleichheitszeichen = hintereinander ein- bzw. ausgeleitet. So könnte das im Wikicode aussehen:

== Dies ist eine Ebene 2 Überschrift == oder

=== Dies ist eine Ebene 3 Überschrift ===

Hat man mindestens 4 solcher Überschriften gesetzt, generiert das Wiki automatisch ein Inhaltsverzeichnis, wie es am Anfang der Seite sichtbar ist. Ein bedachter Umgang mit diesen Überschriften, sie verschachteln einen Artikel enorm.

Listen

Listen vereinfachen die Hervorhebung und besondere Darstellung von kürzeren Inhalten. Auch sie können, ähnlich wie die Überschriften, verschachtelt werden:

Beschreibung Eingabe Ausgabe
Punktuelle Liste
* Eins
* Zwei
* Drei
** Drei Punkt Eins
** Drei Punkt Zwei

Fügt man eine leere Zeile ein, so beendet man die aktuelle Liste und beginnt eine andere.

  • Eins
  • Zwei
  • Drei
    • Drei Punkt Eins
    • Drei Punkt Zwei
Nummerierte Liste
# Eins
# Zwei<br />Fügt man mehr Zeilen ein,<br />wird die Nummerierung nicht unterbrochen
# Drei
## Drei Punkt Eins
## Drei Punkt Zwei
  1. Eins
  2. Zwei
    Fügt man mehr Zeilen ein,
    wird die Nummerierung nicht unterbrochen
  3. Drei
    1. Drei Punkt Eins
    2. Drei Punkt Zwei
Auflistung von Themen etc.
;Top 1
: Beschreibung 1
;Top 2
: Beschreibung 2-1
: Beschreibung 2-2
Top 1
Beschreibung 1
Top 2
Beschreibung 2-1
Beschreibung 2-2
Auflistungen als Texteinschub
: Einfacher Einschub
:: Zweifacher Einschub
::::: Viel Einschub!
Einfacher Einschub
Zweifacher Einschub
Viel Einschub!
Vermischung von verschiedenen Listen
# Eins
# Zwei
#* Zwei Punkt Eins
#* Zwei Punkt Zwei
# Drei
#; Drei Top Eins
#: Drei Beschreibung Eins
# Vier
#: Vier Beschreibung Eins
#: Dies sieht eher wie eine Fortführung von # Vier aus
#: Und dies wird oftmals anstelle von <br /> benutzt
# Fünf
## Fünf Unter 1
### Fünf Unter 1 Unter 1
## Fünf Unter 2

;Top 1
:* Beschreibung 1-1
:* Beschreibung 1-2
:
;Top 2
:# Beschreibung 2-1
:# Beschreibung 2-2
  1. Eins
  2. Zwei
    • Zwei Punkt Eins
    • Zwei Punkt Zwei
  3. Drei
    Drei Top Eins
    Drei Beschreibung Eins
  4. Vier
    Vier Beschreibung Eins
    Dies sieht eher wie eine Fortführung von # Vier aus
    Und dies wird oftmals anstelle von
    benutzt
  5. Fünf
    1. Fünf Unter 1
      1. Fünf Unter 1 Unter 1
    2. Fünf Unter 2
Top 1
  • Beschreibung 1-1
  • Beschreibung 1-2
Top 2
  1. Beschreibung 2-1
  2. Beschreibung 2-2

Auch hier: Vorsicht vor zu viel Verschachtelung.

Textattribute

Das Wiki kann mittels Wikicode Fettschrift, Kursivschrift oder beides zusammen generieren. Dies Erfolgt mit dem Zeichen '.

' ' Diese Variante würde kursive Schrift generieren' '

' ' ' Diese Variante würde fette Schrift generieren' ' '

' ' ' ' ' Diese Variante würde fette und kursive Schrift generieren.' ' ' ' '


Der <nowiki></nowiki>-Tag führt weiterhin dazu, dass alle Zeichen, die das Wiki sofortig umwandelt, d.h. parsen würde, so angezeigt werden, wie sie eingegeben werden. (Siehe dazu auch die oberen drei Beispiele im Quelltext.)

Grafiken einbinden

Hier findet ihr Beispiele zur Einbindung von Grafiken in den Text. Bitte beachten: Damit die Seite nicht länger als unbedingt notwendig wird, wurden zwei verschiedene Beispielbilder gewählt!

Beschreibung Eingabe Ausgabe
Eingebettetes Bild
(mit alt Text)
ohne Formatierung
...Text [[File:Example2.jpg|Trigardon]]Text...

Text Text TextTrigardon Text Text Text

Text Text Text Text Text

Eingebettetes Bild
mit kleinem grauen Rahmen
...Text [[File:Example2.jpg|border|Trigardon]]Text...

Text Text TextTrigardon Text Text Text

Text Text Text Text Text

Bild mit dem typischen Wiki-Rahmen
...Text [[File:Example.jpg|frame|Trigardon]]Text...
Text Text Text
Trigardon
Text Text Text

Text Text Text Text Text

Thumbnail
(100px Breite)
...Text [[File:Example.jpg|thumb|100px|Trigardon]]Text...
Text Text Text
Trigardon
Text Text Text

Text Text Text Text Text

Wie Thumbnail nur ohne Rahmen
...Text [[File:Example.jpg|frameless|100px|Trigardon]]Text...

Text Text TextTrigardon Text Text Text

Text Text Text Text Text

Interner Link
...Text [[File:Example2.jpg|link=Hauptseite|Trigardon]]Text...

Text Text TextTrigardon Text Text Text

Text Text Text Text Text

Externer Link
...Text [[File:Example2.jpg|link=http://www.trigardon-larp.de|Trigardon]]Text...

Text Text TextTrigardon Text Text Text

Text Text Text Text Text

Grafik ohne Link
...Text [[File:Example2.jpg|link=|Trigardon]]Text...

Text Text TextTrigardon Text Text Text

Text Text Text Text Text

Link zu einer Bildseite
[[:File:Example.jpg]]

[[:File:Example.jpg|Trigardon]]

File:Example.jpg
Trigardon

Direkter Link zur Bilddatei
[[Media:Example.jpg]]

[[Media:Example.jpg|Trigardon]]

Media:Example.jpg
Trigardon

Ausrichtung none
(Unterbrechung des Textflusses
zur Rechten.)
...Text [[File:Example2.jpg|none|Trigardon]]Text...
Text Text Text
Trigardon
Text Text Text

Text Text Text Text Text

Zentriert
...Text [[File:Example2.jpg|center|Trigardon]]Text...
Text Text Text
Trigardon
Text Text Text

Text Text Text Text Text

Links
...Text [[File:Example2.jpg|left|Trigardon]]Text...
Text Text Text
Trigardon
Text Text Text

Text Text Text Text Text

Rechts
...Text [[File:Example2.jpg|right|Trigardon]]Text...
Text Text Text
Trigardon
Text Text Text

Text Text Text Text Text

Vertikale Ausrichtung
text text [[File:Example.jpg|20px]]
text text [[File:Example.jpg|20px|baseline]]
text text [[File:Example.jpg|20px|sub]]
text text [[File:Example.jpg|20px|super]]
text text [[File:Example.jpg|20px|text-top]]
text text [[File:Example.jpg|20px|middle]]
text text [[File:Example.jpg|20px|bottom]]
text text [[File:Example.jpg|20px|text-bottom]]

text text Example.jpg text text Example.jpg text text Example.jpg text text Example.jpg text text Example.jpg

text text Example.jpg text text Example.jpg text text Example.jpg

Wie in einem der oberen Beispiele schon erwähnt, kann man jedem Bild mit dem Parameter px eine absolute Breite zuordnen. Die Höhe wird dementsprechend angepasst.

Kleine Bildergalerie

Es ist recht einfach eine Bildergalerie mit Thumbnails zu erstellen. Die Syntax hierfür lautet: <gallery> File:{Dateiname}|{Beschreibung} File:{Dateiname}|{Beschreibung} {...} </gallery>

Zum Beispiel wird

 <gallery widths=60px heights=60px perrow=7 caption="Das Trigardon-Wappen ist toll!">
 File:Example.jpg|Top 1
 File:Example.jpg|Ein Link auf die [[Hauptseite]]
 File:Example.jpg
 File:Example.jpg
 File:Example.jpg|''Kursive Schrift''
 </gallery>

wie folgt ausgegeben:

Folgende Parameter können also verwendet werden:

  • Überschrift = {caption}
  • Breite aller Bilder = {width}px
  • max. Höhe aller Bilder = {heights}px
  • Bilder pro Zeile (ohne Angabe standardmäßig 4) = perrow=

Tabellen

Tabellen im Wiki sehen für den Anfang wesentlich komplizierter aus, als sie eigentlich sind. Hier eine kurze Erläuterung der Syntax:

{|
Tabellenanfang
|+
Tabellentitel, optional; nur zwischen Tabellenanfang und erster Tabellenreihe
|-
Tabellenreihe, optional an erster Reihe -- Hinweis der ersten Zeile für das Wiki
! 
Tabellenüberschrift Spalte, optional; Aufeinanderfolgende Spalten sollten durch zwei Ausrufungszeichen !! getrennt werden. Alternativ kann auch jeweils in eine Zeile mit einem Ausrufungszeichen ! begonnen werden.
|
Tabelleninhalt Zelle, benötigt! Aufeinanderfolgende Zeilen sollten durch zwei senkrechte Striche || getrennt werden. Alternativ kann auch jeweils in eine Zeile mit einem senkrechten Strich || begonnen werden.
|}
Tabellenende

Ein kleines Beispiel:

Eingabe Ausgabe
{|
! Das Eine !! Das Andere
|-
|Orange
|Apfel
|-
|Brot
|Kuchen
|-
|Butter
|Eis 
|}
Das Eine Das Andere
Orange Apfel
Brot Kuchen
Butter Eis

Kategorisieren von Inhalten

Damit Inhalte zugeordnet und später von allen leicht wiedergefunden werden können, ist es nötig Artikeln Kategorien zuzuordnen. Gleiches gilt auch für die sogenannten Unterkategorien.

Will man einen nun einen Artikel (oder eine Kategorie) in einer Kategorie auftauchen lassen, so macht man dies nicht in der zuzuweisenden Kategorie, sondern direkt im Artikel. Will man beispielsweise seinen Charakterartikel gleichzeitig der Kategorie Charaktere, Geistliche und SC zuordnen, so fügt man folgendes bestenfalls am Ende des Artikels ein:

[[Kategorie: Charaktere]]
[[Kategorie: Geistliche]]
[[Kategorie: SC]]

Ganz unten auf der Artikelseite werden dann die Kategorien gezeigt, denen er zugeordnet ist.


Gleiches Procedere gilt ebenso für Kategorien: Die Kategorien Geistliche und SC sind Unterkategorien von Charaktere.

Hochladen von Dateien

Alle registrierten Benutzer können derzeit folgende Dateitypen hochladen und im Wiki verwenden: png, gif, jpg, jpeg, pdf

Dies geschieht, indem ihr in der linken Navigationsleiste unter Werkzeuge auf Hochladen klickt. Eine kurze Beschreibung und eventuell einen Link auf einen Bezugsartikel sind hilfreich für die Wartung des Wikis und sollten bedacht werden.

Nutzung von HTML

Wer HTML-Tags beherrscht, kann sie wie gewohnt in den Quelltext einbinden.


Allerdings sind derzeit folgende HTML-Elemente nicht gestattet, bzw. werden nicht geparst:

  • <abbr>
  • <b>
  • <big>
  • <blockquote>
  • <br>
  • <caption>
  • <center>
  • <cite>
  • <code>
  • <dd>
  • <del>
  • <div>
  • <dl>
  • <dt>
  • <em>
  • <font>
  • <s>
  • <small>
  • <span>
  • <strike>
  • <strong>
  • <sub>
  • <sup>
  • <table>
  • <td>
  • <th>
  • <tr>
  • <tt>
  • <u>
  • <ul>
  • <var>
  • <!-- ... -->

Wikizeug im Forum

Wenn man im Forum auf einen vorhandenen Wiki-Artikel oder eine Kategorie verlinken möchte, kann man die hier beschriebene Syntax außer acht lassen. Der Artikel Heilige Schrift würde so wie er hier stünde sofortig verlinkt werden, gleiches gilt für Kategorien.

Ansonsten sollten alle Wiki-Formatierungen auch im Forum funktionieren.