doc/forum/ikiwiki_and_big_files.mdwn

   1 My website has 214 hand written html, 1500 of pictures and a few, err sorry, 114
   2 video files. All this takes around 1.5 GB of disk space at the moment.
   3 Plain html files take 1.7 MB and fit naturally into git.
   4
   5 But what about the picture and video files?
   6
   7 Pictures are mostly static and rarely need to be edited after first upload,
   8 wasting a megabyte or two after an edit while having them in git doesn't really matter.
   9 Videos on the other hand are quite large from megabytes to hundreds. Sometimes
  10 I re-encode them from the original source with better codec parameters and just
  11 replace the files under html root so they are accessible from the same URL.
  12 So having a way to delete a 200 MB file and upload a new one with same name and access URL
  13 is what I need. And it appears git has trouble erasing commits from history, or requires
  14 some serious gitfoo and good backups of the original repository.
  15
  16 So which ikiwiki backend could handle piles of large binary files? Or should I go for a separate
  17 data/binary blob directory next to ikiwiki content?
  18
  19 Further complication is my intention to keep URL compatibility with old handwritten and ikiwiki
  20 based site. Sigh, tough job but luckily just a hobby.
  21
  22 [-Mikko](http://mcfrisk.kapsi.fi)
  23
  24 ps. here's how to calculate space taken by html, picture and video files:
  25
  26     ~/www$ unset sum; for size in $( for ext in htm html txt xml log; \
  27     do find . -iname "*$ext" -exec stat -c "%s" \{\} \; ; done | xargs ); \
  28     do sum=$(( $sum + $size )); done ; echo $sum
  29     1720696
  30     ~/www$ unset sum; for size in $( for ext in jpg gif jpeg png; \
  31     do find . -iname "*$ext" -exec stat -c "%s" \{\} \; ; done | xargs ); \
  32     do sum=$(( $sum + $size )); done ; echo $sum
  33     46032184
  34     ~/www$ unset sum; for size in $( for ext in avi dv mpeg mp4; \
  35     do find . -iname "*$ext" -exec stat -c "%s" \{\} \; ; done | xargs ); \
  36     do sum=$(( $sum + $size )); done ; echo $sum
  37     1351890888
  38
  39 > One approach is to use the [[plugins/underlay]] plugin to
  40 > configure a separate underlay directory, and put the large
  41 > files in there. Those files will then be copied to the generated
  42 > wiki, but need not be kept in revision control. (Or could be
  43 > revision controlled in a separate repository -- perhaps one using
  44 > a version control system that handles large files better than git;
  45 > or perhaps one that you periodically blow away the old history to
  46 > in order to save space.)
  47 >
  48 > BTW, the `hardlink` setting is a good thing to enable if you
  49 > have large files, as it saves both disk space and copying time.
  50 > --[[Joey]]
  51
  52 Can underlay plugin handle the case that source and destination directories
  53 are the same? I'd rather have just one copy of these underlay files on the server.
  54
  55 > No, but enabling hardlinks accomplishes the same effect. --[[Joey]]
  56
  57 And did I goof in the setup file since I got this:
  58
  59     $ ikiwiki -setup blog.setup -rebuild --verbose
  60     Can't use string ("/home/users/mcfrisk/www/blog/med") as an ARRAY ref while
  61     "strict refs" in use at
  62     /home/users/mcfrisk/bin/share/perl/5.10.0/IkiWiki/Plugin/underlay.pm line 41.
  63     $ grep underlay blog.setup
  64         add_plugins => [qw{goodstuff websetup comments blogspam html sidebar underlay}],
  65         underlaydir => '/home/users/mcfrisk/bin/share/ikiwiki/basewiki',
  66         # underlay plugin
  67         # extra underlay directories to add
  68         add_underlays => '/home/users/mcfrisk/www/blog/media',
  69     $ egrep "(srcdir|destdir)" blog.setup
  70         srcdir => '/home/users/mcfrisk/blog',
  71         destdir => '/home/users/mcfrisk/www/blog',
  72         # allow symlinks in the path leading to the srcdir (potentially insecure)
  73         allow_symlinks_before_srcdir => 1,
  74         # directory in srcdir that contains directive descriptions
  75
  76 -Mikko
  77
  78 > The plugin seems to present a bad default value in the setup file.
  79 > (Fixed in git.) A correct configuration would be:
  80
  81         add_underlays => ['/home/users/mcfrisk/www/blog/media'],
  82
  83 Umm, doesn't quite fix this yet:
  84
  85     $ ikiwiki -setup blog.setup -v
  86     Can't use an undefined value as an ARRAY reference at /home/users/mcfrisk/bin/share/perl/5.10.0/IkiWiki
  87     /Plugin/underlay.pm line 44.
  88     $ grep underlay blog.setup
  89         add_plugins => [qw{goodstuff websetup comments blogspam html sidebar underlay}],
  90         underlaydir => '/home/users/mcfrisk/bin/share/ikiwiki/basewiki',
  91         # underlay plugin
  92         # extra underlay directories to add
  93         add_underlays => ['/home/users/mcfrisk/www/blog/media'],
  94     $ ikiwiki --version
  95     ikiwiki version 3.20091032
  96
  97 -Mikko
  98
  99 > Yeah, I've fixed that in git, but you can work around it with this:
 100 > --[[Joey]]
 101
 102         templatedirs => [],