doc/tips/ikiwiki_on_mac_os_x.mdwn

   1 [[!toc]]
   2
   3 # MacPorts
   4
   5 The easiest way of installing ikiwiki on Mac OS X [Snow] Leopard and Tiger is via MacPorts: <http://www.macports.org/>
   6
   7 This project ports Open Source software into Mac Os X platform.
   8 It's very easy to intall ikiwiki via MacPorts:
   9
  10 1.- Donwnload and install MacPorts port manager from:  <http://www.macports.org/install.php> .
  11     Port manager installs via Mac Os X installer. Prerequisite: XCode.
  12     Se above URL for details
  13
  14 2.- Run
  15
  16     $ sudo port install ikiwiki
  17
  18 This installs ikiwiki and all of its dependencies
  19
  20 enjoy
  21
  22 Enrique Castilla
  23
  24 -----
  25
  26 # pkgsrc
  27
  28 The other easiest way of installing ikiwiki on Mac OS X is via
  29 [pkgsrc](http://www.pkgsrc.org/).
  30
  31 7. Bootstrap pkgsrc.
  32 7. Run
  33
  34     $ cd .../pkgsrc/www/ikiwiki && make install clean
  35
  36 -----
  37
  38 # Manual install
  39
  40 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.
  41
  42 The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.
  43
  44
  45 ## installing git:
  46
  47 cd /opt/ikiwiki/install
  48
  49 curl http://kernel.org/pub/software/scm/git/git-(latest version).tar.gz -O
  50
  51 tar xzvf git-(latest version).tar.gz
  52
  53 cd git-(latest version)
  54
  55 ./configure --prefix=/usr/local
  56
  57 make prefix=/usr/local all
  58
  59 sudo make install
  60
  61
  62 git config --global user.name "firstname lastname"
  63
  64 git config --global user.email "email here"
  65
  66 git config --global color.ui "auto"
  67
  68
  69 curl http://www.kernel.org/pub/software/scm/git/git-manpages-1.7.3.1.tar.gz | sudo tar -xzC /usr/local/share/man/
  70
  71
  72 ## installing ikiwiki:
  73 I had terrible trouble installing ikiwiki. It turned out I had accidentally installed Perl through ports. Uninstalling that made everything install nicely.
  74 I got an error on msgfmt. Turns out this is a program in gettext. I installed that and it fixed the error.
  75
  76 cd ..
  77
  78 git clone git://git.ikiwiki.info/
  79
  80 cd git.ikiwiki.info/
  81
  82 perl Makefile.PL  LIB=/Library/Perl/5.10.0
  83
  84 make
  85
  86 sudo make install
  87
  88 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.
  89
  90
  91 ## using git from inside a git folder:
  92
  93 start with git clone, then learn to do the git dance like this.
  94
  95 git pull
  96
  97 make your changes to your clone
  98
  99 git commit -a -m "message here"
 100
 101 git push
 102
 103
 104 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.
 105
 106 ## installing gitweb
 107
 108 cd ../git-1.7.3.1/gitweb
 109
 110 make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb.css" GITWEB_LOGO="/git-logo.png" GITWEB_FAVICON="/git-favicon.png" GITWEB_JS="/gitweb.js"
 111
 112 cp gitweb.cgi /Library/WebServer/CGI-Executables/
 113
 114 cp /usr/local/share/gitweb/static/git-favicon.png /Library/WebServer/Documents/
 115
 116 cp /usr/local/share/gitweb/static/git-logo.png /Library/WebServer/Documents/
 117
 118 cp /usr/local/share/gitweb/static/gitweb.css /Library/WebServer/Documents/
 119
 120 cp /usr/local/share/gitweb/static/gitweb.js /Library/WebServer/Documents/
 121
 122
 123 sudo chmod 2755 /Library/WebServer/CGI-Executables/gitweb.cgi
 124
 125 sudo chmod 2755 /Library/WebServer/Documents/git-favicon.png
 126
 127 sudo chmod 2755 /Library/WebServer/Documents/git-logo.png
 128
 129 sudo chmod 2755 /Library/WebServer/Documents/gitweb.css
 130
 131 sudo chmod 2755 /Library/WebServer/Documents/gitweb.js
 132
 133
 134 ## installing xapian:
 135
 136 download xapian and omega
 137
 138 I needed pcre: sudo ports install pcre
 139
 140 ./configure
 141
 142 make
 143
 144 sudo make install
 145
 146
 147 ## installing omega:
 148
 149 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.
 150
 151 ./configure
 152
 153 make
 154
 155 sudo make install
 156
 157
 158 ## installing Search::Xapian from CPAN
 159
 160 for some reason this wouldn't install using CPAN console so I went to CPAN online and downloaded the source.
 161
 162 perl Makefile.PL
 163
 164 make
 165
 166 make test
 167
 168 sudo make install
 169
 170 it installed without issue so I'm baffled why it didn't install from command line.
 171
 172
 173  ## setup file
 174     _!/usr/bin/perl
 175     _ Ikiwiki setup automator.
 176
 177     _ This setup file causes ikiwiki to create a wiki, check it into revision
 178     _ control, generate a setup file for the new wiki, and set everything up.
 179
 180     _ Just run: ikiwiki -setup /etc/ikiwiki/auto.setup
 181
 182     _By default, it asks a few questions, and confines itself to the user's home
 183     _directory. You can edit it to change what it asks questions about, or to
 184     _modify the values to use site-specific settings.
 185     require IkiWiki::Setup::Automator;
 186
 187     our $wikiname="your wiki";
 188     our $wikiname_short="yourwiki";
 189     our $rcs="git";
 190     our $admin="your name";
 191     use Net::Domain q{hostfqdn};
 192     our $domain="your.domain";
 193
 194     IkiWiki::Setup::Automator->import(
 195     wikiname => $wikiname,
 196     adminuser => [$admin],
 197     rcs => $rcs,
 198     srcdir => "/opt/ikiwiki/$wikiname_short",
 199     destdir => "/Library/WebServer/Documents/$wikiname_short",
 200     repository => "/opt/ikiwiki/$wikiname_short.".($rcs eq "monotone" ? "mtn" : $rcs),
 201     dumpsetup => "/opt/ikiwiki/$wikiname_short.setup",
 202     url => "http://$domain/$wikiname_short",
 203     cgiurl => "http://$domain/cgi-bin/$wikiname_short/ikiwiki.cgi",
 204     cgi_wrapper => "/Library/WebServer/CGI-Executables/$wikiname_short/ikiwiki.cgi",
 205     adminemail => "your\@email.com",
 206     add_plugins => [qw{goodstuff websetup}],
 207     disable_plugins => [qw{}],
 208     libdir => "/opt/ikiwiki/.ikiwiki",
 209     rss => 1,
 210     atom => 1,
 211     syslog => 1,
 212     )
 213
 214
 215 ## turning on search plugin:
 216
 217 I turned on the plugin from the setup page in ikiwiki but it gave an error when I went to search. Error "Error: /usr/lib/cgi-bin/omega/omega failed: No such file or directory".
 218 I did a  "find / -name "omega" -print" and found the omega program in "/usr/local/lib/xapian-omega/bin/omega".
 219
 220 Then I went into the 2wiki.setup file and replaced the bad path, updated and badda-boom badda-bing.