UseModWiki#

UseMod ist die Wiki-Engine, mit der das ursprüngliche Wiki der LUG-KR lief. Dort wurde die Version 1.0 eingesetzt.

Nähere Informationen zur UseModWiki-Engine gibts auf der UseModWiki-Homepage.

-- MarkusMonderkamp am 10.11.2006

Beweggründe zum Einsatz von UseModWiki von ThomasBayen:#

Was Einfaches: Warum hatte sich die
[LUG-Krefeld|http://lug-kr.sourceforge.net/cgi-bin/lugwiki.pl?HomePage] für das UseModWiki entschieden? 

Weil's das Beste unter Perl ist?  -
http://lug-kr.sourceforge.net/cgi-bin/lugwiki.pl?MichaelZacherl
/mz

;: Zu der Zeit waren die Unterschiede noch nicht ganz so gross.
Ausserdem ja - ich persönlich habe Perl bevorzugt. Der wichtigste
Grund war aber, daß ich bei UseModWiki relativ schnell eine
Installationsanleitung gefunden habe und das die Installation ein
Kinderspiel ist. Das Wiki besteht nur aus einer einzigen
Skript-Datei. Dann legst Du noch ein leeres Verzeichnis für die
Daten an und fertig!

;: Im Nachhinein war ich ab und zu schonmal neidisch, wenn ich
andere Klicki-Bunti-Wikis gesehen habe. Insbesondere Attachments
vermisse ich öfters. Andererseits ist UseModWiki sehr viel
übersichtlicher und absolut einfach zu bedienen und ist damit viel
besser von nicht-Computerfreaks zu bedienen. Wir haben hier im LAN
ein firmeninternes Wiki, das auch von Dummusern benutzt wird und da
ist einfache Erlernbarkeit wichtiger als die Möglichkeit, HTML
einzubinden.

;: Im UseMod:UseModWiki gibts übrigens auch eine Seite mit Patches.
Da gibts noch einiges, was man einbauen kann (Z.B. auch
Attachments). Aber so dringend wars mir bisher noch nicht, ich
warte da auf die nächste Version. -- ThomasBayen

;: ''Jahre später... :-)'' Inzwischen läuft hier die Version 1.0,
die alles kann, was ich mir immer schon gewünscht habe. Damit sind
die Nachteile behoben, die Vorteile einer leichten Einarbeitung und
Pflege sind jedoch nach wie vor noch gültig. -- ThomasBayen
----
=== Kurzer Satz zum Selberaufsetzen eines Wiki ===
Viele, die sich bis hierher durchgeklickt haben, möchten irgendwann
auch schrecklich gerne ein eigenes Wiki aufsetzen (daher so Fragen
wie oben die). Als Wiki-Maintainer der LUG Krefeld und mit 1,5
Jahren Wiki-Erfahrung ein Tip dazu: Tut es nicht. :-) Es gibt eine
Menge halb-verwaiste Ein-Mann-Wikis im Web, die kein Mensch braucht
und benutzt. Ein Wiki lebt nicht von der Software und demjenigen,
der das Wiki aufgesetzt hat, sondern von vielen Benutzern, die im
Wiki leben und es mit Leben füllen. Also unterstützt lieber ein
bestehendes Wiki wie dieses hier (oder LinuxWikiDe, das ich
empfehlen kann und in dem sich gerade eine größere Community
bildet), als das jeder für sich ein Privatwiki pflegt.

Der einzige Grund für ein Privatwiki kann sein, daß man wirklich
nur eigenes Wissen verwalten will. (Ich habe sowas z.B.firmenintern
in unserem LAN.) Auch das LUG-KR-Wiki hier sollte ursprünglich nur
als Wissensbasis dienen (siehe TipsUndTricks). Würden wir das heute
wieder anfangen, würden wir das wahrscheinlich direkt im
LinuxWikiDe machen. Das gab es damals noch nicht... -- ThomasBayen

: ''Die Frage stelle ich, wie von dir richtig vermutet, weil ich in
der Implementation eines Wikis einen Lösungsansatz für uns hier im
Büro (~70 Benutzer) sehe. Wir haben alles Mögliche probiert (bis
zum internen Newsserver) - aber uns ging immer eine lockere, aber
doch geführte Handhabung ab. Nun bin ich nicht sicher, ob das
Prinzip der (Selbst-)Disziplin (weil eben jeder alles kann, ausser
Admin) aufgehen würde, aber andererseits gibt's die History. Ich
selbst bin gerade am Kennenlernen und fühl mich eigentlich recht
wohl in dem Medium. -- MichaelZacherl''

:: Eben dafür ist es genial. Ich weiss nicht, was für Leute in
Eurer Firma damit arbeiten sollen. Computerfreaks haben, glaube
ich, lieber ein Wiki, wo sie alle Möglichkeiten haben (Attachments,
Tabellen, HTML einbinden, etc.). Ich habe hier bei uns in der Firma
(Getränkehandlung), wo die Leute im allgemeinen nichts mit
Computern am Hut haben (wollen), die Erfahrung gemacht, dass
UseModWiki sehr gut funktioniert, gerade weil es keine verwirrenden
Funktionen hat. Andererseits könnte man sowas wie MoinMoin auch
einfach machen, wenn man halt einfach die Doku der komplizierten
Dinge weglässt?!? -- ThomasBayen

::: ''Naja. 2/3 Computerfreaks würd ich sagen - vielleicht auch
schlimmer. Und die Hälfte Spezialisten ... ''
::: ''Wenn ich also MoinMoin verwenden würde, dann dürfte nie eines
der komplexeren Dinge auftauchen, dann wollens die anderen auch
machen (bzw. sie tun's eh, weil's den Sourcetext sehen können). Die
Vorbildwirkung find ich im Wiki aber nicht schlecht - dürfte sogar
recht stark ausgeprägt sein. Schein gut zu laufen so ... -
[http://lug-kr.sourceforge.net/cgi-bin/lugwiki.pl?MichaelZacherl
/mz] ''

----

= Installation des UseModWiki unter Debian =

Eigentlich geht die Sache ganz einfach. Wer 

 apt-get install usemod-wiki

eingibt, hat eigentlich schon alles, was er braucht (UseModWiki
Version 1.0 unter Debian Sarge). Unter
<pre>http://localhost/cgi-bin/wiki.pl</pre>  kann das
Wiki benutzt werden. Dennoch habe ich noch einige Verfeinerungen
vorgenommen, die ich hier aufführen möchte:

== Wie sieht die Einrichtung unter Debian aus? ==

Das Debian-Paket verlegt alle Dateien an Orte, die dem
Debian-Filesystem-Standard entsprechen. Dadurch wirds einerseits
etwas auseinandergezogen, andererseits aber auch eigentlich
logischer. Ich führe hier die wichtigsten Orte auf:

<pre>
  /usr/lib/cgi-bin/wiki.pl            - eigentliches Wiki-Skript -
muss eigentlich gar nicht bearbeitet werden
  /var/www/usemod-wiki/               - Hier sind Grafiken abgelegt
(das Logo oben rechts)
  /var/lib/usemod-wiki/               - Hier sind die eigentlichen
Wiki-Daten abgelegt
  /etc/usemod-wiki/                   - Hier liegt die config-Datei
und die intermap
</pre>

Um seine Installation nun anzupassen, muss man eigentlich erstmal
nur die Datei ''/etc/usemod-wiki/config'' ändern. Ich persönlich
habe dabei nur die ersten 5 Zeilen angepasst. (im Grunde kann man
aber auch gar nichts ändern...)

== Anpassungen ==

Wer die Upload-Funktion braucht, muss diese ggf. noch extra
einrichten. Wer möchte, kann $StyleSheet auf
"/usemod-wiki/wiki.css" setzen. Evtl. ist es auch sinnvoll,
AdminPass zu setzen. Dann kann ein User mit dem gleichen Passwort
z.B. Seiten löschen.

== deutsche Übersetzung ==

Auf UseMod:GermanTranslation kann man per Copy&Paste eine Datei
bekommen, die man nach ''/etc/usemod-wiki/german.pl'' schreibt.
Dann wird diese mit '''do "/etc/usemod-wiki/german.pl";''' am
Anfang der config-Datei eingebunden. Die Einstellung
'''<nowiki> "NonEnglish" </nowiki>''' sollte auf
'''"1"''' gestellt werden, damit auch Umlaute in Seitentiteln
akzeptiert werden. Oben bei den Konfigurationen sollte man noch
"RecentChanges" etc. eindeutschen.

Wer Texte eindeutscht (z.B. auch die Namen der HomePage und der
RecentChanges-Seiten), sollte auch die Variable
<nowiki>$HttpCharset</nowiki> auf "iso-8859-15" setzen.

== URL des Wiki ändern ==

Wenn man das Wiki in der URL besser verbergen will, kann man dazu
z.B. einen Befehl wie

<pre>
  ScriptAlias /wiki /usr/lib/cgi-bin/wiki.pl
</pre>

in die Datei ''/etc/apache/httpd.conf'' (für Apache 1.3) bzw.
''/etc/apache2/conf.d/usemod'' (für Apache 2.0) schreiben. Dann
kann man die einfachere URL benutzen.

Wer will, kann bei Apache 2.0 dann noch in
''/etc/apache2/sitzes-available/default'' die Zeile 

<pre>
  RedirectMatch ^/$ /wiki
</pre>

anpassen. Dann wird die Wiki-Hauptseite als Einstiegsseite des
Servers benutzt.

== Wartung und Pflege ==

... ist eigentlich gar nicht noetig. Hat man ein Wiki (wie wir) im
Internet auf einem öffentlichen Server stehen, ist es sinnvoll,
regelmäßig ein Backup zu machen (z.B. mit einem BackupScript).
Außerdem habe ich festgestellt, daß scheinbar sehr häufig Leute
ohne Not einen neuen Benutzer anlegen. Dies hat nach ca. 4,5 Jahren
zu einem User-Verzeichnis mit ca. 4.000 (zumeist leeren) Einträgen
geführt, die zusammen 16MB verbrauchen. Wen das stört, der kann
alle paar Jahre mit

 cd wiki/user
 rm -f `find -size -90c`

alle Dateien, die kleiner als 90 Bytes sind (und damit keine echten
Benutzerdaten beinhalten) löschen.

Die nächste Frage zum Thema Wartung kommt erst ca. 2010 auf uns zu,
wenn die Benutzerzahlen fünfstellig werden. Dann kann es vielleicht
sogar nötig sein, das Benutzerverzeichnis komplett zu löschen, dann
müssen sich alle Benutzer neu einloggen...

Ich hatte angefangen, die Beweggründe von Thomas an die JSPWiki-Syntax anzupassen, später jedoch den Text als ganzes in Block-Klammern gesetzt.

--MarkusMonderkamp, 10-Nov-2006