Handbuch für Autoren

Inhaltsverzeichnis

• Bearbeiten eines bestehenden Artikels
• Erstellen eines neuen Artikels
  • Für Fortgeschrittene: Synonyme bei Artikelnamen
• Formatieren von Artikeln
  • Wiki-Syntax: Textformatierungen
  • Wiki-Syntax: Hochgestellter/tiefgestellter Text
  • Wiki-Syntax: Überschriften
  • Wiki-Syntax: Aufzählungen
  • Wiki-Syntax: Text in Rahmen
• Einfügen eines Inhaltsverzeichnisses
• Einfügen von Verlinkungen
  • Verlinkungen von Wiki-Artikeln untereinander
  • Verlinkungen nach draußen
• Einfügen von Bildern und Grafiken
• Quellennachweise
  • Der Bearbeitungskommentar
  • Links
  • Fußnoten
  • Links

Bearbeiten eines bestehenden Artikels

Grundsätzlich kann jeder Artikel des Wiki (abgesehen von Infoseiten wie dieser hier) von jedem Leser bearbeitet werden. Sie haben eine Information, die in dem Text noch fehlt, oder haben einen Fehler entdeckt? So geht's:

1. Klicken Sie in der oberen linken Ecke des Artikels auf den Tab "Bearbeiten". Es öffnet sich die zum Artikel gehörende Bearbeiten-Seite. Ihre zentralen Elemente sind:
   • Das Bearbeitungsfenster mit dem editierbaren Text: Hier kann neuer Text eingetragen, bestehender gelöscht oder geändert werden. Einfach reinklicken und loslegen. Wie man hier besondere Textformate findet oder Grafiken oder Links einfügt, wird weiter unten auf dieser Seite erklärt.
   • Die Kategorien-Verwaltung: mit einem Klick auf den ganz oben stehenden Link "Select Categories" öffnet sich eine Liste der bestehenden Kategorien. Jeder Artikel sollte mindestens einer Kategorie zugeordnet werden.
   • Die Symbolleiste: Direkt über dem Bearbeitungsfenster ermöglicht die Symbolleiste die einfache Formatierung von Text - ganz so, wie man es vom Textverarbeitungsprogramm kennt. Der zu formatierende Text wird markiert und oben in der Leiste z.B. "B" (engl. für bold=kräftig) geklickt, um das Marktierte fett zu drucken, usw.
   • Kommentarfenster: In das Feld "Edit Comment" kann ein Kommentar zur aktuellen Bearbeitung eingetragen werden - z.B. der Grund für eine sachliche Änderung.
   • Schlagworte zum Artikel: In das Feld "Folksonomy Tags" können relevante Schlagworte zum Artikel eingetragen werden, die die Verknüpfung und Findbarkeit der Wiki-Artikel fördern.
   • Bild hochladen: Hier kann ein Bild vom eigenen Computer in die Datenbank geladen und dann in den Artikel eingefügt werden. Wie das genau geht, wird weiter unten auf dieser Seite erklärt.
2. Ergänzen oder verbessern Sie den Text im Bearbeitungsfenster.
3. Lassen Sie sich Ihre Änderungen als Vorschau anzeigen. Unter der Vorschau erscheint erneut das Bearbeiten-Fenster, so dass Sie noch Korrekturen machen können.
4. Speichern Sie den Text. Ihre neue Version wird in die Datenbank übernommen und ist ab sofort die aktuelle, im Netz sichtbare Fassung des Artikels.

Achtung: Das Wiki ist keine Spielwiese. Wenn Sie nur ein wenig üben möchten, benutzen Sie bitte die Sandbox, verändern Sie dafür bitte keine bestehenden Artikel aus Spaß. Die Editoren machen sinnlose oder falsche Änderungen zwar umgehend rückgängig - doch machen Sie ihnen das Leben bitte nicht unnötig schwer!

Erstellen eines neuen Artikels

Der einfachste Weg, einen neuen Artikel zu erstellen: Tragen Sie den künftigen Artikeltitel in das Feld "Schnellbearbeitung einer Wiki-Seite"in der linken Menüspalte ein (Groß- und Kleinschreibung beachten!), und klicken Sie "Hinzufügen". Es öffnet sich das Bearbeitungsfenster für den neuen Artikel - von hier aus geht es weiter wie oben beschrieben.
Die zweite Variante führt über die internen Wiki-Links. Wurde ein Stichwort, zu dem es noch keinen Artikel gibt, mit einem Wiki-Link versehen, so erscheint hinter dem Stichwort ein blaues Fragezeichen. Klickt man auf dieses Fragezeichen, öffnet sich die Bearbeiten-Seite für den neuen Artikel zu dem Stichwort.

Für Fortgeschrittene: Synonyme bei Artikelnamen

Für die meisten Artikel könnte es eigentlich mehrere Titel geben - weil die Gegenstände, die sie behandeln, mehrere Namen haben. So verfügt z.B. jede Krankheit und jede Pflanze über deutsche und lateinische Namen. Um nicht für jede dieser Varianten oder Synonyme eigene Artikel oder Weiterleitungen anlegen zu müssen, wird im SelbsthilfeWiki einfach zum Hauptartikel ein "Alias" erzeugt. Hierfür gibt es interne Layoutregeln. Es funktioniert geht so:

1. in die allererste Zeile des Bearbeiten-Fensters gehört der Code für das Alias. Er besteht aus zwei Teilen:
   • Dem Alias selbst: Der Code dafür ist (alias( hier steht das Synonym )) .
   • Dem Wörtchen "alias"

Formatieren von Artikeln

Zu den erlaubten Textformatierungen gehören die üblichen Textformatierungen wie fett, kursiv, unterstrichen usw. Weitere grundlegende Formatierungen dienen der Textgliederung, wie Überschriften und nummerierte oder unnummerierte Aufzählungen. Alle diese Formatierungen können einfach über die Symbolleiste über dem Bearbeiten-Fenster getätigt werden, oder indem Sie die Wiki-Syntax benutzen.
In der Symbolleiste steht B für fett (engl.: bold), I für kursiv (engl.: italic) und U für unterstrichen. Die Überschriften werde durch die Symbole H1-H3 erzeugt (engl.: Headline). Markieren Sie einfach den zu formatierenden Text im Bearbeiten-Fenster und klicken Sie auf das entsprechende Symbol.

Wiki-Syntax: Textformatierungen

• Fettschrift wird erzeugt, indem der fett zu druckende Textabschnitt von jeweils zwei Unterstrichen eingegrenzt wird.
• Kursivschrift wird erzeugt, indem der kursiv zu druckende Textabschnitt von jeweils zwei einfachen Anführungszeichen eingegrenzt wird.
• Unterstrichener Text wird erzeugt, indem der unterstrichen zu druckende Textabschnitt von jeweils drei Gleichheitszeichen eingegrenzt wird.

Achtung: Zwar ist es technisch möglich, Text auch farbig hervorzuheben. Im Selbsthilfewiki bitten wir darum, darauf zu verzichten. Farbig hervorgehobene Textbestandteile werden von den Editoren umformatiert.

Wiki-Syntax: Hochgestellter/tiefgestellter Text

Weitere eventuell notwendige Formatierungen sind hochgestellter und tiefgestellter Text. Sie können nur durch EInen Code aus der Syntax erzeugt werden:

• Tiefgestellter Text: Der tiefzustellende Text (wie z.B. die 2 in H₂O) muss von den Subtext-Attributen eingeschlossen werden: {SUB()} Hier kommt der Text hin. {SUB} .
• Hochgestellter Text: Der hochzustellende Text (z.B. Hochzahlen wie x²) muss von den Supertext-Attributen eingeschlossen werden: {SUP()} Hier kommt der Text hin. {SUP} .

Wiki-Syntax: Überschriften

Es gibt drei Überschriftenformate im SelbsthilfeWiki, die hierarchisch angeordnet sind. Überschrift 1 ist die größte, Überschrift 2 die mittlere und Überschrift 3 die kleinste. Die Syntax erzeugt sie durch das Platzieren von ein, zwei oder drei Ausrufezeichen an den Zeilenanfang.

Wiki-Syntax: Aufzählungen

Es gibt zwei Arten von Aufzählungen: nummerierte und unnummerierte. Sie können jeweils in weitere Ebenen hierarchisch angeordnet werden.

• eine unnummerierte Aufzählung (Mit einfachen Buttons als Aufzählungszeichen) wird durch ein Sternchen * am Beginn der jeweiligen Zeile erzeugt. Eine zweite Ebene (die weiter eingerückt wird) erzeugt man durch zwei Sternchen am Anfang der Zeile, usw.
• eine nummerierte Aufzählung (Mit aufsteigenden Ziffern als Aufzählungszeichen) wird durch eine Raute # am Beginn der jeweiligen Zeile erzeugt. Eine zweite Ebene (die weiter eingerückt wird) erzeugt man durch zwei Rauten am Anfang der Zeile, usw.

Wiki-Syntax: Text in Rahmen

Um Text in Rahmen darzustellen (wie auf dieser Seite bei den Beispielen) wird der zu rahmende Text einfach markiert und dann auf das Symbol "Box" geklickt. Alternativ kann auch zu Beginn und zu Ende des Textes per Hand ein ^ -Zeichen gesetzt werden, um den Rahmen zu erzeugen.

Einfügen eines Inhaltsverzeichnisses

Längere Artikel (wie dieser hier) brauchen ein Inhaltsverzeichnis, um handhabbar zu sein. Bei korrekter Formatierung der Überschriften ist die Erstellung kein Problem: Es muss einfach der Code {maketoc} in die erste Zeile des Artikels geschrieben werden (allerdings unter den Alias-Code, falls vorhanden. Wie das dann aussieht, kann man am Anfang dieser Seite bewundern.

Einfügen von Verlinkungen

Links sind der Leim, der das Internet zusammenhält. Das gilt um so mehr für ein Internet-Lexikon, wo Querverweise schnell jede weitergehende Frage beantworten sollen. Daher ist die Philosophie von SelbsthilfeWiki: Lieber mehr verlinken als zu wenig - solange die Links relevant sind.

Verlinkungen von Wiki-Artikeln untereinander

Ein Wiki-Link wird dadurch erzeugt, dass der Artikelname des zu verlinkenden Textes in doppelte Klammern gesetzt wird, also z.B. ((Gürtelrose)) , um den Link Gürtelrose zu erzeugen. Diese Verlinkung funktioniert auch mit einem für den jeweiligen Artikel angegebenen Alias (dazu siehe oben), also z.B. Zoster.
Soll der sichtbare Linktext anders aussehen als der Artikelname, kann man innerhalb der Doppelklammer hinter dem Artikelnamen beliebigen anderen Text eingeben und ihn mit einem vertikalen Strich | (auf der Tastatur bei den größer-kleiner-Zeichen zu finden) vom Artikelnamen trennen. Der Text im Bearbeitungsfenster Nähere Informationen über Gürtelrose finden Sie ((Gürtelrose|hier)). würde also folgendermaßen aussehen: Nähere Informationen über Gürtelrose finden Sie hier.

Verlinkungen nach draußen

Verlinkungen nach draußen gehören nur im absoluten Ausnahmefall in den Artikel. Gewöhnlich sollten sie ihren Platz am Ende des Artikels in einer Extrarubrik "Links" finden.
Ein Link ins Internet wird dadurch formatiert, dass der URL in eckige Klammern gesetzt wird. Soll statt der Webadresse Text zum Klicken angezeigt werden, kann man innerhalb der Klammer hinter dem URL beliebigen anderen Text eingeben und ihn mit einem vertikalen Strich | (auf der Tastatur bei den größer-kleiner-Zeichen zu finden) vom URL trennen.

Einfügen von Bildern und Grafiken

Wegen der vielen möglichen Einstellungen ist dies etwas komplizierter. Um ein Bild in einen Artikel einzufügen, folgen Sie diesen Schritten:

1. Zunächst müssen Sie das Bild ins Wiki hochladen. Suchen Sie dafür das Bild auf Ihrer Festplatte mit dem unter dem Bearbeiten-Fenster gelegenen Button "Durchsuchen". Bestätigen Sie. Da Bild wird nun in den Ordner http://www.selbsthilfewiki.de/site/img/tiki/ geladen. (Diese Schritte können SIe überspringen, wenn sich das Bild bereits auf dem SelbsthilfeWiki-Server befindet - wenn es z.B. bereits auf einer anderen Seite eingebunden ist.)
2. Bewegen Sie den Cursor im Bearbeiten-Fenster an die Stelle, wo Sie das Bild haben möchten. Klicken Sie auf das Symbol "Bild" in der Symbolleiste über dem Bearbeiten-Fenster. Es öffnet sich unter dem Bearbeiten-Fenster ein Formular, in dem alle Einstellungen zum Bild vorgenommen werden können. Folgende Felder stehen zur Verfügung:
   • Image Source: Hier gehört die URL des hochgeladenen Bildes hinein, also der Dateipfad. Es genügt "img/tiki/" mit dem angehängten Dateinamen, also z.B. "img/tiki/puzzle.jpg" - Dies ist das einzige Feld, das unbedingt ausgefüllt werden muss, denn sonst weiß das System nicht, welches Bild geladen werden soll.
   • Alternate Text: Hier kann ein Text eingegeben werden, der angezeigt wird, falls das Bild aus technischen Gründen nicht angezeigt werden kann. Wichtig ist dieser Text vor allem für die Barrierefreiheit: Blinde Menschen können ihn sich vorlesen lassen und damit Informationen über das Bild erhalten, das ihnen sonst verschlossen bleiben würde.
   • Height: Hier kann die Höhe des Bildes definiert werden, falls sie vom Original abweichen soll. Wird die Höhe verändert, ohne danach spezielle Breitenangaben einzugeben, wird das Bild proportional verkleinert/vergrößert.
   • Width: Hier kann die Breite des Bildes definiert werden, falls sie vom Original abweichen soll. Wird die Breite verändert, ohne davor spezielle Höhenangaben einzugeben, wird das Bild proportional verkleinert/vergrößert.
   • Link: Bitte diese Funktion im SelbsthilfeWiki nicht benutzen. Bilder sollten grundsätzlich nicht verlinkt werden!
   • Link Relation: Bitte diese Funktion im SelbsthilfeWiki nicht benutzen. Bilder sollten grundsätzlich nicht verlinkt werden!
   • Link Title: Bitte diese Funktion im SelbsthilfeWiki nicht benutzen. Bilder sollten grundsätzlich nicht verlinkt werden!
   • Alignment: Der hier eingegebene Wert bestimmt, ob das Bild rechts, links oder zentriert auf der Seite erscheint. Mögliche Eingaben sind: left, center, right. Wird dieses Feld benutzt, steht das Bild allein in der Zeile und wird nicht von Text umflossen.
   • Float Alignment: Der hier eingegebene Wert bestimmt, ob das Bild rechts, links oder zentriert auf der Seite erscheint. Mögliche Eingaben sind: left, center, right. Wird dieses Feld benutzt, wird das Bild von Text umflossen. (Achtung: Die Einstellung right in diesem Feld ist Standard in SelbsthilfeWiki. Bitte nur in begründeten Ausnahmen davon abweichen!)
   • Beschreibung: Bitte diese Funktion im SelbsthilfeWiki nicht benutzen, da sie das Layout zerstört. Verweisen Sie bitte im Text an geeigneter Stelle auf das nebenstehende Bild.
   • Image Map: Bitte diese Funktion im SelbsthilfeWiki nicht benutzen.
   • CSS Class: Bitte diese Funktion im SelbsthilfeWiki nicht benutzen.
3. Überprüfen Sie mittels "Vorschau", ob das Bild wie gewünscht auftaucht. Standardmäßig wird ein Bild an der Stelle des Cursors eingefügt. Sie können es verschieben, indem Sie den Code an eine andere Stelle kopieren.

Achtung: Bitte beachten Sie beim Einfügen von Bildern, dass diese gewöhnlich einem Urheberrecht unterliegen. Mit dem Einfügen eines Bildes bestätigen Sie, dass Sie die Rechte an dem Bild halten und es nunmehr unter der Creative Commons-Lizenz verfügbar machen wollen, oder dass Sie geprüft haben, dass das Bild keinem oder einem CC-konformen Copyright unterliegt.

Quellennachweise

Quellennachweise sind die wichtigste Kontrollinstanz im Wiki. Bitte geben Sie stets die Quellen an, die Sie für Ihre Recherche genutzt haben. Es gibt drei Wege, dies zu tun: Den Bearbeitungskommentar, Fußnoten und die Links.

Der Bearbeitungskommentar

Der Bearbeitungskommentar gehört zu jeder Bearbeitung eines Artikels. Er kann im Feld "Edit Comment" unter dem Bearbeitungsfenster eingetragen werden und sollte eine kurze Erläuterung enthalten, was geändert wurde, warum es geändert wurde und auf welchen Quellen die Änderung beasiert.
Änderungen mit Bearbeitungskommentar machen es den Editoren leichter, die Relevanz und Validität einzuschätzen.

Links

Auch weiterführende Links sind relevante Quellen für den Artikel. Wie sie gesetzt werden, wurde oben erklärt. Sie gehören als unnummerierte Aufzählung gesammelt unter eine Überschrift der Kategorie 3 ans Ende des Artikels, allerdings vor den Fußnotenbereich.

Fußnoten

Gibt es zu einer bestimmten Aussage im Text eine präzise lokalisierbare Quelle, so gehört dieser Nachweis in eine Fußnote. Die Erstellung von Fußnoten funktioniert folgendermaßen:

• An der Stelle, an der später die Hochziffer erscheinen soll, wird der gesamte Fußnotentext eingefügt, und zwar zwischen die Codebestandteile {FOOTNOTE()} und {FOOTNOTE}
• Zusätzlich wird in die unterste Zeile des Artikels folgender Code eingestellt: {FOOTNOTEAREA() /} . Er sorgt dafür, dass nun der Fußnotenbereich am Ende der Seite erscheint, während oben im Text nur die Hochzahl abgebildet wird. Bitte leiten Sie den Fußnotenbereich stets mit einer Zeile ein, in der __Anmerkungen:__ steht.

Links

• Dokumentationsseite für das Tiki-Wiki CMS (englisch)

Anmerkungen:

---