In Anlehnung an den französischen Blogeintrag von Wolverine will ich hier einmal auf deutsch erklären, wie man die Änderungen aus einem Dokuwiki mit Gource unter Ubuntu visualisiert.
Zunächst installiert man, sofern noch nicht vorhanden, Gource:
| Bash | | copy | | ? |
| 1 | sudo aptitude install gource |
Anschließend muss das folgende Python-Script in eine Datei verfrachtet werden und ausführbar gemacht werden. Es dient dazu die *.changes$-Dateien vom Dokuwiki in ein für Gource lesbares Format zu bringen.
| Python | | copy | | ? |
| 01 | #!/usr/bin/python |
| 02 | |
| 03 | """ |
| 04 | This program parse logs of a dokuwiki |
| 05 | and tranform them for gource (a log viewer) |
| 06 | http://code.google.com/p/gource/ |
| 07 | |
| 08 | developped by WolverineX02 |
| 09 | site : http://wolverinex02.blogspot.com |
| 10 | |
| 11 | """ |
| 12 | |
| 13 | import os.path |
| 14 | import getopt |
| 15 | import sys |
| 16 | import re |
| 17 | |
| 18 | |
| 19 | def listdirectory2(path): |
| 20 | """list all the files like *.changes, read them and output them in gource's log syntax |
| 21 | """ |
| 22 | for root, dirs, files in os.walk(path): |
| 23 | for i in files: |
| 24 | if (re.search('\.changes$', i)): |
| 25 | fichier = os.path.join(root, i) |
| 26 | myfile = open(fichier, 'r') |
| 27 | for line in myfile.readlines(): |
| 28 | mots = line.split() |
| 29 | if len(mots)>=5: |
| 30 | resultat = mots[0] + "|" |
| 31 | resultat += mots[4] + "|" |
| 32 | resultat += translate(mots[2]) + "|" |
| 33 | resultat += fichier |
| 34 | print resultat |
| 35 | elif len(mots)==4: |
| 36 | resultat = mots[0] + "|Anonymous|" |
| 37 | resultat += translate(mots[2]) + "|" |
| 38 | resultat += fichier |
| 39 | print resultat |
| 40 | myfile.close() |
| 41 | |
| 42 | def translate(mot): |
| 43 | """translate the dokuwiki vocabulary to the gource one |
| 44 | C -> A |
| 45 | E -> M |
| 46 | other -> M |
| 47 | """ |
| 48 | if mot == "C": |
| 49 | return "A" |
| 50 | elif mot == "E": |
| 51 | return "M" |
| 52 | else: |
| 53 | return "M" |
| 54 | |
| 55 | def main(argv): |
| 56 | """principal function |
| 57 | """ |
| 58 | try: |
| 59 | opts, args = getopt.getopt(argv, "hd:", ["help", "dokuwiki="]) |
| 60 | except getopt.GetoptError: |
| 61 | usage() |
| 62 | sys.exit(2) |
| 63 | for opt, arg in opts: |
| 64 | if opt in ("-h","--help"): |
| 65 | usage() |
| 66 | sys.exit() |
| 67 | elif opt in ("-d","--dokuwiki"): |
| 68 | print listdirectory2(arg) |
| 69 | |
| 70 | |
| 71 | def usage(): |
| 72 | """this function will display how to use this script |
| 73 | """ |
| 74 | print "This script will output change logs of a dokuwiki" |
| 75 | print "in a friendly way for gource" |
| 76 | print "how to use it :" |
| 77 | print "python gourcedoku.py -d ~/Sites/MyDokuwiki/ | sort > dokusort.log" |
| 78 | print "and then :" |
| 79 | print "gource --log-format custom dokusort.log --stop-position 1.0 \ " |
| 80 | print "--stop-on-idle --file-idle-time 10000000" |
| 81 | print "---" |
| 82 | print "-h : help " |
| 83 | print "-d : meta directory of your dokuwiki" |
| 84 | |
| 85 | |
| 86 | #print listdirectory2(sys.argv[1]) |
| 87 | |
| 88 | if __name__ == "__main__": |
| 89 | main(sys.argv[1:]) |
Nachdem man nun die Pythondatei (Bsp.name hier: doku2gource.py) hat, führt man folgenden Befehl aus:
| Bash | | copy | | ? |
| 1 | python doku2gource.py -d ~/public_html/dokuwiki/ | sort > dokusort.log |
Es ensteht die erwähnte für Gource brauchbare Logdatei. Diese wird nun wiederum an Gource weitergegeben und mit ffmpeg eine Videodatei erstellt:
| Bash | | copy | | ? |
| 1 | gource --log-format custom dokusort.log --stop-position 1.0 --stop-on-idle --file-idle-time 10000000 --output-ppm-stream - | ffmpeg -y -b 3000K -r 60 -f image2pipe -vcodec ppm -i - -vcodec mpeg4 gource.mp4 |
Das wars schon. Hier noch mal die mir nützlichen Links:
http://wolverinex02.blogspot.com/2010/05/gource-et-dokuwiki.html
http://code.google.com/p/gource/wiki/Videos
