summaryrefslogtreecommitdiff
path: root/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
diff options
context:
space:
mode:
authorJoey Hess <joey@kitenet.net>2010-10-17 19:17:00 -0400
committerJoey Hess <joey@kitenet.net>2010-10-17 19:17:00 -0400
commit31e23ddc514faba17bfeb213a6ecaafc806aae1b (patch)
tree14ce5689b358ead2d2172881868e4cae343e55bd /doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
parent1d119e5314279235cebc5624f944ee67586cca52 (diff)
parentdd35d0d28fa2db775b4fd7fef0c587d5abd96e3e (diff)
Merge branch 'master' of ssh://git.ikiwiki.info/srv/git/ikiwiki.info
Diffstat (limited to 'doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn')
-rw-r--r--doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn104
1 files changed, 75 insertions, 29 deletions
diff --git a/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
index 4eb084f38..50bb2f520 100644
--- a/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
+++ b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
@@ -5,15 +5,17 @@ The best part of installing ikiwiki was learning how to use git. I never used so
## installing git:
+cd /opt/ikiwiki/install
+
curl http://kernel.org/pub/software/scm/git/git-(latest version).tar.gz -O
tar xzvf git-(latest version).tar.gz
cd git-(latest version)
-./configure --prefix=/usr/local
+./configure --prefix=/usr/local
-NO_MSGFMT=yes make prefix=/usr/local all
+make prefix=/usr/local all
sudo make install
@@ -25,31 +27,20 @@ git config --global user.email "email here"
git config --global color.ui "auto"
-curl http://www.kernel.org/pub/software/scm/git/git-manpages-1.7.3.1.tar.gz | sudo tar -xzC /opt/local/share/man/
+curl http://www.kernel.org/pub/software/scm/git/git-manpages-1.7.3.1.tar.gz | sudo tar -xzC /usr/local/share/man/
## installing ikiwiki:
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.
-I like to install test software in /opt. No particular reason. You could install to defaults.
-
-
-perl Makefile.PL PREFIX=/Library/Perl/5.10.0 LIB=/Library/Perl/5.10.0
+git clone git://git.ikiwiki.info/
perl Makefile.PL LIB=/Library/Perl/5.10.0
make
-make install
-
-sudo install -d /opt/ikiwiki
-
-sudo install -m 0644 wikilist /opt/ikiwiki
-
-sudo install -m 0644 auto.setup /opt/ikiwiki
-
-sudo install -m 0644 auto-blog.setup /opt/ikiwiki
-
+sudo make install
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.
@@ -71,11 +62,30 @@ When you can't get into the setup page or you get strange behavior after a setup
## installing gitweb
-make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb/gitweb.css" GITWEB_LOGO="/gitweb/git-logo.png" GITWEB_FAVICON="/gitweb/git-favicon.png" bindir=/opt/local/bin
+cd gitweb
+
+make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb.css" GITWEB_LOGO="/git-logo.png" GITWEB_FAVICON="/git-favicon.png"
+
+cp gitweb.cgi /Library/WebServer/CGI-Executables/
-cp gitweb.cgi /Library/WebServer/CGI-Executables/gitweb/
+cp /usr/local/share/gitweb/static/git-favicon.png /Library/WebServer/Documents/
-sudo chmod 2755 gitweb.cgi
+cp /usr/local/share/gitweb/static/git-logo.png /Library/WebServer/Documents/
+
+cp /usr/local/share/gitweb/static/gitweb.css /Library/WebServer/Documents/
+
+cp /usr/local/share/gitweb/static/gitweb.js /Library/WebServer/Documents/
+
+
+sudo chmod 2755 /Library/WebServer/CGI-Executables/gitweb.cgi
+
+sudo chmod 2755 /Library/WebServer/Documents/git-favicon.png
+
+sudo chmod 2755 /Library/WebServer/Documents/git-logo.png
+
+sudo chmod 2755 /Library/WebServer/Documents/gitweb.css
+
+sudo chmod 2755 /Library/WebServer/Documents/gitweb.js
## installing xapian:
@@ -116,19 +126,55 @@ sudo make install
it installed without issue so I'm baffled why it didn't install from command line.
-
+
+ ## setup file
+ _!/usr/bin/perl
+ _ Ikiwiki setup automator.
+
+ _ 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,
+ )
+
## turning on search plugin:
-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
-
-find / -name "omega" -print
-
-and found the omega program in
+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".
-/usr/local/lib/xapian-omega/bin/omega.
+Then I went into the 2wiki.setup file and replaced the bad path, updated and badda-boom badda-bing.
-Then I went into the setup file and replaced the bad path, updated and badda-boom badda-bing.
-Then I fell asleep.