]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/commitdiff
Merge OS X advice, and add mine.
authorAmitai Schlair <schmonz-web-ikiwiki@schmonz.com>
Fri, 24 Jun 2011 21:35:14 +0000 (17:35 -0400)
committerAmitai Schlair <schmonz-web-ikiwiki@schmonz.com>
Fri, 24 Jun 2011 21:35:14 +0000 (17:35 -0400)
doc/tips/Install_ikiwiki_on_Mac_OS_X___91__Snow__93___Leopard_via_MacPorts.mdwn [deleted file]
doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn [deleted file]
doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard/discussion.mdwn [deleted file]
doc/tips/ikiwiki_on_mac_os_x.mdwn [new file with mode: 0644]
doc/tips/ikiwiki_on_mac_os_x/discussion.mdwn [new file with mode: 0644]

diff --git a/doc/tips/Install_ikiwiki_on_Mac_OS_X___91__Snow__93___Leopard_via_MacPorts.mdwn b/doc/tips/Install_ikiwiki_on_Mac_OS_X___91__Snow__93___Leopard_via_MacPorts.mdwn
deleted file mode 100644 (file)
index 0d68cc8..0000000
+++ /dev/null
@@ -1,18 +0,0 @@
-The easiest way of installing ikiwiki on Mac OS X [Snow] Leopard and Tiger is via MacPorts: <http://www.macports.org/>
-
-This project ports Open Source software into Mac Os X platform.
-It's very easy to intall ikiwiki via MacPorts:
-
-1.- Donwnload and install MacPorts port manager from:  <http://www.macports.org/install.php> . 
-    Port manager installs via Mac Os X installer. Prerequisite: XCode.
-    Se above URL for details
-
-2.- Run 
-
-    $ sudo port install ikiwiki
-
-This installs ikiwiki and all of its dependencies
-
-enjoy
-
-Enrique Castilla
diff --git a/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn
deleted file mode 100644 (file)
index bb1db0c..0000000
+++ /dev/null
@@ -1,184 +0,0 @@
-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. 
-
-The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.
-
-
-## 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 
-
-make prefix=/usr/local all
-
-sudo make install
-
-
-git config --global user.name "firstname lastname" 
-
-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 /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.
-
-cd ..
-
-git clone git://git.ikiwiki.info/
-
-cd git.ikiwiki.info/
-
-perl Makefile.PL  LIB=/Library/Perl/5.10.0
-
-make
-
-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.
-
-
-## using git from inside a git folder:
-
-start with git clone, then learn to do the git dance like this.
-
-git pull
-
-make your changes to your clone
-
-git commit -a -m "message here"
-
-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
-
-cd ../git-1.7.3.1/gitweb
-
-make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb.css" GITWEB_LOGO="/git-logo.png" GITWEB_FAVICON="/git-favicon.png" GITWEB_JS="/gitweb.js"
-
-cp gitweb.cgi /Library/WebServer/CGI-Executables/
-
-cp /usr/local/share/gitweb/static/git-favicon.png /Library/WebServer/Documents/
-
-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:
-
-download xapian and omega
-
-I needed pcre: sudo ports install pcre
-
-./configure
-
-make
-
-sudo make install
-
-
-## 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.
-
-./configure
-
-make
-
-sudo make install
-
-
-## 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.
-
-perl Makefile.PL
-
-make
-
-make test
-
-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 "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".
-
-Then I went into the 2wiki.setup file and replaced the bad path, updated and badda-boom badda-bing.
-
-
-
diff --git a/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard/discussion.mdwn b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard/discussion.mdwn
deleted file mode 100644 (file)
index ae39698..0000000
+++ /dev/null
@@ -1 +0,0 @@
-If you want do a bunch of manual labor, this is good, but most people probably want to get ikiwiki via a package system. My Mac laptop's ikiwiki is installed from pkgsrc.  --[[schmonz]]
diff --git a/doc/tips/ikiwiki_on_mac_os_x.mdwn b/doc/tips/ikiwiki_on_mac_os_x.mdwn
new file mode 100644 (file)
index 0000000..a4c693e
--- /dev/null
@@ -0,0 +1,220 @@
+[[!toc]]
+
+# MacPorts
+
+The easiest way of installing ikiwiki on Mac OS X [Snow] Leopard and Tiger is via MacPorts: <http://www.macports.org/>
+
+This project ports Open Source software into Mac Os X platform.
+It's very easy to intall ikiwiki via MacPorts:
+
+1.- Donwnload and install MacPorts port manager from:  <http://www.macports.org/install.php> . 
+    Port manager installs via Mac Os X installer. Prerequisite: XCode.
+    Se above URL for details
+
+2.- Run 
+
+    $ sudo port install ikiwiki
+
+This installs ikiwiki and all of its dependencies
+
+enjoy
+
+Enrique Castilla
+
+-----
+
+# pkgsrc
+
+The other easiest way of installing ikiwiki on Mac OS X is via
+[pkgsrc](http://www.pkgsrc.org/).
+
+7. Bootstrap pkgsrc.
+7. Run
+
+    $ cd .../pkgsrc/www/ikiwiki && make install clean
+
+-----
+
+# Manual install
+
+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. 
+
+The best part of installing ikiwiki was learning how to use git. I never used source control before but its pretty slick.
+
+
+## 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 
+
+make prefix=/usr/local all
+
+sudo make install
+
+
+git config --global user.name "firstname lastname" 
+
+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 /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.
+
+cd ..
+
+git clone git://git.ikiwiki.info/
+
+cd git.ikiwiki.info/
+
+perl Makefile.PL  LIB=/Library/Perl/5.10.0
+
+make
+
+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.
+
+
+## using git from inside a git folder:
+
+start with git clone, then learn to do the git dance like this.
+
+git pull
+
+make your changes to your clone
+
+git commit -a -m "message here"
+
+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
+
+cd ../git-1.7.3.1/gitweb
+
+make GITWEB_PROJECTROOT="/opt/ikiwiki/" GITWEB_CSS="/gitweb.css" GITWEB_LOGO="/git-logo.png" GITWEB_FAVICON="/git-favicon.png" GITWEB_JS="/gitweb.js"
+
+cp gitweb.cgi /Library/WebServer/CGI-Executables/
+
+cp /usr/local/share/gitweb/static/git-favicon.png /Library/WebServer/Documents/
+
+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:
+
+download xapian and omega
+
+I needed pcre: sudo ports install pcre
+
+./configure
+
+make
+
+sudo make install
+
+
+## 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.
+
+./configure
+
+make
+
+sudo make install
+
+
+## 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.
+
+perl Makefile.PL
+
+make
+
+make test
+
+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 "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".
+
+Then I went into the 2wiki.setup file and replaced the bad path, updated and badda-boom badda-bing.
diff --git a/doc/tips/ikiwiki_on_mac_os_x/discussion.mdwn b/doc/tips/ikiwiki_on_mac_os_x/discussion.mdwn
new file mode 100644 (file)
index 0000000..ae39698
--- /dev/null
@@ -0,0 +1 @@
+If you want do a bunch of manual labor, this is good, but most people probably want to get ikiwiki via a package system. My Mac laptop's ikiwiki is installed from pkgsrc.  --[[schmonz]]