diff options
| -rw-r--r-- | doc/forum/ikiwiki_with_album___38___underlay_plugins.mdwn | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/doc/forum/ikiwiki_with_album___38___underlay_plugins.mdwn b/doc/forum/ikiwiki_with_album___38___underlay_plugins.mdwn new file mode 100644 index 000000000..d6ca286cd --- /dev/null +++ b/doc/forum/ikiwiki_with_album___38___underlay_plugins.mdwn @@ -0,0 +1,61 @@ +# 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 ./$wrkdir + git clone ssh://$server/$wiki.underlay ./$wiki.underlay + cd $wiki.underday;git-annex init $wrkunderlay + git remote add $srcunderlay ssh://$server/$wiki.underlay + +## Add content locally + +Clone remote bare repo at $gitdir to local $wrkdir on laptop. Add content to $wrkdir in this case create $album.mdwn files for every album `git add;git commit` files containing at the minimum the following + + [[!album ]] + +Create directories in $wrkunderlay corresponding to the album files in $wrkdir. Ie. create a directory named $album for every $album.mdwn file. Copy hi-res jpg files to each directory in $wrkunderlay 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. + + + + + + + |