git.zarb.org Git - booh/blob - INSTALL

   1 This software requires for compiling:
   2
   3 - gtk >= 2.8
   4 - devel of gtk
   5 - ruby
   6 - ruby-gettext >= 0.8.0
   7 - ruby-gtk2 >= 0.12; notice:
   8   - ruby-gtk2 0.15.0 and 0.17.0 should be avoided, they are known
   9     problematic versions (crash with 0.15.0, memory leak with 0.17.0)
  10   - with ruby >= 1.8.7, ruby-gtk2 >= 0.18.0 should be used, otherwise
  11     crashes will occur
  12 - devel of ruby-gnome2 (mkmf-gnome2.rb, rbgobject.h)
  13 - devel of libexiv2 (and thus, g++)
  14
  15     Note: theoretically, gtk and ruby-gtk2 are not needed if
  16     you're gonna use only the backend script (the only lost
  17     functionality is white balance correction which uses
  18     gdk_pixbuf). However, the GUI is an important part of this
  19     software and its use is encouraged (it helps a lot).
  20
  21 And for runtime:
  22
  23 - convert (from ImageMagick) - for photos thumbnails generation
  24 - identify (from ImageMagick) - for photos captions
  25 - exif - to show full formatted EXIF information from photos
  26 - mplayer - for videos thumbnails generation
  27 - gimp - for photos editing (may not be a hard require)
  28 - mozilla-firefox - for showing albums in browser, and going on the
  29   web for tutorials (may not be a hard require)
  30
  31
  32         Compiling and Installing Quick Start
  33
  34 Type this as normal user:
  35
  36  # ruby setup.rb config
  37  # ruby setup.rb setup
  38  # cd ext
  39  # ruby extconf.rb && make
  40
  41 And type this as superuser:
  42
  43  $ ruby setup.rb install
  44  $ cd ext
  45  $ make install
  46
  47 If you want to package as normal user to another root:
  48
  49  $ ruby_archdir=`ruby -rrbconfig -e "puts Config::CONFIG['sitearchdir']"`
  50  $ libdir=`ruby -rrbconfig -e "puts Config::CONFIG['sitelibdir']"`
  51  $ rm -rf ${buildroot}
  52  $ ruby setup.rb install --prefix=${buildroot}
  53  $ cd ext
  54  $ make install DESTDIR=${buildroot} libdir=${buildroot}${libdir} archdir=${buildroot}${ruby_archdir}
  55
  56 Note: it will install things in traditional directories plus
  57 ruby_archdir and ruby_libdir.
  58 Change FPATH in ${buildroot}/local/lib/site_ruby/1.8/booh/config.rb to suit your $buildroot
  59
  60 Find desktop stuff (.desktop entry and icons) for your menu/packaging system
  61 in the destkop/ subdir.