KissDoc:Erste Schritte
Aus KissDoc
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:
- Paßwort ändern! Dabei keine geheimen - wohl aber sichere Paßwörter verwenden, da die Site derzeit keine SSL-Verschlüsslung besitzt!
- Die Zeitzone sollte eingestellt werden, da hier allem im GMT Format gespeichert wird.
- 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:
- Name der neuen Site Suchen und dann den Link neu erstellen nutzen
- In der URI nach
index.php/den neuen Seitennamen eingeben und dann bearbeiten - 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
KissDocdie Homepage der Dokumentation selbst. Die meisten Sites, welche unter dieser Kategorie existieren, setzt das Wiki schon von der Installation her voraus:- Willkommen (Unser offizielles Inhaltsverzeichnis)
- Über_KissDoc (Team)
- Hilfe (Kurze Hilfelinks für die dauerhafte Nutzung)
- Erste Schritte (diese Seite)
- Editierhilfe (reine Syntaxhilfe)
- Suche (Hilfe zur Suche)
- Administratoren (Wartungsinfos)
- Leitlinien (Richtlinien für Schreiberlinge)
- Urheberrechte
- Lizenzbestimmungen
- Copyright (wird im Upload-Dialog angezeigt)
- Vorlagen (erstellt)
- Dreafts ist eine Hilfsseite, welche von einer Vorlage verwendet wird und unfertige Seiten listet (erstellt)
- 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.

