ikiwiki/doc/install/discussion.mdwn

I am trying to install Ikiwiki version 2.1 from the source tarball.

It has all gone fairly smoothly until I try and run 'make'.

I.e. I have downloaded and unpacked ikiwiki_2.1.tar.gz and have run

    perl Makefile.PL

... which has run OK.


However when I then run 'make' I get:-

    LANG=C perl -I.  -T ikiwiki.out doc html --templatedir=templates \
                    --underlaydir=basewiki --nousedirs\
                    --wikiname="ikiwiki" --verbose \
                    --exclude=/discussion --no-discussion --userdir=users \
                    --plugin=goodstuff \
                    --plugin=haiku --plugin=polygen --plugin=fortune
    Failed to load plugin IkiWiki::Plugin::mdwn: IkiWiki version 2 required--this is only version 1.01 at IkiWiki/Plugin/mdwn.pm line 7.
    BEGIN failed--compilation aborted at IkiWiki/Plugin/mdwn.pm line 7.
    Compilation failed in require at (eval 4) line 2.
    BEGIN failed--compilation aborted at (eval 4) line 2.

    make: *** [extra_build] Error 1
 
How do I fix this?  There may be a bit of old ikiwiki left behind because
I did once have an older version installed but I thought I had removed all
traces of it.

> I'm quite sure that you still have some of it floating around, since
> ikiwiki seems to be loading an old IkiWiki.pm.
> 
> I don't understand though why it's not finding ./IkiWiki.pm first. The
> `-I` in the command line should make it look for files in the current
> directory first. --[[Joey]]

Well I have searched around and there really is nothing left that I can see.

I have removed *everything* found by 'find' and 'locate' that contains 'ikiwiki' except the tar file
and started from the beginning again and I see exactly the same error.

Is it that I maybe have a too old version of some of the Perl dependencies?  The only mdwn.pm files
that I have are the two I have just extracted from the new tar file.  There is *no* ./IkiWiki.pm file

> It's interesting that you say you have no ./IkiWiki.pm file, since one is
> included in the tarball. What happened to it, I wonder? 

so what/where is it loading to satisfy the ....... aaaaaaaaaaahhhhhhhhhhhhhh!!!!!!

I wasn't noticing the case of the filename, I'd missed the upper case W and guess what 'find' shows me:-

    /usr/local/lib/perl5/site_perl/5.8.8/IkiWiki.pm

Removing the above file has fixed my basic problem, now I'm getting lots of (non-fatal) errors
about "Can't locate Locale/gettext.pm", presumably that's a missing Perl module, I can probably
sort that out.


## Errors when running 'make test'

OK, I've now got it to compile and install and presumably it's basically working.  However there
are a few errors when I run 'make test'.  Several errors have disappeared by installing more Perl
stuff (specifically XML::SAX) 

> XML::SAX is a requirement of XML::Simple, which is a documented build
> requirement. (Only really needed if you'll be using subversion actually).

and one error disappeared when I did a 'make install', i.e. the 'make
test' has a test which requires IkiWiki to be installed first.

> Yes, that bug is already fixed in subversion for the next release
> --[[Joey]]

However I'm still getting the following error in 'make test':-

	t/pagename.................ok                                                
	t/pagespec_match...........ok 1/52Modification of a read-only value attempted at /home/chris/webdev/ikiwiki/blib/lib/IkiWiki.pm line 1023.
	# Looks like you planned 52 tests but only ran 23.
	# Looks like your test died just after 23.
	t/pagespec_match...........dubious                                           
	        Test returned status 255 (wstat 65280, 0xff00)
	DIED. FAILED tests 24-52
	        Failed 29/52 tests, 44.23% okay
	t/pagespec_merge...........ok                                                

> What version of perl are you using? It seems to have some problem with
> operator overloading.
> --[[Joey]]

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.