(no commit message)
[ikiwiki] / doc / users / joshtriplett / discussion.mdwn
1 Can we please have a very brief HOWTO?
2
3 I have a Moin wiki in /var/www/wiki and want to create an IkIwiki clone of it in /var/www/ikiwiki backed by a git repos in /data/ikiwiki.
4 {{{
5 fatal: ambiguous argument 'master': unknown revision or path not in the working tree.
6 Use '--' to separate paths from revisions
7 fatal: ambiguous argument 'master': unknown revision or path not in the working tree.
8 Use '--' to separate paths from revisions
9 fatal: Not a valid object name master
10 Traceback (most recent call last):
11   File "/home/peterc/src/moin2iki/git-map", line 125, in <module>
12     if __name__ == "__main__": sys.exit(main(sys.argv[1:]))
13   File "/home/peterc/src/moin2iki/git-map", line 117, in main
14     print git_map_file('commit', new_head)
15   File "/home/peterc/src/moin2iki/git-map", line 33, in git_map_file
16     f(inproc.stdout, outproc.stdin, sha, arg)
17   File "/home/peterc/src/moin2iki/git-map", line 64, in handle_commit
18     string, tree = lines.pop(0).split()
19 IndexError: pop from empty list
20 }}}
21 I tried:
22   mkdir /var/www/ikiwiki
23   mkdir /data/ikiwiki
24   PATH=.:/usr/lib/git-core:$PATH ./moin2iki /data/ikiwiki http://localhost/wiki
25 but this failed. (BTW, I don't usually put . in my PATH).  The failure appears to be that the converter doesn't actually create an ikiwiki instance, but appears to want to update one:
26
27     fatal: ambiguous argument 'master': unknown revision or path not in the working tree.
28     Use '--' to separate paths from revisions
29     fatal: ambiguous argument 'master': unknown revision or path not in the working tree.
30     Use '--' to separate paths from revisions
31     fatal: Not a valid object name master
32     Traceback (most recent call last):
33       File "/home/peterc/src/moin2iki/git-map", line 125, in <module>
34         if __name__ == "__main__": sys.exit(main(sys.argv[1:]))
35       File "/home/peterc/src/moin2iki/git-map", line 117, in main
36         print git_map_file('commit', new_head)
37       File "/home/peterc/src/moin2iki/git-map", line 33, in git_map_file
38         f(inproc.stdout, outproc.stdin, sha, arg)
39       File "/home/peterc/src/moin2iki/git-map", line 64, in handle_commit
40         string, tree = lines.pop(0).split()
41     IndexError: pop from empty list
42
43 OK, so I created one:
44
45     ikiwiki --setup /etc/ikiwiki/auto.setup
46     .....
47  This process created several files and directories in my home directory:
48     wiki.git/
49     public_html/wiki/
50     wiki.setup
51     .ikiwiki/
52
53 Following the instructions on the setup page, I did:
54     mv wiki.git /data/ikiwiki
55     ( cd /data/ikiwiki; git clone -l wiki.git wiki; )
56     mv .ikiwiki /data/ikiwiki/ikiwiki
57     mv ~/public_html/wiki /var/ikiwiki/
58
59 then did again
60     PATH=.:/usr/lib/git-core:$PATH ./moin2iki /data/ikiwiki/wiki http://www/wiki
61 and saw no output, and no change to the filesystem.
62
63
64 Help please!