doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn

   1 These are some notes on installing ikiwiki on Mac OS X Snow Leopard. I have a three year old machine with a lot of stuff on it so it took quite a while, YMMV.
   2
   3 The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.
   4
   5
   6 ## installing git:
   7
   8 cd /opt/ikiwiki/install
   9
  10 curl http://kernel.org/pub/software/scm/git/git-(latest version).tar.gz -O
  11
  12 tar xzvf git-(latest version).tar.gz
  13
  14 cd git-(latest version)
  15
  16 ./configure --prefix=/usr/local
  17
  18 make prefix=/usr/local all
  19
  20 sudo make install
  21
  22
  23 git config --global user.name "firstname lastname"
  24
  25 git config --global user.email "email here"
  26
  27 git config --global color.ui "auto"
  28
  29
  30 curl http://www.kernel.org/pub/software/scm/git/git-manpages-1.7.3.1.tar.gz | sudo tar -xzC /usr/local/share/man/
  31
  32
  33 ## installing ikiwiki:
  34 I had terrible trouble installing ikiwiki. It turned out I had accidentally installed Perl through ports. Uninstalling that made everything install nicely.
  35 I got an error on msgfmt. Turns out this is a program in gettext. I installed that and it fixed the error.
  36
  37 git clone git://git.ikiwiki.info/
  38
  39 perl Makefile.PL  LIB=/Library/Perl/5.10.0
  40
  41 make
  42
  43 sudo make install
  44
  45 when you make ikiwiki it gives you a .git folder with the ikiwiki files. Stay out of this folder. You want to learn how to create a clone and make all your changes in the clone. When you push the changes ikiwiki will update. I moved a file in this folder by accident because I named my working file the same and I couldn't get into the setup page. I had apparently messed up my ikiwiki git repository. I did a pull into my clone, deleted the repository and webserver/ cgi folders and ran a new setup. Then I did a git clone and dragged all my old files into the new clone. Did the git dance and did git push. Then the angels sang.
  46
  47
  48 ## using git from inside a git folder:
  49
  50 start with git clone, then learn to do the git dance like this.
  51
  52 git pull
  53
  54 make your changes to your clone
  55
  56 git commit -a -m "message here"
  57
  58 git push
  59
  60
  61 When you can't get into the setup page or you get strange behavior after a setup update the Utilities > Console app is your friend.
  62
  63 ## installing gitweb
  64
  65 cd gitweb
  66
  67 make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb.css" GITWEB_LOGO="/git-logo.png" GITWEB_FAVICON="/git-favicon.png"
  68
  69 cp gitweb.cgi /Library/WebServer/CGI-Executables/
  70 cp /usr/local/share/gitweb/static/git-favicon.png /Library/WebServer/
  71 cp /usr/local/share/gitweb/static/git-logo.png /Library/WebServer/
  72 cp /usr/local/share/gitweb/static/gitweb.css /Library/WebServer/
  73 cp /usr/local/share/gitweb/static/gitweb.js /Library/WebServer/
  74
  75 sudo chmod 2755 /Library/WebServer/CGI-Executables/gitweb.cgi
  76 sudo chmod 2755 /Library/WebServer/git-favicon.png
  77 sudo chmod 2755 /Library/WebServer/git-logo.png
  78 sudo chmod 2755 /Library/WebServer/gitweb.css
  79 sudo chmod 2755 /Library/WebServer/gitweb.js
  80
  81 ## installing xapian:
  82
  83 download xapian and omega
  84
  85 I needed pcre: sudo ports install pcre
  86
  87 ./configure
  88
  89 make
  90
  91 sudo make install
  92
  93
  94 ## installing omega:
  95
  96 I had a build error do to libiconv undefined symbols. sudo port deactivate libiconv took care of it. After install I had trouble with ikiwiki so I did a sudo port install libiconv and ikiwiki came back.
  97
  98 ./configure
  99
 100 make
 101
 102 sudo make install
 103
 104
 105 ## installing Search::Xapian from CPAN
 106
 107 for some reason this wouldn't install using CPAN console so I went to CPAN online and downloaded the source.
 108
 109 perl Makefile.PL
 110
 111 make
 112
 113 make test
 114
 115 sudo make install
 116
 117 it installed without issue so I'm baffled why it didn't install from command line.
 118
 119
 120  ## setup file
 121     _!/usr/bin/perl
 122     _ Ikiwiki setup automator.
 123
 124     _ This setup file causes ikiwiki to create a wiki, check it into revision
 125     _ control, generate a setup file for the new wiki, and set everything up.
 126
 127     _ Just run: ikiwiki -setup /etc/ikiwiki/auto.setup
 128
 129     _By default, it asks a few questions, and confines itself to the user's home
 130     _directory. You can edit it to change what it asks questions about, or to
 131     _modify the values to use site-specific settings.
 132     require IkiWiki::Setup::Automator;
 133
 134     our $wikiname="your wiki";
 135     our $wikiname_short="yourwiki";
 136     our $rcs="git";
 137     our $admin="your name";
 138     use Net::Domain q{hostfqdn};
 139     our $domain="your.domain";
 140
 141     IkiWiki::Setup::Automator->import(
 142     wikiname => $wikiname,
 143     adminuser => [$admin],
 144     rcs => $rcs,
 145     srcdir => "/opt/ikiwiki/$wikiname_short",
 146     destdir => "/Library/WebServer/Documents/$wikiname_short",
 147     repository => "/opt/ikiwiki/$wikiname_short.".($rcs eq "monotone" ? "mtn" : $rcs),
 148     dumpsetup => "/opt/ikiwiki/$wikiname_short.setup",
 149     url => "http://$domain/$wikiname_short",
 150     cgiurl => "http://$domain/cgi-bin/$wikiname_short/ikiwiki.cgi",
 151     cgi_wrapper => "/Library/WebServer/CGI-Executables/$wikiname_short/ikiwiki.cgi",
 152     adminemail => "your\@email.com",
 153     add_plugins => [qw{goodstuff websetup}],
 154     disable_plugins => [qw{}],
 155     libdir => "/opt/ikiwiki/.ikiwiki",
 156     rss => 1,
 157     atom => 1,
 158     syslog => 1,
 159     )
 160
 161
 162 ## turning on search plugin:
 163
 164 I turned on the plugin from the setup page in ikiwiki but it gave an error when I went to search. Error "blah blah cgi-bin/omega/omega" does not exist or some such. I did a
 165
 166 find / -name "omega" -print
 167
 168 and found the omega program in
 169
 170 /usr/local/lib/xapian-omega/bin/omega.
 171
 172 Then I went into the setup file and replaced the bad path, updated and badda-boom badda-bing.
 173
 174
 175