(no commit message)

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 2c3428b3f411a21f12c38d19ff7f857453281bde..4eb084f38d81f48c42b9b8c0b68da7db343b9e6f 100644 (file)
--- a/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
+++ b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
@@ -2,44 +2,71 @@ These are some notes on installing ikiwiki on Mac OS X Snow Leopard. I have a th
 
 The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.
 
 
 The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.
 

+

 ## installing git:
 
 curl http://kernel.org/pub/software/scm/git/git-(latest version).tar.gz -O
 ## installing git:
 
 curl http://kernel.org/pub/software/scm/git/git-(latest version).tar.gz -O

+

 tar xzvf git-(latest version).tar.gz
 tar xzvf git-(latest version).tar.gz

+

 cd git-(latest version)
 cd git-(latest version)

+

 ./configure --prefix=/usr/local
 ./configure --prefix=/usr/local

+

 NO_MSGFMT=yes make prefix=/usr/local all
 NO_MSGFMT=yes make prefix=/usr/local all

+

 sudo make install
 
 sudo make install
 

+

 git config --global user.name "firstname lastname" 
 git config --global user.name "firstname lastname" 

+

 git config --global user.email "email here"
 git config --global user.email "email here"

+

 git config --global color.ui "auto" 
 
 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/
 
 
 ## installing ikiwiki:
 I had terrible trouble installing ikiwiki. It turned out I had accidentally installed Perl through ports. Uninstalling that made everything install nicely.
 curl http://www.kernel.org/pub/software/scm/git/git-manpages-1.7.3.1.tar.gz | sudo tar -xzC /opt/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 like to install test software in /opt. No particular reason. You could install to defaults.
 
 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
 perl Makefile.PL PREFIX=/Library/Perl/5.10.0 LIB=/Library/Perl/5.10.0

+

 perl Makefile.PL  LIB=/Library/Perl/5.10.0
 perl Makefile.PL  LIB=/Library/Perl/5.10.0

+

 make
 make

+

 make install
 make install

+

 sudo install -d /opt/ikiwiki
 sudo install -d /opt/ikiwiki

+

 sudo install -m 0644 wikilist /opt/ikiwiki
 sudo install -m 0644 wikilist /opt/ikiwiki

+

 sudo install -m 0644 auto.setup /opt/ikiwiki
 sudo install -m 0644 auto.setup /opt/ikiwiki

+

 sudo install -m 0644 auto-blog.setup /opt/ikiwiki
 
 sudo install -m 0644 auto-blog.setup /opt/ikiwiki
 

+

 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.
 
 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.
 

+

 ## using git from inside a git folder:
 ## using git from inside a git folder:

+

 start with git clone, then learn to do the git dance like this.
 start with git clone, then learn to do the git dance like this.

+

 git pull
 git pull

+

 make your changes to your clone
 make your changes to your clone

+

 git commit -a -m "message here"
 git commit -a -m "message here"

+

 git push
 
 git push
 

+

 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.
 
 ## installing gitweb
 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.
 
 ## installing gitweb


@@ -47,35 +74,61 @@ When you can't get into the setup page or you get strange behavior after a setup
 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
 
 cp gitweb.cgi /Library/WebServer/CGI-Executables/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
 
 cp gitweb.cgi /Library/WebServer/CGI-Executables/gitweb/

+

 sudo chmod 2755 gitweb.cgi
 
 sudo chmod 2755 gitweb.cgi
 

+

 ## installing xapian:
 ## installing xapian:

+

 download xapian and omega
 download xapian and omega

+

 I needed pcre: sudo ports install pcre
 
 ./configure
 I needed pcre: sudo ports install pcre
 
 ./configure

+

 make
 make

+

 sudo make install
 
 sudo make install
 

+

 ## installing omega:
 ## installing omega:

+

 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.
 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.

+

 ./configure
 ./configure

+

 make
 make

+

 sudo make install
 
 sudo make install
 

+

 ## installing Search::Xapian from CPAN
 ## installing Search::Xapian from CPAN

+

 for some reason this wouldn't install using CPAN console so I went to CPAN online and downloaded the source.
 for some reason this wouldn't install using CPAN console so I went to CPAN online and downloaded the source.

+

 perl Makefile.PL
 perl Makefile.PL

+

 make
 make

+

 make test
 make test

+

 sudo make install
 sudo make install

+

 it installed without issue so I'm baffled why it didn't install from command line.
 
 it installed without issue so I'm baffled why it didn't install from command line.
 

+
+

 ## turning on search plugin:
 ## 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 
 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
 find / -name "omega" -print

+

 and found the omega program in 
 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 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.
 Then I fell asleep.