doc/tips/ikiwiki_on_mac_os_x.mdwn

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