Start presentation

Slide 1: GSI Wiki - eine Plattform zur kollaborativen Dokumentation

• Motivation
• Wiki
  • Grundlegende Funktionsweise
  • Implementationen
• Twiki
• GSI Installation
• Erweiterte Funktionen
• Ausblick

Slide 2: Wiki? - Wofür?

Dokumentation der Linux-Farm im Dezember 2002:

# ll $GSIROOT/Docs/GSI/gsimgr
*total 0*
...
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi-set_activ_check.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi-set_shutdown.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_acct.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_binmnt.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_call.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_change_new_fs.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_check_host.pl.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_control.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_cpu_mon.sh.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_cpu_mon.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_cpuanalyse.txt
-rw-r--r--    1 root     root            *0* Nov 22  2001 gsi_daily_refresh.txt
...

Wunschvorstellung: vollautomatischer Dokumentationsgenerator

Realistischer Anforderungen:

• Verknüpfung vieler kurzer Passagen durch Querverweise: Hypertext!
• Zentral, überall verfügbar und durchsuchbar: WWW!
• Kollaborativ?

Slide 3: Wiki? - Wofür?

Dokumentation, 1. Versuch

• Lesen und Bearbeiten mit unterschiedlichen Werkzeugen.
• Schlechte Verwaltung für Verweise.
• Lesbar für die Gruppe, schreibbar nur für mich.

• Zu unflexibel:
  • die Inhalte veralten schneller als sie geschrieben werden (können)

Slide 4: Wiki? - Was ist denn das?

• http://en.wikipedia.org/wiki/Wiki Wiki wiki: Haiwanischer Begriff für blitzschnell
• WikiWikiWeb ursrünglich entwickelt von Ward Cunningham:
  • Sammlungen von HTML-Seiten (Topics)
  • Quick'n'dirty in-place editing: [Edit this topic]
  • Vereinfachte Textauszeichnung:
    • ---++ Überschrift zweiter Ordnung
    • *fetter Text*
  • Automatische Verlinkung durch WikiWords (CamelCase, Binnengroßschreibung):
    • TopicDasNochNichtExistiert, ExistierendesTopic

• einfach
• offen
• inkrementell
• organisch

• Ein Geek-Tool?
• Chaotisch?

Slide 5: Wiki - Funktioniert das?

• Wikipedia: Eine freie Enzyklopädie
  • 2001 ins Leben gerufen
  • Verfügbar in über 100 Sprachen
    • davon 57 mit mehr als 1000 Artikeln
  • 1,3 Millionen Artikel
    • davon über 400000 auf Englisch
    • über 200000 auf Deutsch
  • Schwester-Wikis:
    • Wiktionary: Wörterbuch
    • WikiNews: Nachrichtenportal
    • WikiTravel: Reiseführer

Slide 6: Wiki! - Welcher?

Über 200 OpenSource Wiki Implementationen:

MediaWiki

Die Engine hinter Wikipedia, implementiert in PHP mit einem MySql-Backend.

TikiWiki

Fortentwickelt zum all inclusive CMS (Fotogallerien, WebMail usw.)

MoinMoin

Ein Python-Wiki

http://kwiki.org/ KWiki

Eine einfache Perl-Implementation mit eingeschränkten Fähigkeiten

UseModWiki

Ein Perl-Wiki

ChikiWiki

Ein Wiki auf Basis von Java http://struts.apache.org/ Struts, mittlerweile wenig Aktivität.

EclipseWiki

Ein persönlicher Wiki als Plugin für die Eclipse-IDE.

jotspot

Ein kommerzieller Wiki (beta) mit WYSIWYG-Editor und Email-Gateway

Slide 7: TWiki - Wieso?

TWiki: Ein Wiki mit Intranet- und Unternehmens-Fokus

• Integrierte Zugriffskontrolle:
  • ALLOWTOPICCHANGE, ALLOWEBVIEW
• Attachments
• Neueste Änderungen auflisten (WebChanges)
  • RSS Syndication (WebRss)
  • Email-Benachrichtigung (WebNotify)
• Versionskontrolle und Änderungshistorie
• Hunderte von Plugins und AddOns
• Implementation in Perl aufbauend auf dem UNIX-Baukasten:
  • Datei-basiert
  • Versionskontrolle per RCS
  • Suche per grep

• twiki.org: Auf Platz 15 der größten Wikis nach Artikelanzahl
• Im Einsatz bei BT, Disney, Motorola, SAP, Wind River, Yahoo, ...

Slide 8: GSI Wiki

URL: https://wiki.gsi.de/

Installation im September 2003

Bestehende Webs: Aikido, CRY_EXP, CSframework, ControlsCollaboration, DABC, EPS, ESR_EXP, Epics, FAIRcontrols, FIRST, FRS, Grid, IKBestX, ITInfo, ITRedakteure, Linux, NIUser, OpenScience, PHDStudents, PLinacBD, Personalpages, ROOT, Research, SCM, SIS100BD, STF, TOS, TOS.BunchBucket, TOS.Timing, Tasca, z. T. zugriffsbeschränkt

Gruppen:

• Benutzerverwaltung:
  • Die Benutzer können sich selbst registrieren
  • Gruppenmitglieder können andere Benutzer in die Gruppe aufnehmen.
• Lesezugriff = Schreibzugriff
• Email-Benachrichtigung (WebNotify): 2 mal täglich pro Web
• Tägliches Backup auf Dateisystem-Ebene (TSM)

Slide 9: Erweiterte Verwendung

• InterwikiPlugin: Abkürzungen für externe URLs
  • GSI-Gerätedatenbank: GsiDbDetail:lxfs
  • Man pages: rcsintro
• TWiki:Plugins/BeautifierPlugin zum Pretty Printing von Code:

%<nop>CODE{"bash"}% if [ $XYZ ]; then echo bla; else echo blubb; fi %<nop>ENDCODE%

if [ $XYZ ]; then echo bla; else echo blubb; fi 

• System.Macros: %SEARCH{"text"}%, %TOC%, ...
• TemplateTopics

Beispiel: ServerList

• SlideShowPlugin

Slide 10: Erweiterte Verwendung

• TWiki:Plugins/TWikiDrawPlugin: %DRAWING{"sample"}%
• CommentPlugin:

  Commenting is disabled while not logged in

• DataForms, MetaData

Slide 11: GSI Wiki

Your browser does not interpret the <applet> tag.

This page does not support <object> or <embed> at the moment.

Slide 12: Fazit

• Innerhalb der Linux-Gruppe etabliert und konkurrenzlos.
• Zunehmende Verwendung durch andere (DVEE-)Teams: Oracle, Grid, Operating, Security, Hades DAQ, ...
• Langfristig Chefredakteure und ständige Revision der Inhalte unvermeidbar.

Slide 13: Roadmap

• Umzug auf Produktions-Hardware
• Upgrade auf das aktuelle Release:
  • Checkpoints, direktes Speichern
  • Usability
  • Bugfixes

• www-linux wikifizieren.

• Usability verbessern
  • WYSIWYG-Editor
  • Session-Management
  • Benachrichtigungen (Email, Instant Messaging?)
  • Daten-Im- und Export (HTML, PDF, MS Office)
  • Suchindex statt grep

Slide 14: Roadmap

• Performance verbessern
  • mod_perl einsetzen
  • Caching der gerenderten Seiten

• Virtuelle Wikis?
  • Gemeinsame Installation mit getrennten Datenbereichen
  • Saubere(?) Trennung von Programmlogik und Daten

• TWiki:Codev/TWikiApplications
  • System-Benachrichtigungen, Portal

---

Präsentation auf Basis von SlideShowPlugin. Vorlage: ChristosSlideTemplate

Dieses Topic ist schreibgeschützt aber öffentlich:

• Set ALLOWTOPICCHANGE = Christo
• Set ALLOWTOPICVIEW = *

Über Feedback freue ich mich sehr.

Quellen und weiterführende Links

• FoswikTodo: die GSI Wiki Todo-Liste

• System.org:
  • TWiki:Codev/TWikiAdvocacy01Sep2004
  • TWiki:Main/TWikiSuccessStories
  • TWiki:Plugin/PluginPackage
  • TWiki:Plugin/AddOnPackage
  • TWiki:Codev/MsOfficeIntegration
  • TWiki:Codev/SharePointVsTWiki
  • TWiki:Plugins/DatabaseAddOn
  • TWiki:Codev/TWikiNewsPortal

• Wikipedia:Wiki
• Wiki:WikiWikiWeb
• Wiki:WikiEngines
• http://www.onlamp.com/pub/a/onlamp/2004/11/04/which_wiki.html
• http://www.infoworld.com/article/04/12/30/01FEtoycollab_1.html InfoWorld: Year of the enterprise Wiki

-- Christo, Februar 2005