web commit from 217.16.16.218: poll vote (No opinion)

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

diff --git a/doc/index/discussion.mdwn b/doc/index/discussion.mdwn
index 0539a6f75d5aa0e5396ebe38bb66d8f04da7d231..5274b21562bbf28fa926498199c53f3e2c46a947 100644 (file)
--- a/doc/index/discussion.mdwn
+++ b/doc/index/discussion.mdwn
@@ -27,6 +27,36 @@ 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]]
+
+>> The Makefile's install doesn't do what I want so I use different installer for it.
+>> It assumes wrong location for man pages for me. (And it should consider using INSTALLVENDORMAN1DIR and
+>> MAN1EXT but I don't know about section 8 since I don't know of perl value for that.)
+>> I don't want w3m cgi installed; it is optional for my package.
+>> I will just patch for that instead of using my own installer.
+>> Note: I am working on the pkgsrc package build specification for this. This is for creating
+>> packages for NetBSD, DragonFly and other systems that use pkgsrc package system.
+>> --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 +114,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 +126,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 +180,31 @@ 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.)
+
+> 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?
 
 ----
 # Excellent - how do I translate a TWiki site?