Added a comment
[ikiwiki] / doc / ikiwiki-makerepo.mdwn
1 # NAME
2
3 ikiwiki-makerepo - check an ikiwiki srcdir into revision control
4
5 # SYNOPSIS
6
7 ikiwiki-makerepo git|svn|monotone|darcs|cvs srcdir repo
8
9 ikiwiki-makerepo bzr|mercurial srcdir
10
11 # DESCRIPTION
12
13 `ikiwiki-makerepo` injects an existing `srcdir` directory, containing
14 sources for an ikiwiki wiki, into revision control. It is rarely
15 run directly; consider using `ikiwiki --setup /etc/ikiwiki/wiki.setup` instead
16 to set up a wiki.
17
18 For git, the `repo` is created as a bare git repository, and the srcdir is
19 made into a clone of it. (monotone and darcs are similar.)
20
21 For svn and cvs, the `repo` is the centralized repository, and the `srcdir`
22 is a checkout of it.
23
24 For mercurial and bzr, the srcdir is the only repository set up.
25
26 For darcs, the master repo's apply hook will be preconfigured to call a
27 ikiwiki wrapper.
28
29 Note that for monotone, you are assumed to already have run "mtn genkey"
30 to generate a key.
31
32 # EXAMPLE 
33
34 `ikiwiki-makerepo git /srv/web/wiki /srv/git/wiki.git/`
35
36 This creates a bare repository `/srv/git/wiki.git/`,
37 and sets up `/srv/web/wiki` to be a clone of it, committing
38 any files that already exist in that directory.
39
40 # AUTHOR
41
42 Joey Hess <joey@ikiwiki.info>
43
44 Warning: this page is automatically made into ikiwiki-makerepo's man page, edit with care