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]]