Update README.

[redo-blog] / README.md

diff --git a/README.md b/README.md
index 9d6a05b17e7cbffe92d6f62d90315fa5f8724102..f036e86f9e6d2a31ecf48ce7866199d40a591c40 100644 (file)
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ dependencies
 
 - redo
 - python3
-- uuidgen
+- uuidgen (Debian package: uuid-runtime)
 - html2text
 - pandoc
 
@@ -33,8 +33,54 @@ data used in ./feed.xml and ./index.html will be built there and can be edited
 to customize the blog – namely the files url, author, uuid, title, index.tmpl,
 index_snippet.tmpl, article.tmpl.
 
+recipe to use server-side with git
+----------------------------------
+
+On your server, install the dependencies listed above. Then set up a repository
+for your blog files. Let's assume we want it to sit in our home directory and be
+called `blog`:
+
+    cd ~
+    mkdir blog
+    git init --bare blog.git
+    cat << EOF > blog.git/hooks/post-update
+    #!/bin/sh
+    BLOGDIR=~/blog
+    GIT_WORK_TREE=$BLOGDIR git checkout -f
+    cd $BLOGDIR
+    redo
+    EOF
+    chmod a+x blog.git/hooks/post-update
+
+Enable management of `~/blog` via redo-blog:
+
+    git clone https://github.com/plomlompom/redo-blog/
+    cd redo-blog/
+    ./add_dir.sh ~/blog
+    mkdir ~/blog/public
+
+Link to the `public` subdirectory from wherever your web server expects your
+public web content to sit:
+
+    link -s ~/blog/public /var/www/html/blog
+
+Client-side, do this:
+
+    cd ~
+    git init blog
+    cd blog
+    git remote add origin ssh://user@example.org:~/blog.git
+    mkdir metadata
+    echo 'https://example.org/blog/' > metadata/url
+    git add metadata/url
+    git commit -m 'set up blog metadata'
+    git push origin master
+
 bugs
 ----
 
 Don't create a index.rst or index.md in the redo-managed directory, that will
 break things.
+
+Running redo without a single blog entry source file (.md or .rst) in the
+directory will also break things.