Index

Inhaltsverzeichnis

  1. "Was ist ein Wiki?"-Fragen
    1. Was ist ein ''Wiki''?
    2. Was ist ein ''MoinMoin''?
    3. Wozu ist das gut?
    4. Was zeichnet ein Wiki aus?
    5. Wie verhält sich Wiki im Vergleich zu anderen Kollaborations-Werkzeugen, wie z.B. Notes?
    6. Wie steht's mit der Wiki-Security? Werden Wikis nicht von Saboteuren heimgesucht, die Seiten löschen oder sonstigen Unfug treiben?
  2. Fragen zur Benutzung dieses Wikis
    1. Finden von und Zugreifen auf Informationen im Wiki
      1. Wie kann ich das Wiki durchsuchen?
      2. Wie sehe ich, was sich im Wiki in letzter Zeit getan hat?
      3. Was hat es mit diesen KomischenRotenLinks auf sich, die ich überall gesehen habe?
    2. Hinzufügen von Informationen in das Wiki
      1. Wie fügt man etwas in's Wiki hinzu oder ändert etwas, was falsch ist?
      2. Gibt es Konventionen, denen ich folgen sollte, wenn ich Informationen hinzufüge?
      3. Wie kann ich nicht-textuelle Informationen zum Wiki hinzufügen?
      4. Wie füge ich ein Bild einer Seite hinzu?
      5. Hinzufügen von Dokumenten im Intranet
      6. Soll ich meine Änderungen ''unterschreiben''?
    3. Andere Dokumentenformate dem Wiki hinzufügen
      1. Kann ich HTML dem Wiki hinzufügen?
  3. Installation & Konfiguration
    1. Wieso tun die "diff"s nicht?
    2. Wie aktiviere ich die "DeletePage"-Option?
  4. Administrieren des Wiki
    1. Wie administriere ich das Wiki?
    2. Kann ich eine alte Version einer Seite wiederherstellen?
    3. Wie kann ich eine neue Schablonenseite anlegen?

"Was ist ein Wiki?"-Fragen

Was ist ein ''Wiki''?

Die Bezeichnung Wiki ist eine Abkürzung des Ausdrucks WikiWikiWeb. Ein Wiki ist eine Datenbank, in der Seiten gespeichert werden, die kollaborativ mit irgendeinem Web-Browser editiert werden können.

Was ist ein ''MoinMoin''?

Ein MoinMoin ist ein Wiki, das vom Python-Wiki-Programm "MoinMoin" zur Verfügung gestellt wird.

Wozu ist das gut?

Um ehrlich zu sein, es ist überall gut, wo Sie vorhaben, es einzusetzen. Bei Lineo haben wir ein Wiki in unserer internen Website eingerichtet. In diesem Wiki gibt es zahlreiche Seiten, die unsere verschiedenen Projekte, Architekturen, Ideen, etc. beschreiben, und es erlauben, dass andere Leute ihre Kommentare dazu abgeben. Manche Seiten stehen herum und geben Informationen her. Andere enthalten eine Einladung zur offenen Diskussion und fordern die Benutzer dazu auf, ihre Meinung zu sagen. Wir haben sogar ein Wiki für eine einfache Skills-Datenbank eingerichtet.

Generell ist ein Wiki ein Freiform-Werkzeug, dessen Wert aus dem Zweck kommt, zu dem es eingesetzt wird. Zum Beispiel kann ein Wiki die selbe Aufgabe erfüllen, wie ein Diskussionsfaden. Sie könnten eine Wiki-Seite benutzen, um kollaborativ an einem Projekt zu arbeiten.

Wikis werden intern von den Leuten eingesetzt, die Zope machen, um ihre Ideen und Projekte zu koordinieren.

Was zeichnet ein Wiki aus?

Hier haben wir ein paar wichtige Eigenschaften von Wikis gesammelt:

  • Editierbar durch jeden - eine Wiki-Seite kann von jedem, der einen Web-Browser bedienen kann, editiert werden.

  • Die Möglichkeit, AktuelleÄnderungen anzusehen

  • Die Möglichkeit, auf verschiedenste Arten nach Seiten zu suchen.
  • Die Möglichkeit, neue Seiten sehr einfach einzufügen.
  • Die Möglichkeit, die Versionshistorie einer Seite zu betrachten
  • Die Möglichkeit, neue Information hinzuzufügen oder bestehende Informationen zu verändern.

Wie verhält sich Wiki im Vergleich zu anderen Kollaborations-Werkzeugen, wie z.B. Notes?

Mit einem Wiki kann man verschiedene Aufgaben sehr einfach erledigen, wohingegen andere Aufgaben nicht so einfach oder gar nicht realisierbar sind. Das größte fehlende Feature ist irgendeine Art der Zugriffskontrolle, um nur bestimmten Gruppen zu erlauben, Information zu betrachten und zu verändern.

Wie steht's mit der Wiki-Security? Werden Wikis nicht von Saboteuren heimgesucht, die Seiten löschen oder sonstigen Unfug treiben?

Dies ist eine wichtige Frage. Generell bieten Wikis KEINE Sicherheit. (Das ist wahr!) Deswegen besteht die Möglichkeit, dass zufällig oder bewusst ein Teil des Wikis korrumpiert oder zerstört wird.

Es gibt zwei Wege, die es ermöglichen, ein Wiki wertlos zu machen. Der eine Weg ist das Löschen, der andere Weg ist das Stören der Daten. Mit gelöschten Seiten wird man einfach fertig, da die vorherigen Revisionen einer Seite an einem Ort aufgehoben werden, der einem Web-Benutzer nicht zugänglich ist. Sobald jemand eine gelöschte Seite bemerkt (was generell ziemlich schnell passiert), kann die alte, funktionierende Revision wieder eingespielt werden.

Mit absichtlicher Störung der Daten im Wiki ist etwas schwieriger fertig zu werden. Es ist möglich, dass jemand Falschinformation in eine Seite eingibt, oder Seiten derart editiert, dass sie Falschinformation enthalten (zum Beispiel kann man eine Seite editieren, und einen Kommentar so aussehen lassen, als ob jemand anders diesen Kommentar abgegeben hätte; oder jemand könnte den Inhalt eines Absatzes so ändern, dass die Aussage eine ganz andere ist, als die vom Autor beabsichtigte). So ziemlich jedes kollaborative System hat dieses Problem. In einem Wiki kann es nur einfacher ausgenützt werden, weil es in einem Wiki überhaupt keine Sicherheit gibt. In der Praxis ist die Zerstörung eines Wikis ein sehr seltenes Ereignis, und eines, das man sehr schnell und einfach wieder ausbügeln kann, und zwar mittels der sogenannten "Notification", einem Hinweis, der einem festgelegten Auditor geschickt wird, sobald sich etwas auf einer Seite ändert.

In anderen Worten, es ist die Philosophie eines Wikis, dass man händisch mit (selten auftretenden) Problemen fertig wird, anstatt mehr Features und Aufwand (in der Implementierung und der Benutzung gleichermaßen) in das Wiki aufzunehmen, um Schaden durch einen Saboteur zu verhindern.

Fragen zur Benutzung dieses Wikis

Finden von und Zugreifen auf Informationen im Wiki

Wie kann ich das Wiki durchsuchen?

Es gibt viele Wege, das Wiki zu durchsuchen:

  • Auf das Lupen-Icon klicken. Damit kommen Sie auf die SeiteFinden-Seite, wo Sie nach Sie nach Stichworten in Titeln, per Volltextsuche, mit normalen Worten oder mit Wildcards (regulären Ausdrücken) suchen können.

  • Klicken Sie auf TitelIndex. Dies zeigt Ihnen eine alphabetische Liste aller Seiten, nach Titel sortiert.

  • Klicken Sie auf WortIndex. Dies zeigt Ihnen eine alphabetische Liste von jedem Einzelwort in jedem Seitentitel (d.h. eine Seite namens BlueTooth ist sowohl unter B / Blue als auch unter T / Tooth aufgeführt).

  • Klicken Sie auf LikePages im Fußbereich der Seite. Dies zeigt Ihnen Seiten, die Worte in Ihren Titeln haben, die ähnlich zur aktuellen Seite sind.

  • Klicken Sie auf den Seitentitel im Kopfbereich der Seite. Dies zeigt Ihnen, welche Seiten auf die aktuelle Seite verweisen (was Ihnen hilft, verwandte Seiten zu finden).

Wie sehe ich, was sich im Wiki in letzter Zeit getan hat?

Klicken Sie auf den AktuelleÄnderungen-Link oben auf jeder Seite.

Jedes gemischt gross/klein-geschriebene Wort, zu dem keine Seite existiert, wird als roter Verweis angezeigt.

Hinzufügen von Informationen in das Wiki

Wie fügt man etwas in's Wiki hinzu oder ändert etwas, was falsch ist?

Wenn Sie etwas sehen, was Sie gerne kommentieren, wo sie etwas hinzufügen oder ändern würden, klicken Sie einfach auf den Editieren-Link unter jeder Seite oder klicken Sie auf das -Icon oben auf der Seite. Die Seite wird dann in einem Editierfeld Ihres Browsers angezeigt und Sie können die Änderung dann einfach machen. Der Wiki-Formatierer wird im allgemeinen "das Richtige tun" mit jeglichem Text, den Sie eingeben. Wenn Sie es hübsch machen wollen, können Sie ähnliche Arten von Formatierungen machen, wie es Ihnen auch HTML erlauben würde. Siehe die HilfeZumFormatieren-Seite für einige Tips und Beispiele.

Gibt es Konventionen, denen ich folgen sollte, wenn ich Informationen hinzufüge?

Nicht sehr viele. Es hilft, wenn man bestimmte Arten von Informationen auf konsistente Art formatiert. Eine wichtige Konvention ist die Verwendung von Schablonen-Seiten, um die Konsistenz zu wahren.

Im Wiki gibt es sog. "Schablonen", die angeboten werden, wenn Sie eine neue Seite erzeugen. Wenn Sie auf eine davon klicken, wenn Sie eine neue Seite anlegen, wird diese Seite eine Struktur ähnlich der anderen Seiten dieses Typs haben. Zum Beispiel können Sie, wenn Sie Ihre eigene Wiki-Homepage anlegen, die Schablone HomepageTemplate verwenden, die Ihnen beim Erzeugen angeboten wird.

Wie kann ich nicht-textuelle Informationen zum Wiki hinzufügen?

Wenn es diese Inhalte schon auf einer Webseite gibt, fügen Sie einfach einen Link hinzu zu der Wiki-Seite. Verfahren sie wie folgt:

  • stellen Sie die URL des Dokuments fest,

  • editieren Sie die Wiki-Seite (gehen Sie zu der Seite und klicken Sie auf den EditiereText-Link)

  • geben Sie die URL dort ein, wo sie auf der Seite stehen soll
  • speichern Sie die Änderungen.

Das Wiki wird dann automatisch einen Hypertext-Link aus der eingegebenen URL erzeugen.

Sie können den Verweis noch etwas hübscher machen, indem Sie einige beschreibende Wort für den Link in Klammern eingeben. Die beschreibenden Worte werden auf der Seite sichtbar sein, aber der Link wird den Benutzer zu der URL verweisen, sobald er darauf klickt. Ein Beispiel: 

  [http://www.ihreseite.de/wasauchimmer.html Dies wird der Link-Text sein]

ergibt:

Dies wird der Link-Text sein

Wie füge ich ein Bild einer Seite hinzu?

Sie können die URL einfach auf die Seite schreiben. Beispiel: 

http://c2.com/sig/inter/wikibase.gif

ergibt

http://c2.com/sig/inter/wikibase.gif

Hinzufügen von Dokumenten im Intranet

Wenn Sie MoinMoin in einem Intranet benutzen, kann es nützlich sein, Links zu erstellen auf Dokumente auf Dateifreigaben, die im Netz verfügbar sind. Zum Beispiel: 

[file://servername/voller/pfad/zur/datei.txt Klicken Sie hier um datei.txt zu lesen]

Sie können auch auf Dateien mit Leerzeichen im Dateinamen verweisen, indem Sie manuell die URL-Kodierung für Leerzeichen (%20): 

[file://servername/voller/pfad/zur/datei%20mit%20leerzeichen.txt Klicken Sie hier um datei mit leerzeichen.txt zu lesen  ]

Eine andere naheliegende Möglichkeit ist, die Aktion AttachFile zu verwenden, die in Version 0.11 hinzugekommen ist.

Soll ich meine Änderungen ''unterschreiben''?

Wenn sie signifikant sind oder wenn Sie wollen, dass bekannt wird, dass Sie sie gemacht haben, dann sollten Sie signieren. Hängen Sie einfach Ihren Namen oder Ihre email-Adresse hinter Ihren Kommentar an. Es ist nicht unüblich, Kommentare unterhalb des originalen Textes, den Sie kommentieren, einzurücken. Es hilft auch, eigene Kommentare kursiv zu schreiben, um Sie vom Haupt-Text abzuheben, den Sie kommentieren.

In einigen Fällen ist es aber auch angemessen, einfach anonym Änderungen zu machen. Rechtschreibkorrekturen, Formatierung, triviale Wortänderungen sind einige Beispiele, wo es nicht notwendig ist (und sogar unerwünscht ist), Änderungen zu signieren.

Andere Dokumentenformate dem Wiki hinzufügen

Kann ich HTML dem Wiki hinzufügen?

Wenn Sie eine einzelne Zeile HTML hinzufügen wollen, benutzen Sie das HTML-Makro. Übergeben Sie einfach Ihren HTML-Text als Parameter dem HTML-Makro, so wie hier:

[[HTML(<font size=+12>Dies ist ein grosser Font</font>)]]

Dies sieht dann auf der Seite so aus: HTML(<font size=+12>Dies ist ein grosser Font</font>)

Es ist auch möglich, ein HTML-Dokument auf eine Seite zu platzieren, indem Sie #format html als erste Zeile auf die Seite schreibe. Wenn diese Zeile vorhanden ist, wird die ganze Seite als HTML interpretiert (und dadurch werden auch Verweise auf andere Seiten etwas schwieriger!). Stellen Sie sicher, dass Sie nur den "body"-Anteil der Seite hinzufügen (nicht die HTML-Header oder etwas anderes ausserhalb des body, inklusive dem <BODY>-Tag selbst).

  • /!\ Dies alles funktioniert nur, wenn die HTML-Erweiterungen (HTML-Makro und -Parser) installiert sind.

Installation & Konfiguration

Wieso tun die "diff"s nicht?

Damit sog. "Diffs" (Differenzen) richtig arbeiten, sind 2 Dinge notwendig:

  • Das Verzeichnis "datadir/backup" muss existieren.

  • Sie benötigen ein "GNU diff"-Programm im PATH Ihres Webservers. Beachten Sie, dass der PATH Ihres Webserver viel kürzer sein kann als der PATH, den Sie von Ihrer Shell gewohnt sind.

Wie aktiviere ich die "DeletePage"-Option?

"DeletePage" ist nicht standardmäßig aktiviert, da es meist nur in Intranets benutzt wird und in öffentlichen Wikis etwas gefährlich ist. Um diese und andere gefährliche Aktionen zu erlauben, fügen Sie sie wie folgt hinzu zur moin_config.py: 

allowed_actions=['DeletePage']

Administrieren des Wiki

Wie administriere ich das Wiki?

Es gibt viele administrative Informationen auf der Seite AktuelleÄnderungen, mitunter die Anzahl der Seiten, sowie die installierten Makros und Aktionen.

Ich erstelle üblicherweise eine "AdminSeite", wo ich Makros für dieselben hineinstelle, wie auch Informationen über den wahren physikalischen Speicherort der Seiten und Makros für VerwaisteSeiten und andere und andere Dinge, die sich ein Administrator möglicherweise ansehen will.

Kann ich eine alte Version einer Seite wiederherstellen?

Nicht direkt. Es ist einfach zu machen (wenn Sie Berechtigungen dort haben, wo die eigentlichen Wiki-Daten gespeichert werden. Normalerweise müssen Sie den Wiki-Administrator fragen, damit er die Seite für Sie wiederherstellt. Dies wird als Schutz getan gegen den unwahrscheinlichen Fall, dass jemand versucht, das Wiki zu sabotieren.

Für Leute, die diese Hilfeseite lesen (was vermutlich der durchschnittliche Angreifer nicht tut), gibt es eine Methode, eine Seite wiederherzustellen:

  1. klicken Sie auf das kleine "i" oben rechts in der Ecke (PageInfo).

  2. klicken Sie auf "anzeigen" bei der Version, die Sie wieder herstellen wollen.
  3. ersetzen Sie in der URL-Zeile Ihres Browsers "action=recall" durch "action=raw".

  4. übernehmen Sie mit Cut&paste den Text in das Editierfeld dieser Seite, nachdem Sie auf "Editieren" geklickt haben.

Wie kann ich eine neue Schablonenseite anlegen?

Schablonen sind Seiten, die automatisch zur Auswahl angeboten werden, wenn man eine neue Seite anlegt. Jede Seite, die mit dem Wort "Template" aufhört, wird automatisch in dieser Liste angezeigt. Wenn Sie also gewisse Typen von Seiten in einem ähnlichen Format haben wollen (ähnliche Überschriften, Seitenaufbau, etc.), definieren Sie einfach eine Seite, die auf "Template" endet - und wenn Sie Seiten dieses Typs generieren, wählen Sie diese Schablone und editieren sie. Das Wiki füllt dann den anfänglichen Inhalt für Sie ein. Schablonen ("Templates") sind editierbare Wiki-Seiten wie jede andere auch.

Um eine Schablonenseite anzulegen, erzeugen Sie einfach eine neue Seite namens <Irgendwas>Template