web commit by http://vibrog.myopenid.com/

[ikiwiki.git] / doc / install / discussion.mdwn

diff --git a/doc/install/discussion.mdwn b/doc/install/discussion.mdwn
index 60a059089e2b86920b17b3a7217aa557ccd114a6..64d57cf2117bb85ca5e424ad56539e744cf17f1e 100644 (file)
--- a/doc/install/discussion.mdwn
+++ b/doc/install/discussion.mdwn
@@ -91,3 +91,67 @@ However I'm still getting the following error in 'make test':-
 home$ perl -v
 
 This is perl, v5.8.8 built for i486-linux
+
+## Installation in a non-root enviroment
+I had a pretty hellacious time installing Ikiwiki (largely due to problems
+in Perl) and documented them in [[tips/SharedHosting]].  I'd like to get feedback on the doc and also know if I should file a few bugs to make the installation process a little friendlier to non-root folks.  Thanks for the great app!
+
+
+## Typing error?
+
+[..] Mail::Sendmail, TimeDate, RPC::XML, [..]: should be DateTime? --[[vibrog]]
+
+> No, TimeDate and DateTime are two different CPAN modules. Ikiwiki uses
+> TimeDate. --[[Joey]]
+
+ah, i still don't fully get it, though (the following is slightly shortened):
+
+    $ perl -MCPAN -e shell
+    cpan> install DateTime
+    DateTime is up to date.
+    cpan> install TimeDate
+    Warning: Cannot install TimeDate, don't know what it is.
+    Try the command
+        i /TimeDate/
+    to find objects with matching identifiers.
+
+I'm trying to build IkiWiki on a fresh OpenSuse 10.3 box. I start out with
+
+    $ perl -MCPAN -e 'install Text::Markdown URI HTML::Parser HTML::Template HTML::Scrubber'
+    $ git clone git://git.ikiwiki.info/ ikiwiki && cd ikiwiki
+    $ perl Makefile.PL && make
+
+Are there other prerequisites?
+I also installed all optional Perl modules, except TimeDate.
+
+> TimeDate is also, confusingly, known as Date::Parse. Perhaps CPAN would
+> do better with that name. --[[Joey]]
+
+good. Date::Parse was already installed. --[[vibrog]]
+
+`make` exits with `make: *** [extra_build] Aborted`, `make test` complains `cannot stat 'ikiwiki.man'` --[[vibrog]]
+
+> If you show me the actual error message, and not just the last line make
+> outputs, I might be able to help. --[[Joey]]
+
+    ..
+    rendering todo/calendar_--_archive_browsing_via_a_calendar_frontend.mdwn
+    make: *** [extra_build] Segmentation fault
+
+Repeating `make` ends with this:
+
+    ..
+    scanning logo.mdwn
+    docwiki.setup: html/logo.html independently created, not overwriting with version from logo
+    BEGIN failed--compilation aborted at (eval 6) line 21.
+    make: *** [extra_build] Error 255
+
+`make test` says
+
+    t/basewiki_brokenlinks.....ok 1/0install: cannot stat `ikiwiki.man': No such file or directory
+    make[1]: *** [extra_install] Error 1
+    #   Failed test at t/basewiki_brokenlinks.t line 8.
+    t/basewiki_brokenlinks.....ok 4/0# Looks like you failed 1 test of 7.        
+    t/basewiki_brokenlinks.....dubious   
+    ..
+    Failed 1/22 test scripts, 95.45% okay. 1/483 subtests failed, 99.79% okay.