From c752be0acb942036a2dfd69dcfde06c17860db34 Mon Sep 17 00:00:00 2001 From: justint Date: Tue, 12 Oct 2010 05:53:32 +0000 Subject: Mac OS X Snow Leopard Installing IkiWiki Tips --- doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn | 81 ++++++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn diff --git a/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn new file mode 100644 index 000000000..2c3428b3f --- /dev/null +++ b/doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn @@ -0,0 +1,81 @@ +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: + +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 +NO_MSGFMT=yes 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 /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. + +perl Makefile.PL PREFIX=/Library/Perl/5.10.0 LIB=/Library/Perl/5.10.0 +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 + +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 + +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 + +## 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. + +## 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 +/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 fell asleep. -- cgit v1.2.3 From 20b94ad9e1f5a401798b6991aeba964267ce3087 Mon Sep 17 00:00:00 2001 From: justint Date: Tue, 12 Oct 2010 05:55:32 +0000 Subject: --- doc/tips/ikiwiki_on_Mac_OS_X_Snow_Leopard.mdwn | 53 ++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) 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 2c3428b3f..4eb084f38 100644 --- 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. + ## installing git: 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 + NO_MSGFMT=yes 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 /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. + perl Makefile.PL PREFIX=/Library/Perl/5.10.0 LIB=/Library/Perl/5.10.0 + 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 + 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 @@ -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/ + sudo chmod 2755 gitweb.cgi + ## 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. + + ## 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 + /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 fell asleep. -- cgit v1.2.3 From b7d4c1e473ccec6d6e21b1ed225f5e4de27a62f5 Mon Sep 17 00:00:00 2001 From: justint Date: Tue, 12 Oct 2010 14:46:35 +0000 Subject: setting Discussion PageSpec? --- doc/forum/Discussion_PageSpec__63__.mdwn | 1 + 1 file changed, 1 insertion(+) create mode 100644 doc/forum/Discussion_PageSpec__63__.mdwn diff --git a/doc/forum/Discussion_PageSpec__63__.mdwn b/doc/forum/Discussion_PageSpec__63__.mdwn new file mode 100644 index 000000000..fb592be48 --- /dev/null +++ b/doc/forum/Discussion_PageSpec__63__.mdwn @@ -0,0 +1 @@ +I've looked around but haven't found it. Can you set a Discussion PageSpec so only certain pages allow discussion? -- cgit v1.2.3 From e6d130877bb374abe9721e497f0d4868b6c952d8 Mon Sep 17 00:00:00 2001 From: justint Date: Wed, 13 Oct 2010 03:03:24 +0000 Subject: --- .../Map_Plugin__44___would_like_to_add___63__updated_to_all_links.mdwn | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links.mdwn diff --git a/doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links.mdwn b/doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links.mdwn new file mode 100644 index 000000000..fcffe690f --- /dev/null +++ b/doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links.mdwn @@ -0,0 +1,3 @@ +Map Plugin, would like to add ?updated to all links created. + +When I edit a page and then click that page in a map in a sidebar Safari always shows me a cached page. -- cgit v1.2.3 From 48c53906bc899364c74a2877ea6e5c5189299e0e Mon Sep 17 00:00:00 2001 From: justint Date: Wed, 13 Oct 2010 05:30:50 +0000 Subject: Added a comment: skip it --- .../comment_1_3fe4c5967e704355f9b594aed46baf67._comment | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links/comment_1_3fe4c5967e704355f9b594aed46baf67._comment diff --git a/doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links/comment_1_3fe4c5967e704355f9b594aed46baf67._comment b/doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links/comment_1_3fe4c5967e704355f9b594aed46baf67._comment new file mode 100644 index 000000000..ce1a78584 --- /dev/null +++ b/doc/forum/Map_Plugin__44___would_like_to_add___63__updated_to_all_links/comment_1_3fe4c5967e704355f9b594aed46baf67._comment @@ -0,0 +1,13 @@ +[[!comment format=mdwn + username="justint" + ip="24.182.207.250" + subject="skip it" + date="2010-10-13T05:30:50Z" + content=""" +skip it, I added + + + + +to my page.tmpl and the problem went away. +"""]] -- cgit v1.2.3 From 71fdabcb494d3f6e62bf755246c480ac7fc17156 Mon Sep 17 00:00:00 2001 From: "https://www.google.com/accounts/o8/id?id=AItOawmbuZI4n1RsTe3Yeaqb5F-yhtR7a8BWEIE" Date: Wed, 13 Oct 2010 09:10:45 +0000 Subject: --- doc/sandbox.mdwn | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/sandbox.mdwn b/doc/sandbox.mdwn index a3a20fd78..c665e67f0 100644 --- a/doc/sandbox.mdwn +++ b/doc/sandbox.mdwn @@ -53,6 +53,7 @@ Bulleted list * [[different_name_for_a_WikiLink|ikiwiki/WikiLink]] * * [GNU](http://www.gnu.org/) +* Joey's blog ---- -- cgit v1.2.3