web commit by JeremyReed: new topic: install selected docs?

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

diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn
index 0539a6f75d5aa0e5396ebe38bb66d8f04da7d231..99d029f355708c3c61f03ffd2d470485ed74ac86 100644 (file)
--- a/doc/index/discussion.mdwn
+++ b/doc/index/discussion.mdwn
@@ -27,6 +27,22 @@ 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
+
+----
+

 # Upgrade steps
 
 I upgrades from 1.40  to 2.6.1. I ran "ikiwiki --setup" using my existing ikiwiki.setup configuration.
 # Upgrade steps
 
 I upgrades from 1.40  to 2.6.1. I ran "ikiwiki --setup" using my existing ikiwiki.setup configuration.


@@ -84,6 +100,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).
 
 >> 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?
 (I am posting this now, but will do some research and post some more.)
 
 Is there any webpage with upgrade steps?


@@ -91,10 +112,12 @@ Is there any webpage with upgrade steps?
 > Users are expected to read [[news]], which points out any incompatible
 > changes or cases where manual action is needed.
 
 > Users are expected to read [[news]], which points out any incompatible
 > changes or cases where manual action is needed.
 

->> I read it but read the userdirs option wrong :(.
+>> I read it but read the usedirs option wrong :(.

 >> 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?
 
 >> 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.
 --JeremyReed
 
 My followup: I used a new ikiwiki.setup based on the latest version. But no changes for me.


@@ -143,6 +166,26 @@ Now ikiwiki is working for me again (but using 1.40). I shouldn't have tested on
 
 --JeremyReed
 
 
 --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.)
+
+I am now using ikiwiki 2.6.1 on my testing system.
+
+--JeremyReed
+

 ----
 # Excellent - how do I translate a TWiki site?
 
 ----
 # Excellent - how do I translate a TWiki site?