web commit by JeremyReed: reply about install requirements link

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

diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn
index a1dbeb0a711d7f92c0140df2fed6b4785e70e7b0..e5e65d4285490df958376917e85d9bee717a2d4c 100644 (file)
--- a/doc/index/discussion.mdwn
+++ b/doc/index/discussion.mdwn
@@ -27,6 +27,27 @@ of via syslog?
 
 ----
 
+# Installation of selected docs (html)
+
+The latest release has around 560 files (over 2MB) in html.
+
+Any suggestions or ideas on limiting what html is installed?
+
+For example, I don't see value in every ikiwiki install out there to also install personal "users" ikiwiki pages.
+
+For now I copy ikiwiki.setup. And then use pax with -L switch to copy the targets of the symlinks of the basewiki.
+
+I was thinking of making a list of desired documents from the html directory to install.
+
+--JeremyReed
+
+> You don't need any of them, unless you want to read ikiwiki's docs locally.
+> 
+> I don't understand why you're installing the basewiki files manually;
+> ikiwiki has a Makefile that will do this for you. --[[Joey]]
+
+----
+
 # Upgrade steps
 
 I upgrades from 1.40  to 2.6.1. I ran "ikiwiki --setup" using my existing ikiwiki.setup configuration.
@@ -84,6 +105,11 @@ but I still have empty pages for editing (no textbox no html at all).
 >> Not using apache. Nothing useful in logs other thn the HTTP return codes are "0" and bytes is "-"
 >> on the empty ikiwiki.cgi output (should say " 200 " followed by bytes).
 
+>>> You need to either figure out what your web server does with stderr
+>>> from cgi programs, or run ikiwiki.cgi at the command line with an
+>>> appropriate environment so it thinks it's being called from a web
+>>> server, so you can see how it's failing. --[[Joey]]
+
 (I am posting this now, but will do some research and post some more.)
 
 Is there any webpage with upgrade steps?
@@ -95,6 +121,8 @@ Is there any webpage with upgrade steps?
 >> Also it appears to be missing the news from between 1.40 to 2.0 unless they dont' exist.
 >> If they do exist maybe they have release notes I need?
 
+>>> All the old ones are in the NEWS file. --[[Joey]]
+
 --JeremyReed
 
 My followup: I used a new ikiwiki.setup based on the latest version. But no changes for me.
@@ -143,6 +171,31 @@ Now ikiwiki is working for me again (but using 1.40). I shouldn't have tested on
 
 --JeremyReed
 
+I am back. On a different system, I installed ikiwiki 2.6.1. Same problem -- blank CGI webpage.
+
+So I manually ran with:
+
+    REQUEST_METHOD=GET QUERY_STRING='do=create&page=jcr' kiwiki.cgi
+
+And clearly saw the error:
+
+    [IkiWiki::main] Fatal: Bad template engine CGI::FormBuilder::Template::div: Can't locate CGI/FormBuilder/Template/div.pm
+
+So I found my version was too old and 3.05 is the first to provide "Div" support. I upgraded my p5-CGI-FormBuilder to 3.0501.
+And ikiwiki CGI started working for me.
+
+The Ikiwiki docs about this requirement got removed in Revision 4367. There should be a page that lists the requirements.
+(I guess I could have used the debian/control file.)
+
+> There is a page, [[install]] documents that 3.05 is needed.
+
+>> Sorry, I missed that. With hundreds of wikipages it is hard to read all of them.
+>> I am updating the download page now to link to it.
+
+I am now using ikiwiki 2.6.1 on my testing system.
+
+--JeremyReed
+
 ----
 # Excellent - how do I translate a TWiki site?