SlideShow

Erste Schritte mit einem MoinMoin-Wiki

FrOSCon Beitrag der PyCologne Usergroup

MoinMoin Wiki Installieren und Anwenden

Reimar.Bauer@pycologne.de

MoinMoin

MoinMoin ist eine Wiki-Software, welche in Python geschrieben ist. Derzeit wird an der Version 2.0 entwickelt. -- auf der Homepage (http://moinmo.in) können Sie Aktuelles zum Entwicklungsstand erfahren. MoinMoin ist Freie Software (Open Source Software) unter der GNU General Public License.

Alles zu moin2 ist auf http://moinmo.in/MoinMoin2.0 beschrieben

Download

• http://moinmo.in/

  • http://moinmo.in/MoinMoinDownload

    • http://static.moinmo.in/files/moin-1.9.4.tar.gz

      • mkdir FrOSCon; cd FrOSCon; wget http://static.moinmo.in/files/moin-1.9.4.tar.gz

• md5sum moin-1.9.4.tar.gz
  • (f274a47042abeb17df6b0abb2948e896 moin-1.9.4.tar.gz)
• tar zxvf moin-1.9.4.tar.gz

Anleitungen / docs

• cd moin-1.9.4
  • ls
• cd docs
  • ls
    • firefox INSTALL.html

standalone wiki auf localhost

• cd FrOSCon/moin-1.9.4
  • ./wikiserver.py

  • firefox http://localhost:8080/LanguageSetup

    • User einrichten
      • Anmelden

        • http://localhost:8080/LanguageSetup?action=language_setup

          • Hilfeseiten, Systemseiten installieren
            • wikiserver neustarten
• wikiserverconfig.py anpassen

Eine Wiki Instanz

Eine Wiki Instanz besteht aus einem server adaptor (wikiserver.py, moin.wsgi, ...), dem Konfigurations script (wikiconfig.py) und den beiden Verzeichnissen data (Daten des Wikis) und underlay (Systemseiten).

├── data
│   ├── cache
│   ├── dict
│   ├── edit-log
│   ├── event-log
│   ├── intermap.txt
│   ├── meta
│   ├── pages
│   ├── plugin
│   └── user
├── underlay
│   └── pages
└── wikiconfig.py

Beispiel Webserver Setup apache (Expert)

• Software installieren

  • pip install http://static.moinmo.in/files/moin-1.9.4.tar.gz

• Ablage der Instanz Anlegen
  • mkdir -p /srv/moin/FrOSCon/
• wiki-user user ID anlegen
  • sudo useradd -m wiki-froscon
  • chown wiki-froscon.wiki-froscon /srv/moin/FrOSCon/
  • sudo su wiki-froscon
• Adaptor Script auswählen
  • cp /usr/local/share/moin/wiki/server/moin.wsgi /home/wiki-froscon
• Instanz (data, underlay, wikiconfig.py) anlegen
  • cp -r /usr/local/share/moin/wiki/data /srv/moin/FrOSCon
  • cp -r /usr/local/share/moin/wiki/underlay /srv/moin/FrOSCon
  • cp -r /usr/local/share/moin/wiki/config/wikiconfig.py /srv/moin/FrOSCon
• wsgi Skript editieren, Pfad der Instanz bekanntgeben
  • sed -i "s|#sys.path.insert(0, '/path/to/wikiconfigdir')|sys.path.insert(0, '/srv/moin/FrOSCon')|g" /home/wiki-froscon/moin.wsgi
• exit (su root)

• head -n 15 moin.wsgi | tail -n 10 > /etc/apache2/sites-available/wiki-froscon

  • Ausarbeiten Beispiel: wiki-froscon.txt

• a2dissite default
• a2ensite wiki-froscon
• service apache2 restart

• http://localhost

Wiki Konfigurieren, wikiconfig

• HelpOnConfiguration

• HelpOnSpam

• HelpOnXMLRPC (ReimarBauer/xmlrpc)

Aufbau einer Wiki Seite

besteht auf dem Datenträger aus einer Vielzahl von Dateien / Verzeichnissen. Die einzelnen Versionen einer Seite findet man z.B. unter pages/Workshop/revisions

pages
└── Workshop
    ├── attachments
    ├── cache
    ├── current
    ├── edit-log
    └── revisions
        ├── 00000001
        ├── 00000002
        └── 00000003

Commandline Tools

• Eine Datei auf dem Wiki als Seite ablegen

  MoinMoin/script/moin.py --config-dir=`pwd` import wikipage --page Example --file Example
  # moin --config-dir=`dir of wikiconfig.py` import wikipage --page Example --file Example

• siehe HelpOnMoinCommand

Arbeiten mit dem Wiki

• edit

• content

• raw

• WikiKurs, WikiCourse

• WikiSandBox

• HelpOnAccessControlLists

• HelpOnProcessingInstructions

• HelpOnActions/AttachFile

• Das "Weitere Aktionen" Menue

Erweiterungen

• MoinAPI/Beispiele

Und Mehr

• Besuchen Sie uns z.B. auf #moin irc.freenode.net

• http://moinmo.in

  • http://moinmo.in/Support