<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>ikiwiki on mac os x</title> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="stylesheet" href="../style.css" type="text/css" /> <link rel="stylesheet" href="../local.css" type="text/css" /> </head> <body> <div class="page"> <div class="pageheader"> <div class="header"> <span> <span class="parentlinks"> <a href="../index.html">ikiwiki</a>/ <a href="../tips.html">tips</a>/ </span> <span class="title"> ikiwiki on mac os x </span> </span> </div> </div> <div id="pagebody"> <div id="content" role="main"> <div class="toc"> <ol> <li class="L1"><a href="#index1h1">pkgsrc</a> </li> <li class="L1"><a href="#index2h1">MacPorts</a> </li> <li class="L1"><a href="#index3h1">Manual install</a> </li> </ol> </div> <h1><a name="index1h1"></a>pkgsrc</h1> <p>The easiest way of installing an up-to-date ikiwiki on any version of Mac OS X is via <a href="http://www.pkgsrc.org/">pkgsrc</a>.</p> <h2><a name="index1h2"></a>From source:</h2> <ol> <li><a href="http://www.netbsd.org/docs/pkgsrc/platforms.html#bootstrapping-pkgsrc">Bootstrap pkgsrc</a></li> <li>Run <code>cd .../pkgsrc/www/ikiwiki && make install clean</code></li> </ol> <h2><a name="index2h2"></a>From binary packages:</h2> <ol> <li><a href="http://www.pkgsrc.org/#index1h1">install binary packages (OSX)</a></li> </ol> <p><img src="../smileys/thumbs-up.png" alt="{OK}" /> As of 2014/10/14, the <a href="http://pkgsrc.se/www/ikiwiki">version of ikiwiki in pkgsrc</a> is 3.20140916.</p> <hr /> <h1><a name="index2h1"></a>MacPorts</h1> <p>Another way to install ikiwiki on Mac OS X [Snow] Leopard and Tiger is via MacPorts: <a href="http://www.macports.org/">http://www.macports.org/</a></p> <p>This project ports Open Source software into Mac OS X platform. It's very easy to install ikiwiki via MacPorts:</p> <p>1.- Donwnload and install MacPorts port manager from: <a href="http://www.macports.org/install.php">http://www.macports.org/install.php</a> . Port manager installs via Mac OS X installer. Prerequisite: XCode. Se above URL for details</p> <p>2.- Run </p> <pre><code>$ sudo port install ikiwiki </code></pre> <p>This installs ikiwiki and all of its dependencies</p> <p>enjoy</p> <p>Enrique Castilla</p> <p><img src="../smileys/attention.png" alt="[!]" /> As of 2014/10/14, the <a href="http://www.macports.org/ports.php?by=name&substr=Ikiwiki">version of ikiwiki in MacPorts</a> is 3.20110608.</p> <hr /> <h1><a name="index3h1"></a>Manual install</h1> <p>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. </p> <p>The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.</p> <h2><a name="index3h2"></a>installing git:</h2> <p>cd /opt/ikiwiki/install</p> <p>curl http://kernel.org/pub/software/scm/git/git-(latest version).tar.gz -O</p> <p>tar xzvf git-(latest version).tar.gz</p> <p>cd git-(latest version)</p> <p>./configure --prefix=/usr/local </p> <p>make prefix=/usr/local all</p> <p>sudo make install</p> <p>git config --global user.name "firstname lastname" </p> <p>git config --global user.email "email here"</p> <p>git config --global color.ui "auto" </p> <p>curl http://www.kernel.org/pub/software/scm/git/git-manpages-1.7.3.1.tar.gz | sudo tar -xzC /usr/local/share/man/</p> <h2><a name="index4h2"></a>installing ikiwiki:</h2> <p>I had terrible trouble installing ikiwiki. It turned out I had accidentally installed Perl through ports. Uninstalling that made everything install nicely. I got an error on msgfmt. Turns out this is a program in gettext. I installed that and it fixed the error.</p> <p>cd ..</p> <p>git clone git://git.ikiwiki.info/</p> <p>cd git.ikiwiki.info/</p> <p>perl Makefile.PL LIB=/Library/Perl/5.10.0</p> <p>make</p> <p>sudo make install</p> <p>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.</p> <h2><a name="index5h2"></a>using git from inside a git folder:</h2> <p>start with git clone, then learn to do the git dance like this.</p> <p>git pull</p> <p>make your changes to your clone</p> <p>git commit -a -m "message here"</p> <p>git push</p> <p>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.</p> <h2><a name="index6h2"></a>installing gitweb</h2> <p>cd ../git-1.7.3.1/gitweb</p> <p>make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb.css" GITWEB_LOGO="/git-logo.png" GITWEB_FAVICON="/git-favicon.png" GITWEB_JS="/gitweb.js"</p> <p>cp gitweb.cgi /Library/WebServer/CGI-Executables/</p> <p>cp /usr/local/share/gitweb/static/git-favicon.png /Library/WebServer/Documents/</p> <p>cp /usr/local/share/gitweb/static/git-logo.png /Library/WebServer/Documents/</p> <p>cp /usr/local/share/gitweb/static/gitweb.css /Library/WebServer/Documents/</p> <p>cp /usr/local/share/gitweb/static/gitweb.js /Library/WebServer/Documents/</p> <p>sudo chmod 2755 /Library/WebServer/CGI-Executables/gitweb.cgi</p> <p>sudo chmod 2755 /Library/WebServer/Documents/git-favicon.png</p> <p>sudo chmod 2755 /Library/WebServer/Documents/git-logo.png</p> <p>sudo chmod 2755 /Library/WebServer/Documents/gitweb.css</p> <p>sudo chmod 2755 /Library/WebServer/Documents/gitweb.js</p> <h2><a name="index7h2"></a>installing xapian:</h2> <p>download xapian and omega</p> <p>I needed pcre: sudo ports install pcre</p> <p>./configure</p> <p>make</p> <p>sudo make install</p> <h2><a name="index8h2"></a>installing omega:</h2> <p>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.</p> <p>./configure</p> <p>make</p> <p>sudo make install</p> <h2><a name="index9h2"></a>installing Search::Xapian from CPAN</h2> <p>for some reason this wouldn't install using CPAN console so I went to CPAN online and downloaded the source.</p> <p>perl Makefile.PL</p> <p>make</p> <p>make test</p> <p>sudo make install</p> <p>it installed without issue so I'm baffled why it didn't install from command line.</p> <p>## setup file _!/usr/bin/perl _ Ikiwiki setup automator.</p> <pre><code>_ This setup file causes ikiwiki to create a wiki, check it into revision _ control, generate a setup file for the new wiki, and set everything up. _ Just run: ikiwiki --setup /etc/ikiwiki/auto.setup _By default, it asks a few questions, and confines itself to the user's home _directory. You can edit it to change what it asks questions about, or to _modify the values to use site-specific settings. require IkiWiki::Setup::Automator; our $wikiname="your wiki"; our $wikiname_short="yourwiki"; our $rcs="git"; our $admin="your name"; use Net::Domain q{hostfqdn}; our $domain="your.domain"; IkiWiki::Setup::Automator->import( wikiname => $wikiname, adminuser => [$admin], rcs => $rcs, srcdir => "/opt/ikiwiki/$wikiname_short", destdir => "/Library/WebServer/Documents/$wikiname_short", repository => "/opt/ikiwiki/$wikiname_short.".($rcs eq "monotone" ? "mtn" : $rcs), dumpsetup => "/opt/ikiwiki/$wikiname_short.setup", url => "http://$domain/$wikiname_short", cgiurl => "http://$domain/cgi-bin/$wikiname_short/ikiwiki.cgi", cgi_wrapper => "/Library/WebServer/CGI-Executables/$wikiname_short/ikiwiki.cgi", adminemail => "your\@email.com", add_plugins => [qw{goodstuff websetup}], disable_plugins => [qw{}], libdir => "/opt/ikiwiki/.ikiwiki", rss => 1, atom => 1, syslog => 1, ) </code></pre> <h2><a name="index10h2"></a>turning on search plugin:</h2> <p>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". I did a "find / -name "omega" -print" and found the omega program in "/usr/local/lib/xapian-omega/bin/omega".</p> <p>Then I went into the 2wiki.setup file and replaced the bad path, updated and badda-boom badda-bing.</p> </div> </div> <div id="footer" class="pagefooter" role="contentinfo"> <div id="pageinfo"> <div class="pagedate"> Last edited <span class="date">Tue Feb 26 23:01:54 2019</span> <!-- Created <span class="date">Fri Jun 24 21:35:14 2011</span> --> </div> </div> <!-- from ikiwiki --> </div> </div> </body> </html>