]> sipb.mit.edu Git - ikiwiki.git/blob - doc/setup/discussion.mdwn
9006030d929495aae535bdbe01ebc1dc99d0cae8
[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
11 believe this is partially explained on the rcs/git/ page. However I'm still
12 not totally clear where I should run the command when using git. If I
13 should be in $SRCDIR then updating the instructions to something like
14
15     REPOSITORY=~/wiki.git
16     cd $SRCDIR
17     ikiwiki-makerepo git $SCDIR $REPOSITORY
18
19 might clear things up a little. Apologies if I'm being a bit dim, learning
20 ikiwiki and git at same time :) 
21
22 Have tried 3 options
23
24 1. mkdir $REP cd $REP run command (says $REP already exists so won't run)
25 2. rm -rf $REP cd $SRC run command (creates a repository in $SRC, does not create $REP ends with "remote origin already exists"
26 3. mkdir $TMP cd $TMP run command (creates a repository in $SRC/.git creates a repository in $TMP, does nothing to $REP, ends with "remote origin already exists".
27
28 Version of ikiwiki installed is package from Ubuntu/Hardy 2.19
29 Git version is 1.5.2.5
30
31 n.b. svn version of command worked fine :)
32
33 --Andy
34
35 > Please show me a transcript of it not working. Here is a transcript of it
36 > working just as the tutorial describes it to work:
37 >       
38 >       joey@kodama:~/tmp/work>ls
39 >       repo/  src/
40 >       joey@kodama:~/tmp/work>rm -rf repo src
41 >       joey@kodama:~/tmp/work>mkdir src
42 >       joey@kodama:~/tmp/work>echo hi > src/index.html
43 >       joey@kodama:~/tmp/work>ikiwiki-makerepo git src repo
44 >       Importing src into git
45 >       Initialized empty shared Git repository in /home/joey/tmp/work/repo/
46 >       Initialized empty Git repository in .git/
47 >       Created initial commit 2254e46: initial commit
48 >        2 files changed, 2 insertions(+), 0 deletions(-)
49 >        create mode 100644 .gitignore
50 >        create mode 100644 index.html
51 >       updating 'refs/heads/master'
52 >         from 0000000000000000000000000000000000000000
53 >         to   2254e462e31429e755bae56939c4319be8bb912b
54 >        Also local refs/remotes/origin/master
55 >       Generating pack...
56 >       Done counting 4 objects.
57 >       Deltifying 4 objects...
58 >        100% (4/4) done
59 >       Writing 4 objects...
60 >       Unpacking 4 objects...
61 >        100% (4/4) done
62 >       refs/heads/master: 0000000000000000000000000000000000000000 -> 2254e462e31429e755bae56939c4319be8bb912b
63 >       
64 >       Total 4 (delta 0), reused 0 (delta 0)
65 >       Directory src is now a clone of git repository /home/joey/tmp/work/repo
66
67
68 OK here goes - I'm afraid its to color codes in it, so its a bit bigger and less readable than yours - apologies.
69
70 <pre>
71 Script started on Fri 11 Jan 2008 19:29:44 GMT
72 ^[]0;deploy@little-un: ~/tmp^G^M^M
73 ^[[44;01;33mdeploy@little-un^[[40;0;37m:^[[01;34m~/tmp^[[00m$ ls^M
74 ^[[00m^[[00;32msrc^[[00m  ^[[00mtypescript^[[00m^M
75 ^[[m^[]0;deploy@little-un: ~/tmp^G^M^M
76 ^[[44;01;33mdeploy@little-un^[[40;0;37m:^[[01;34m~/tmp^[[00m$ echo hi src/index.mdwn^M
77 hi src/index.mdwn^M
78 ^[]0;deploy@little-un: ~/tmp^G^M^M
79 ^[[44;01;33mdeploy@little-un^[[40;0;37m:^[[01;34m~/tmp^[[00m$ echo hi src/index.mdwn^H^H^H^H^H^H^H^H^H^H^H^H^H^H^H^H^H^[[4h>^[[4l^[[4h ^[[4l^M
80 ^[]0;deploy@little-un: ~/tmp^G^M^M
81 ^[[44;01;33mdeploy@little-un^[[40;0;37m:^[[01;34m~/tmp^[[00m$ ikiwiki-makerepo src ^H^[[K^H^[[K^H^[[K^H^[[Kgit src repo^M
82 Importing src into git^M
83 Initialized empty shared Git repository in /home/deploy/tmp/^M
84 Initialized empty Git repository in .git/^M
85 Created initial commit 9f55e11: initial commit^M
86  1 files changed, 1 insertions(+), 0 deletions(-)^M
87  create mode 100644 .gitignore^M
88 fatal: '/home/deploy/tmp/repo': unable to chdir or not a git archive^M
89 fatal: The remote end hung up unexpectedly^M
90 error: failed to push to '/home/deploy/tmp/repo'^M
91 ^[]0;deploy@little-un: ~/tmp^G^M^M
92 ^[[44;01;33mdeploy@little-un^[[40;0;37m:^[[01;34m~/tmp^[[00m$ ls^M
93 ^[[00m^[[00;32mbranches^[[00m  ^[[00mconfig^[[00m  ^[[00mdescription^[[00m  ^[[00mHEAD^[[00m  ^[[00mhi^[[00m  ^[[00;32mhooks^[[00m  ^[[00;32minfo^[[00m  ^[[00;32mobjects^[[00m  ^[[00;32mrefs^[[00m  ^[[00;32msrc^[[00m  ^[[00mtypescript^[[00m^M
94 ^[[m^[]0;deploy@little-un: ~/tmp^G^M^M
95 ^[[44;01;33mdeploy@little-un^[[40;0;37m:^[[01;34m~/tmp^[[00m$ exit^M
96
97 Script done on Fri 11 Jan 2008 19:32:21 GMT
98 </pre>
99
100 ----
101
102 It isn't intended that .ikiwiki be versioned, is it? Do you have a svn:ignore set? 
103 Is there some magic way you can make the svn commands (and presumably commands for 
104 the other VCSs here) ignore the .ikiwiki directory during step 8, when they import it?
105 If not, maybe a note should be made that the user should delete this file before 
106 they import. --Ethan
107
108 > No, .ikiwiki should not be versioned, and a svn:ignore of it is reasonable,
109 > although probably too much noise for the setup instructions.
110 > I've switched to a different method that preserves .ikiwiki, w/o checking
111 > it in. --[[Joey]]
112
113 ----
114
115 These instructions should probably show how to use a bare Git repository
116 (`GIT_DIR=somewhere.git git-init-db`) rather than a repository with a full
117 working copy. You can always clone the repository if you want your own local
118 working copy. Furthermore, this allows you to make multiple commits to your
119 working copy before pushing them to the repository and causing the wiki to
120 update. --[[JoshTriplett]]
121
122 > I'm currently testing and running such a setup. --[[tschwinge]]
123
124 Furthermore the git instructions should be changed to move the *.ikiwiki*
125 directory back into the wiki's working copy directory, isn't it? --[[tschwinge]]
126
127 > Yes, I think so.  I will clean these instructions up unless somebody tells me we're missing something fundamental. --[[BartMassey]]
128
129 >> Either you do it or I'll do it somewhen soon.  --[[tschwinge]]
130
131 ----
132
133 Curious as to why support for CVS is not built in. --[[Luther]]
134
135 > See [[todo/CVS_backend|todo/CVS_backend]], but you might consider switching to a better version control system. --[[JoshTriplett]]