69c84cd3c1be07ad56e04a2f07c71f073444c2ab
[ikiwiki.git] / doc / rcs / gitmanual.mdwn
1 Main use case I am trying to accomplish: Edit wiki pages offline.
2
3 1. Imagine you're the administrator of the site and you want to checkout the wiki sources to give them some love while on a train journey.
4 2. Or you are writing a complex document and you want to simply use your favourite $EDITOR
5 3. Learn a little more about [git](http://git.or.cz/)
6
7 # Workflow
8
9 ## on webconverger.org/si.dabase.com/hendry
10
11 Wiki page created with [ikiwiki](http://ikiwiki.info). Example usb.mdwn [usb](http://webconverger.org/usb/)
12
13 ## on monty (my laptop)
14
15 I wonder why a "pull" doesn't just init a repo like a "svn co" does?
16
17     monty:~/git-testing% git-init
18     Initialized empty Git repository in .git/
19
20     monty:~/git-testing% git-pull ssh://si.dabase.com/home/hendry/wikiwc/.git/
21     warning: no common commits
22     remote: Generating pack...
23     remote: Done counting 746 objects.
24     remote: Deltifying 746 objects...
25     remote:  100% (746/746) done
26     Indexing 746 objects...
27     remote: Total 746 (delta 443), reused 723 (delta 431)
28      100% (746/746) done
29     Resolving 443 deltas...
30      100% (443/443) done
31
32     echo "blah" >> usb.mdwn
33     monty:~/git-testing% git-commit -a -m "added test"
34     Created commit d3507df: added test
35      1 files changed, 1 insertions(+), 0 deletions(-)
36
37     monty:~/git-testing% git-push ssh://si.dabase.com/home/hendry/wikiwc/.git/
38     updating 'refs/heads/master'
39       from 75a4a8e94e5fff2a4beced1574e772742d3f9847
40       to   d3507dfe19b469e61a728d1b0a833a5f480f5802
41     Generating pack...
42     Done counting 5 objects.
43     Result has 3 objects.
44     Deltifying 3 objects...
45      100% (3/3) done
46     Writing 3 objects...
47      100% (3/3) done
48     Total 3 (delta 2), reused 0 (delta 0)
49     refs/heads/master: 75a4a8e94e5fff2a4beced1574e772742d3f9847 -> d3507dfe19b469e61a728d1b0a833a5f480f5802
50
51
52 ## on webconverger.org/si.dabase.com/hendry
53
54     hendry:239$ git-status 
55     # On branch master
56     # Changes to be committed:
57     #   (use "git reset HEAD <file>..." to unstage)
58     #
59     #       modified:   usb.mdwn
60     #
61     # Untracked files:
62     #   (use "git add <file>..." to include in what will be committed)
63     #
64     #       .ikiwiki/
65
66 Great, we see the usb.mdwn file has been modified. Now we need to check it out to update the local work tree (and the wiki?)
67
68     hendry:242$ git-checkout master usb.mdwn