KissDoc:Erste Schritte

Aus KissDoc

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Allgemein

Ein User kann sich nicht selbst Registrieren. Bei Bedarf solltet ihr mit einem der Admins Kontakt aufnehmen oder eine Mail an die Liste kissdoc at selfdelve dot com senden. Neue User sollten zunächst dieses Kapittel lesen, bevor Dokumente modifiziert oder erstellt werden. Auch wird gebeten, die Leitlinien und Urheberrechte zu kennen und dauerhaft einzuhalten.

Weitere Hilfen gibt es hier in der Hilfe oder bei der MediaWiki.

Usereinstellungen

Nach der Anmeldung sollten zunächst einige Einstellungen vorgenommen werden:

  1. Paßwort ändern! Dabei keine geheimen - wohl aber sichere Paßwörter verwenden, da die Site derzeit keine SSL-Verschlüsslung besitzt!
  2. Die Zeitzone sollte eingestellt werden, da hier allem im GMT Format gespeichert wird.
  3. Bitte eine eigene Usersite erstellen.


Seiten

Jeder kann und soll alles ohne Nachfrage editieren. Dabei sollen die diskutierbaren Leitlinien eingehalten werden. Ein Blick in die Änderungsliste ist demnach für jeden interessant.

Das Anlegen neuer Seiten kann generell über drei Wege erfolgen:

  1. Name der neuen Site Suchen und dann den Link neu erstellen nutzen
  2. In der URI nach index.php/ den neuen Seitennamen eingeben und dann bearbeiten
  3. Von einer beliebigen Page einen Link auf eine nicht existierende Seite anlegen (rote Links)

Dabei sollte der Name der Site eindeutig sein z.Bsp. ISDN, PPP, PPPoE, Log2Sql usw.

Links

Links sind recht einfach und hier kommt die eigentliche Innovation eines Wikis zur Wirkung. Einzig relative Links auf dem KISS Server sind leider nur als externe Links darstellbar. Dies ist bei z.Bsp. /cgi-bin/man2html etwas störend, da hier die volle URI angegeben werden muß. Variablen können aber dabei gute Dienste leisten.

Kategorien

Die Kategorien sind anfangs etwas verwirrend und sollten deshalb mit Bedacht angelegt werden. Die gennerelle Syntax ist dabei [[Kategorie:ArtikelName]]. Ein Link auf eine Kategorie beginnt mit einem Doppelpunkt [[:Kategorie:ArtikeNamel]].

Derzeit gibt es folgende Hauptkategorien. Auffällig dabei ist, dass alle mit dem Schlüsselwort Kategorie: beginnen. Derzeit werden folgende Schlüsselwörter verwendet:

KissDoc
Dies ist der Sitename und somit vordefiniert. Dabei ist die KissDoc die Homepage der Dokumentation selbst. Die meisten Sites, welche unter dieser Kategorie existieren, setzt das Wiki schon von der Installation her voraus:
Die Liste ist erweiterbar. Eine Erweiterung sollte aber logisch sein und hier festgehalten werden! Denkbar ist z.Bsp. eine FAQ.
Spezial
Sind interne vordefinierte Seiten mit Spezialfunktionen. Um diese zu erweitern, müssen PlugIns erstellt oder installiert werden. Auch dies ist erlaubt, wenns logisch ist und funktioniert;)
Benutzer
Ermöglicht den Zugriff auch die Benutzer und deren Disskusionen.
Kategorie
Ist ein vergebenses Schlüsselwort, welches die Kategorien aufnimmt. Diese sind mit unserem alten Inhaltsverzeichnis vergleichbar. Derzeit gibt es folgene Kategorien. Gleichnamige Artikel sollen vorläufig nicht angelegt werden. Die Kategorieseiten selbst können eventuelle Texte aufnehmen.
Bild
Diese Kategorie ist für Uploads aller Art reserviert.
Diskusion
Ermöglicht zu jedem Artikel eine eigene Diskussion.
Artikel
Artikel sind keine Kategorien. Ein Artikel ist eine normale Site zu einem Thema. Dieser Artikel können Detaildokumente enthalten wie z.Bsp. Details. Die eigentliche Adressierung ist dann [Artikel:Details].

Inhaltsverzeichnis

Es gibt zwei Inhaltsverzeichnistypen. Das offizielle Inhaltsverzeichnis, welches mit der alten Struktur vergleichbar ist, verbirgt sich hinter der Willkommenseite. Ein Link darauf kann mit [[KissDoc:Willkommen|Inhalt]] angelegt werden. Dieses Inhaltsverzeichnis muß händig gepflegt werden.

Die Inhaltsverzeichnisse der Artikel werden automatisch ab der dritten Überschrift angelegt. Vor diesen sollte kein Text untergebracht werden.

Persönliche Werkzeuge