Inhaltsverzeichnis |
Wer sich für den Quelltext des WollMux interessiert oder den WollMux selber compilieren will (um z.B. derzeit in Entwicklung befindliche Features des WollMux auszuprobieren), findet die aktuellste Version des Source Codes stets in unserem öffentlichen Mercurial Repository.
Das Repository wird derzeit bei Google Code gehostet - die URL des zugehörigen WollMux-Projekts ist http://code.google.com/p/wollmux/.
Über die Website des Projekts kann sehr einfach im Source Code gebrowst werden und es sind übersichtlich alle Commit Logs und die damit verbundenen Quelltextänderungen zu sehen.
Es gibt verschiedene Tools, mit denen Sie den Quelltext aus unserem Mercurial Repository auschecken können (z.B. TortoiseHg). Diese Anleitung beschränkt sich auf das einfache Kommandozeilentool "hg". Die folgenden Kommandos sollten sowohl unter Linux als auch unter Windows funktionieren. Voraussetzung ist natürlich, dass hg installiert und im Pfad ist (mehr zu Mercurial erfahren Sie im Unterabschnitt "Mercurial - Was ist das?").
Wechseln Sie in der Kommandozeile zunächst in den Dateiordner, in den Sie den WollMux-Quelltext auschecken wollen. Dann rufen Sie folgendes Kommando auf:
hg clone https://wollmux.googlecode.com/hg/ WollMux
Durch dieses Kommando wird ein neuer Unterordner namens "WollMux" angelegt, in dem sich nach erfolgreichen Ausführen des Kommandos jetzt ein sogenannter Clone des WollMux-Repositories inkl. des aktuellen Stands des WollMux-Quelltextes befindet.
Mehr ist im Prinzip nicht zu tun. Um den so ausgecheckten Quelltext auf den aktuellen Stand zu bringen, wechseln Sie einfach in den "WollMux"-Ordner und führen den folgenden Kommandozeilenbefehl aus:
hg pull -u
Um den WollMux selber kompilieren zu können, benötigen Sie noch ein zusätzliches Projekt namens UNOHelper. Den Quelltext dieses Projekts können Sie genauso wie den Quelltext des WollMux auschecken.
Wechseln Sie in den Ordner, in dem sich auch ihr "WollMux"-Unterordner mit dem Clone des WollMux-Repositories befindet (es ist für den Build wichtig, dass "WollMux"-Ordner und "UNOHelper"-Ordner nebeneinander liegen) und führen Sie folgendes Kommando aus:
hg clone https://unohelper.googlecode.com/hg/ UNOHelper
Durch dieses Kommando wird ein neuer Unterordner namens "UNOHelper" angelegt (achten Sie auf die Kapitalisierung!), in dem sich jetzt ein Clone des UNOHelper-Repositories befindet. Um den UNOHelper-Clone auf den aktuellen Stand zu bringen, wechseln Sie einfach in den "UNOHelper"-Ordner und führen den folgenden Kommandozeilenbefehl aus:
hg pull -u
Als Versionsverwaltungssystem kommt beim WollMux-Projekt Mercurial (hg) zum Einsatz. Für diejenigen, die nur CVS oder Subversion (SVN) kennen, enthält Mercurial einige Fallstricke, da es sich um ein verteiltes Versionsverwaltungssystem handelt. Wer hingegen mit GIT vertraut ist, dürfte mit dem Prinzip von Mercurial wenig Schwierigkeiten haben. Wir können an dieser Stelle allerdings keine umfassene Einführung in die Verwendung von Mercurial geben, sondern verweisen an dieser Stelle einfach auf das umfangreiche Buch Mercurial: The Definitive Guide, das alles enthält, was man zu Mercurial wissen muss und komplett online lesbar ist.
Um einfach nur den WollMux Source Code auszuchecken langt es allerdings, wenn Sie es schaffen Mercurial auf ihrem System zu installieren und dann die Anweisungen im Unterabschnitt "Checkout des Quelltext aus dem Repository" befolgen. Eine Anleitung wie Sie Mercurial bei sich installieren, finden Sie ebenfalls im "Definitive Guide" unter http://hgbook.red-bean.com/read/a-tour-of-mercurial-the-basics.html.
Für Windows empfehlen wir die Verwendung von TortoiseHg (auch verfügbar für Linux), das eine einfache Oberfläche und Explorer-Integration anbietet, welche die Arbeit mit Mercurial sehr erleichtern kann. Mittlerweile wird auch von den meisten Entwicklungsumgebungen (wie z.B. Eclipse) eine gute Mercurial-Integration angeboten bzw. ist per Plugin nachrüstbar.
Wenn Sie den Quelltext von WollMux und UNOHelper ausgecheckt haben, können Sie theoretisch den WollMux selber bei sich bauen. Weitere Informationen hierzu finden Sie unter http://wollmux.googlecode.com/hg/doc/INSTALL (evtl. veraltet - bei Problemen einfach auf der Mailingliste fragen).
Nicht vergessen, dass der WollMux zum funktionieren auf jeden Fall auch noch eine Konfiguration benötigt. Eine Beispielkonfiguration befindet sich z.B. in unserem Download-Bereich.