summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/index/discussion.mdwn19
-rw-r--r--doc/install.mdwn12
2 files changed, 25 insertions, 6 deletions
diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn
index e24a31058..610e39ac3 100644
--- a/doc/index/discussion.mdwn
+++ b/doc/index/discussion.mdwn
@@ -14,8 +14,16 @@ compiled and visible. However I have a few issues/problems:-
these are HTML::Template and HTML::Scrubber (at least I think it was these two, it's a bit messy
to go back and find out).
+> You're right, HTML::Template is required. HTML::Scrubber is only required
+> in the default configuration, and is optional if the htmlscrubber plugin
+> is disabled. --[[Joey]]
+
* I don't seem to have got an ikiwiki man page created.
+> It should be installed in /usr/share/man, or a similar directory
+> depending on how your perl is set up and how you did the install.
+> --[[Joey]]
+
* Running "ikiwiki --setup ikiwiki.setup" doesn't do anything. I have edited ikiwiki.setup to
my local settings. There are no errors but neither does anything get compiled. An ikiwiki
command to explicitly do the compile works fine. Am I misunderstanding something here?
@@ -25,6 +33,13 @@ command to explicitly do the compile works fine. Am I misunderstanding somethin
either though it was the command line I originally used to compile. After a long interval I 'touch'ed
the files and then it *did* compile but 'touch'ing the files after a few minutes only doesn't seem to force a recompile. I'm even more confused!
+> ikiwiki only compiles files whose modification times have changed. It
+> should see any change made as close as a second after the last compile.
+> When run with --setup, ikiwiki always rebuilds every file in the wiki. If
+> --setup is not working, you must have it pointed at the wrong path or
+> something; you can pass -v to see what it's doing. I don't know why it
+> would not see recently changed files; you could try stracing it.
+> --[[Joey]]
* I wish there was a mailing list, much easier for this sort of stuff than this, apart from
anything else I get to use a decent editor.
@@ -43,6 +58,10 @@ I'm currently using TWiki and have a fair number of pages in that format, does
anyone have any bright ideas for translating? I can knock up awk scripts fairly
easily, perl is possible (but I'm not strong in perl).
+> Let us know if you come up with something to transition from the other
+> format. Another option would be writing a ikiwiki plugin to support the
+> TWiki format. --[[Joey]]
+
----
# OpenID
diff --git a/doc/install.mdwn b/doc/install.mdwn
index b01fcdf6b..04600b17f 100644
--- a/doc/install.mdwn
+++ b/doc/install.mdwn
@@ -5,13 +5,13 @@ most unix-like systems.
Ikiwiki is a perl program, and needs a recent version of perl such as
5.8.8. (5.8.0 has been reported not to work).
-Ikiwiki requires the [[cpan Text::Markdown]], [[cpan URI]] and
-[[cpan HTML::Parser]] perl modules be installed, and also uses the
-following perl modules if available:
+Ikiwiki requires the [[cpan Text::Markdown]], [[cpan URI]],
+[[cpan HTML::Parser]], and [[cpan HTML::Template]] perl modules be
+installed, and also uses the following perl modules if available:
[[cpan CGI::Session]], [[cpan CGI::FormBuilder]] (version 3.02.02 or newer),
-[[cpan HTML::Template]], [[cpan Mail::Sendmail]], [[cpan Time::Duration]]
-[[cpan TimeDate]], [[cpan HTML::Scrubber]], [[cpan RPC::XML]],
-[[cpan XML::Simple]], [[cpan XML::Feed]], [[cpan File::MimeInfo]].
+[[cpan Mail::Sendmail]], [[cpan Time::Duration]], [[cpan TimeDate]],
+[[cpan HTML::Scrubber]], [[cpan RPC::XML]], [[cpan XML::Simple]],
+[[cpan XML::Feed]], [[cpan File::MimeInfo]].
The [[tla]] support also needs the [[cpan MailTools]] perl module.