brain gradually engaging
[ikiwiki.git] / doc / post-commit / discussion.mdwn
1 Hi Joey and many thanks for your work on ikiwiki, as usual you give us a very good soft...
2
3 I want to be able to edit my website from a navigator (with the CGI) and
4 from my favorite editor on my laptop. I have managed to use the subversion wrapper
5 so I have write a post-commit hook with : 
6
7     cd /~/wikisrc/ 
8     svn up
9     /usr/bin/ikiwiki --setup ../ikiwiki.setup
10
11 at the end.
12
13 This configuration works for me, the svn wrapper doesn't seems to
14 do the svn up stuff so I wonder if I've missed something...
15
16 Regards.
17
18 > Well, you've created a post-commit script that runs ikiwiki in setup mode.
19 > That's not how it's generally done, instead you generally configure
20 > ikiwiki to generate a post-commit _binary_ that runs ikiwiki in update
21 > mode. That binary can be installed directly as the post-commit hook, or
22 > called from an existing post-commit hook script, and it will handle the
23 > necessary svn up, and will update the wiki much quicker than your --setup
24 > command above (which rebuilds the entire wiki and all wrappers each
25 > commit)!
26 >
27 > In this wiki's setup file, I configure ikiwiki to generate a post-commit
28 > wrapper binary like so:
29
30 >       wrappers => [
31 >       {
32 >               wrapper => "/srv/svn/ikiwiki/hooks/post-commit",
33 >               wrappermode => "04755",
34 >               notify => 1,
35 >       }
36 >       ],
37
38
39 Hello, I've setup ikiwiki with subversion. I can edit pages from web browser using CGI and, when I go to recentchanges, it shows that modification with "web" word. But, if I modify any .mdwn file, it gets updated in website but it doesn't show in recentchanges entry with "svn" word. If I run "svn ci -m changes", it shows in recentchanges correctly.
40
41 So, I think I miss something, because I don't think I must run "svn add" or "svn commit" anytime I modify or create a wiki file.
42
43 Thanks
44
45 > Yes, ikiwiki does expect you to use your revision control system to check
46 > in changes. Otherwise, recentchanges cannot work right, since it uses the
47 > commit history from your revision control system. --[[Joey]]
48
49 -----
50
51 I'm working on an [[rcs]] plugin for CVS, adapted from `svn.pm`, in order to integrate ikiwiki at sites where that's all they've got. What's working so far: web commit (post-commit hook and all), diff, add (under certain conditions), and remove. What's not working: with rcs_add(), iff any of the new page's parent dirs aren't already under CVS control and the post-commit hook is enabled, the browser and ikiwiki stall for several seconds trying to add it, then time out. (If I kill ikiwiki when this is happening, it cvs adds the topmost parent that needed adding; if I wait for timeout, it doesn't. I think.) If I disable the post-commit hook and do the same kind of thing, the page is created and saved.
52
53 In case you're lucky enough not to know, cvs adds on directories are weird -- they operate immediately against the repository, unlike file adds:
54
55     $ cvs add randomdir
56     Directory /Users/schmonz/Documents/cvswiki/repository/ikiwiki/randomdir added to the repository
57
58 I was able to work out that when I'm seeing this page save misbehavior, my plugin is somewhere inside `system("cvs", "-Q", "add", "$file")`, which was never returning. If I changed it to anything other than cvs it iterated correctly over all the parent dirs which needed to be added to CVS, in the proper order. (cvs add isn't recursive, sadly.)
59
60 Can you offer an educated guess what's going wrong here? --[[Schmonz]]
61
62 > Got `rcs_recentchanges` working, believe it or not, thanks to [cvsps](http://www.cobite.com/cvsps/). If I can figure out this interaction between the post-commit hook and `cvs add` on directories, the CVS plugin is mostly done. Could it be a locking issue? Where should I be looking? Any suggestions appreciated. --[[Schmonz]]
63
64 >> Okay, it is definitely a locking issue. First, on the conjecture that `cvs add <directory>` was triggering the post-commit hook and confusing ikiwiki, I wrapped the ikiwiki post-commit binary with a shell script that exited 0 if the triggering file was a directory. The first half of the conjecture was correct -- my wrapper got triggered -- but the web add of `one/two/three.mdwn` (where `one` and `two` weren't existing CVS-controlled dirs) remained hung as before. There were two ikiwiki processes running. On a whim, I killed the one with the higher PID; `cvs add one` immediately completed successfully, then back to a hang and two ikiwiki processes. I killed the newer one again and then `cvs add one/two` and `cvs add one/two/three.mdwn` completed and the web add was successful.