Wiki auf Gitlab benutzen March 11th, 2020
Ich habe gerade ein Projekt mit anderen Entwicklern, wo wir uns das ERPNext Projekt näher anschauen wollen.
Ich wollte nicht extra eine eigene MediaWiki Instanz aufsetzen, die ich dann auch mit Updates pflegen muss.
Weil ich sowieso eine GitLab Instanz laufen habe, haben wir dort ein Projekt eingerichtet, um den Wiki zu benutzen.
Jetzt fällt mir aber auf, dass es keine Diff Funktion im Wiki von GitLab gibt! Hier ist das entsprechende Ticket dazu: https://gitlab.com/gitlab-org/gitlab-foss/-/issues/17906
Der Workaround, der vorgeschlagen wird, ist auf der jeweiligen Wiki Seite unter dem Link rechts oben, “Clone Repository”, zu finden. z.B. hier: https://gitlab.com/cryptsetup/cryptsetup/-/wikis/home. Der Link verweist dann auf https://gitlab.com/cryptsetup/cryptsetup/-/wikis/git_access
(Ich benutze das Beispiel von cryptsetup, weil mein eigenes Projekt nicht öffentlich ist)
Auf Ubuntu, habe ich den Workaround so umgesetzt:
sudo apt-get install ruby ruby-dev sudo gem install gollum sudo gem install github-markdown git clone https://gitlab.com/cryptsetup/cryptsetup.wiki.git cd cryptsetup.wiki gollum |
Per Default, läuft die Seite nun unter http://localhost:4567, und man kann sich ganz einfach die Diffs zwischen den Version anschauen, unter History.
Man kann dort auch lokal editieren, muss dann auf der Kommandozeile einen git push ausführen, um es ins GitLab hochzuladen.
Die Änderungen der anderen Teilnehmer erhält man, indem man git pull auf der Kommandozeile ausführt.
Leider ist git pull/push nicht als Button in gollum vorgesehen: https://github.com/gollum/gollum/issues/112
Hier hat jemand es über git hooks und gollum Konfiguration umgesetzt: http://www.whiteboardcoder.com/2017/04/gollum-auto-sync-to-remote-git-repo.html