aboutsummaryrefslogtreecommitdiff
path: root/doc/tips
diff options
context:
space:
mode:
authorhttps://www.google.com/accounts/o8/id?id=AItOawkickHAzX_uVJMd_vFJjae6SLs2G38URPU <Kalle@web>2013-09-26 09:22:26 -0400
committeradmin <admin@branchable.com>2013-09-26 09:22:26 -0400
commit7fc605c6ebde73a9ee494016edaa37d8d6ac29b5 (patch)
tree883c1835ac54d9051f4b3cc70fac4b67fd10a8c8 /doc/tips
parent901b01036a39a930b63178c402d45a9fea675379 (diff)
downloadikiwiki-7fc605c6ebde73a9ee494016edaa37d8d6ac29b5.tar
ikiwiki-7fc605c6ebde73a9ee494016edaa37d8d6ac29b5.tar.gz
Diffstat (limited to 'doc/tips')
-rw-r--r--doc/tips/Ikiwiki_with_git-annex__44___the_album_and_the_underlay_plugins.mdwn64
1 files changed, 64 insertions, 0 deletions
diff --git a/doc/tips/Ikiwiki_with_git-annex__44___the_album_and_the_underlay_plugins.mdwn b/doc/tips/Ikiwiki_with_git-annex__44___the_album_and_the_underlay_plugins.mdwn
new file mode 100644
index 000000000..a011ac063
--- /dev/null
+++ b/doc/tips/Ikiwiki_with_git-annex__44___the_album_and_the_underlay_plugins.mdwn
@@ -0,0 +1,64 @@
+# Howto avoid heavy files in ikiwiki git repo
+
+Continuation of discussion at [git-annex forum](http://git-annex.branchable.com/forum/git-annex___38___ikiwiki_experiment/) turns out the git-annex tricks could be avoided.
+
+
+## Setup on remote server
+
+On the server activate album and underlay plugins in $wiki.setup file
+
+ add_plugins:
+ - album
+ - underlay
+
+Configure underlay plugin
+
+ add_underlays:
+ - /home/$user/$wiki.underlay
+
+Create underlay directory and init git annex in direct mode
+
+ mkdir ~/$wiki.underlay
+ cd ~/$wiki.underlay;git init;git annex init $srcunderlay; git annex direct
+
+Build ikiwiki for good measure
+ ikiwiki --setup $wiki.setup --rebuild
+
+## Setup on local laptop
+
+Clone to laptop and initialise annex repo
+
+ git clone ssh://$server/$wiki.git ~/$wiki
+ git clone ssh://$server/$wiki.underlay ~/$wiki.underlay
+ cd $wiki.underday;git-annex init $wrkunderlay
+ git remote add $srcunderlay ssh://$server/$wiki.underlay
+
+You now have an annex repo in the local $wiki.underlay called $wrkunderlay and one in the $wiki.underlay directory on the remote server called $srcunderlay.
+
+## Add content locally
+
+Add content to local $wiki directory in this case create $album.mdwn files for every album you have. Then `git add;git commit` files containing at the minimum the following
+
+ [[!album ]]
+
+Create directories in the local $wiki.underlay corresponding to the album files in the local $wiki dir. Ie. create a directory named $album for every $album.mdwn file. Copy hi-res jpg files to each directory in the local $wiki.underlay and add + commit.
+
+ git annex add .
+ git commit -m 'jpgs added'
+
+## Push to remote
+
+ cd $wrkunderlay; git-annex copy --to $srcunderlay .; git-annex sync
+ cd $wrkdir;git push
+
+That's it! Ikiwiki should update the website and treat the jpg's as if they were part of the standard file structure.
+
+How to accomplish this using the web interface is another questions. I guess the plugins have to setup and upload to underlaydir somehow.
+
+My guess is that you have to git-annex copy the $wiki.underlay files to $srcunderlay **before** running git push from the local $wiki directory. Haven't tested this yet though.
+
+
+
+
+
+