Wiki-Nutzungshinweise
Navigation im Wiki
Die Navigation im Wiki ist gewöhnungsbedürftig, aber sehr angenehm. Ausgangspunkt wird meist die Startseite sein. Egal wo ihr euch im Wiki befindet. Oben rechts steht immer der Titel („PS Merkmalmodellierung“). Wenn ihr darauf klickt gelangt ihr immer zur Startseite.
Darüber hinaus bietet das Wiki so genannte Backlinks. Ihr könnt euch also auch jederzeit anzeigen lassen, von welcher Seite auf die aktuelle Seite verlinkt wird. Hierzu müsst ihr einfach nur auf den Titel der aktuellen Seite klicken, den ihr oben links seht (hier: ps-wiki-nutzungshinweise).
Übersicht aller Wikiseiten
In der Fußzeile gibt es neben dem Anmelden/Abmelden Button einen weiteren Button Übersicht. Damit werden alle verfügbaren Wikiseiten angezeigt.
Suchen im Wiki
Unterhalb des Wiki-Titels oben rechts befindet sich ein Suchfeld, dass zur Volltextsuche innerhalb des Wikis verwendet werden kann.
Wikiseiten erstellen und bearbeiten
Die Bearbeitung ist denkbar einfach. Unter jeder Seite findet ihr einen Button „Diese Seite Bearbeiten“. Wollt ihr eine neue Seite erstellen, so legt einfach einen internen Link zur neuen Seite an und gebt ihr einen sinnvollen Namen. Wenn ihr die aktuelle Bearbeitung wieder betrachtet, seht ihr den neuen Link in Rot dargestellt. Das Wiki erkennt also, dass der Link ins Leere führt. Wenn ihr darauf klickt, werdet ihr gefragt, ob ihr die Seite anlegen wollt. Fertig.
Zum Wiki gibt es einen RSS Feed, in dem jede geänderte Seite eingetragen wird. Damit nicht jede noch so kleine Änderung (z.B. Rechtschreibung korrigiert) zu einem Eintrag im Feed führt, gibt es im Bearbeitenmodus die Checkbox „kleine Änderung“.
Wiki-Syntax
Sobald eine Seite zum Bearbeiten geöffnet wird, ist oberhalb des Editors ein Link zur Wiki-Syntax zu finden. Darüber hinaus lässt sich das Wiki um Plugins erweitern, die ggf. weitere Syntaxelemente mitbringen. Aktuell ist ein Plugin zur Auszeichnung von mathematischen Formeln installiert: Formelsyntax
Namespaces
Das Wiki kennt Namespaces, die es ermöglichen eine gewisse Struktur zu erstellen und die Vergabe von Berechtigungen erleichtern. Ob sich eine Seite innerhalb eines Namespace (!= root) befindet, erkennt man am Namen der Seite. Dieser steht oben links und ist nach der Notation Namespace:Seitenname aufgebaut. Ist nur ein Seitenname angegeben, befindet man sich im Wurzelpfad.
Folgende Namespaces sind bislang definiert:
| Name | Rolle | mgl. Themen |
|---|---|---|
| Admin | Admin | Infrastruktur (Hardware, Systemsoftware, Anwendungssoftware) für die Entwicklung und das Unternehmen, Monitoring |
| Algorithmen | Fachabteilungen, Informatiker | inhaltliche Abläufe / mathem. Lösungen häufig anzutreffender Probleme: Standardalgorithmen, OR, Finanzen, Statistik, Marketing |
| Development | Entwickler, Grafikdesigner | Programmiersprachen, Frameworks, IDEs, Best-Practices, APIs, Refactoring, Coding Standards, Testing, Debugging, SQL, XML, SOAP, Entwurfsmuster, MVC |
| Modellierung | Softwarearchitekt, Prozessoptimierer | UML, Systemarchitektur, Geschäftsprozessmodellierung, BPMN, Metasprachen, modellgetriebene Entwicklung |
| Orga | CIO, Projektmanager | Anforderungsmanagement, Projektmanagement, Unternehmenskultur |
Wikiseiten Verlinken
Um auf andere Wikiseiten zu verlinken, genügt es den Namen der Seite in doppelte eckige Klammern zu schreiben. Soll ein anderer Text als der Name für den Link angezeigt werden, so muss die Zielseite gefolgt von einer Pipe (|) und dem anzuzeigenden Namen angegeben werden.
[[Seitenname | angezeigter Name]]
Verlinkung mit Namespaces
aktuelle und Zielseite im gleichen Namespace: Angabe des Seitennamen genügt
[[Seitenname]]
Zielseite befindet sich im „root“ Namespace (z.B. diese Hilfe Seite), so muss dem Ziel ein Doppelpunkt vorangestellt werden
Seitenname
Befindet sich die Zielseite im übergeordneten Namespace, so kann dies mit zwei Punkten kenntlich gemacht werden
[[..Seitenname]]
Interwiki Links
Links in andere Wikis können mit vereinfachter Syntax (ohne http…) gesetzt werden, wenn das andere Wiki mit einem Shortcut bekannt ist.
Die gleiche Vorgehensweise kann zudem auch für andere (nicht-Wiki) Websites definiert werden. Derzeit können die folgenden Interwiki Links genutzt werden:
[[wpde>Seitenname]] - Deutsche Wikipedia [[wp>Seitenname]] - Englische Wikipedia [[g>Suchbegriff]] - Google.de Suche [[xn>Mitgliedsname]] - Xing Profil [[wong>Tag]] - Seiten bei Mister Wong zum Tag [[SteRe>Tag]] - Von Stefan gespeicherte Seiten zum Tag bei Mr. Wong
Tags
Alle Seiten lassen sich mit Stichworten, Tags, versehen. Die Seitenvorlage enthält bereits die entsprechende Zeile, ansonsten können Tags mit folgendem Wikicode eingefügt werden:
{{tag>tag1 tag2}}
Aus den so definierten Tags wird auf der Startseite eine Tagcloud zusammengebaut.
Wollt ihr auf Seiten zu einem bestimmten Thema verlinken - also zu allen Seiten mit einem bestimmten Tag, nutzt bitte
{{topic>tag}}
Dabei könnt ihr die Anzeige zusätzlich erweitern bzw. einschränken:
{{topic>tag1 -tag2}}– Zeigt alle Seiten, die mit tag1 aber nicht tag2 markiert sind{{topic>tag1 +tag2}}– Zeigt alle Seiten, die mit tag1 und tag2 markiert sind{{topic>tag1 tag2}}– Zeigt alle Seiten, die mit tag1 oder tag2 markiert sind
Dateien verlinken
Sollen Dateien (z.B. Softwareentwurf) verlinkt werden, müssen diese zuvor ins Wiki eingespielt werden. Dies kann per FTP im Verzeichnis Media\Dok erfolgen, oder durch Verwendung des Assistenten „Bilder und andere Dateien einfügen“. Die Verlinkung im Wiki erfolgt mittels doppelten geschweiften Klammern und einem, dem Dateinamen, vorangestellten „dok“. Beispiel:
{{dok:name.pdf|Angezeigter Name}}
Dateien sollten nur Kleinbuchstaben enthalten.
Bilder
Bilder werden vom Wiki wie Dateien behandelt und demnach ebenfalls mit doppelten geschweiften Klammer verlinkt. Dabei sucht das Wiki zuerst im gleichen Namespace nach einer passenden Datei. Es genügt demnach nur den Dateinamen anzugeben. Eine Namespaceangabe ist nur erforderlich, wenn die Grenzen des eigenen Namespace überschritten werden sollen.
{{bildtitel.jpg|Angezeigter Titel}}
Wie auch bei sonstigen Dateien gilt, dass die Dateinamen ausschließlich aus Kleinbuchstaben bestehen!
Analog zu Links kann auch für Bilder ein alternativer Text eingegeben werden. Dieser wird angezeigt, sobald man die Maus über dem Bild positioniert (Tooltip) oder das Bild nicht gefunden wird. Auch hier gilt, dass der Alternative text durch einen senkrechten Strich vom Link getrennt wird.
Ausrichtung
Bilder können sowohl links- und rechtsbündig, sowie zentriert dargestellt werden. Standardeinstellung ist linksbündig. Um ein Bild rechtsbündig zu gestalten muss der Link um ein Leerzeichen zu beginn erweitert werden:
{{ bildtitel.jpg|Angezeigter Titel}}
Um ein Bild zu zentrieren muss das Leerzeichen vor und nach dem Bild eingegeben werden, wobei sich das nach auf die Stelle zwischen Dateierweiterung und dem senkrechten Stich bezieht.
{{ bildtitel.jpg | Angezeigter Titel}}
Ob nach dem senkrechten Strich weitere Leerzeichen folgen ist irrelevant.
Code Formatierung
Das Wiki unterstützt Syntax Highlighting für Quellcode, das durch Einfügen von <code> vor bzw. </code> nach dem entsprechenden Absatz aktiviert wird. Diese allgemeine Form kann noch auf die Hervorhebung bestimmter Sprachen angepasst werden. Dem entsprechend soll hier im Wiki die Syntax
<code java> </code> für Java Code und <code xml> </code> für XML Code verwendet werden.
Diskussionen
Für jede Seite kann separat eingestellt werden, ob ein Disskussionsbereich angeboten werden soll. Dabei sind folgende Einstellungen möglich:
~~DISCUSSION~~ // ermöglicht die Diskussion ~~DISCUSSION:off~~ // Es wird kein Diskussionbereich eingeblendet ~~DISCUSSION:closed~~ // Es können keine weiteren Beträge hinzugefügt werden, die bestehenden werden aber weiterhin angezeigt
Seiten Verschieben
Wenn Seiten im falschen Namespace angelegt wurden (z.B . Tippfehler) können diese Seiten mittels einem Plugin an die richtige Stelle verschoben werden. Dazu muss zunächst die Seite aufgerufen werden. Öffnet man nun den Admin-Bereich gibt es dort den Punkt Seite verschieben/umbenennen…. Dabei werden automatisch alle Links auf die Seite entsprechend angepasst. Seiteninterne Links und solche, die bislang ins Leere führen werden dabei jedoch nicht korrekt überführt - hier muss manuell nachgebessert werden.
Rechtschreibfehler-Korrektur
Für das Wiki kann ein Plugin installiert werden, dass eine Rechtschreibprüfung ermöglicht. Dafür ist jedoch neben der reinen Installation auch ein Eingriff in die Wiki Programmierung notwendig. Zudem ist nicht gesichert, ob und wie diese Änderungen für die Abgabe weitergegeben werden können. Daher bleibt als Alternative das Firefox Add-On Deutsches Wörterbuch.
Letzte Änderungen sehen
Wenn ihr wissen wollt, welche Seiten zuletzt geändert wurden, genügt ein Klick auf die Schaltfläche „Letzte Änderungen“ oben rechts. Es ist ebenfalls möglich einen RSS Feed zum Wiki zu abonnieren.
Hinweis für Firefox: Wenn ihr den Feed als dynamisches Lesezeichen ablegt, kann Firefox dieses nicht aktualisieren solange ihr das Wiki in der laufenden Sitzung noch nicht aufgesucht habt. Dies hängt mit den Sicherheitseinstellungen zusammen.