web commit by http://diabolist.myopenid.com/
[ikiwiki.git] / doc / setup / discussion.mdwn
1 Can the instructions for using `ikiwiki-makerepo` be clarified. This
2 command wants to create folders in the directory it is run in. Which
3 directory should that be - `$SRCDIR?` --Andy
4
5 > No, `ikiwiki-makerepo` does not create directories in the current
6 > directory. You specify the directory you want it to create and it creates
7 > the directory and makes it into a repository. The setup instuctions have
8 > examples of doing this. I don't see anything unclear. --[[Joey]]
9
10 Sorry, was not precise enough. It does if you are using the git option. I believe this is partially explained on the rcs/git/ page. However I'm still not totally clear where I should run the command when using git. If I should be in $SRCDIR then updating the instructions to something like
11
12     REPOSITORY=~/wiki.git
13     cd $SRCDIR
14     ikiwiki-makerepo git $SRCDIR $REPOSITORY
15
16 might clear things up a little. Apologies if I'm being a bit dim, learning ikiwiki and git at same time :) --Andy
17
18 ----
19
20 It isn't intended that .ikiwiki be versioned, is it? Do you have a svn:ignore set? 
21 Is there some magic way you can make the svn commands (and presumably commands for 
22 the other VCSs here) ignore the .ikiwiki directory during step 8, when they import it?
23 If not, maybe a note should be made that the user should delete this file before 
24 they import. --Ethan
25
26 > No, .ikiwiki should not be versioned, and a svn:ignore of it is reasonable,
27 > although probably too much noise for the setup instructions.
28 > I've switched to a different method that preserves .ikiwiki, w/o checking
29 > it in. --[[Joey]]
30
31 ----
32
33 These instructions should probably show how to use a bare Git repository
34 (`GIT_DIR=somewhere.git git-init-db`) rather than a repository with a full
35 working copy. You can always clone the repository if you want your own local
36 working copy. Furthermore, this allows you to make multiple commits to your
37 working copy before pushing them to the repository and causing the wiki to
38 update. --[[JoshTriplett]]
39
40 > I'm currently testing and running such a setup. --[[tschwinge]]
41
42 Furthermore the git instructions should be changed to move the *.ikiwiki*
43 directory back into the wiki's working copy directory, isn't it? --[[tschwinge]]
44
45 > Yes, I think so.  I will clean these instructions up unless somebody tells me we're missing something fundamental. --[[BartMassey]]
46
47 >> Either you do it or I'll do it somewhen soon.  --[[tschwinge]]
48
49 ----
50
51 Curious as to why support for CVS is not built in. --[[Luther]]
52
53 > See [[todo/CVS_backend|todo/CVS_backend]], but you might consider switching to a better version control system. --[[JoshTriplett]]