From user-return-3069-apmail-forrest-user-archive=forrest.apache.org@forrest.apache.org Mon Jan 02 23:27:42 2006 Return-Path: Delivered-To: apmail-forrest-user-archive@www.apache.org Received: (qmail 3330 invoked from network); 2 Jan 2006 23:27:42 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 2 Jan 2006 23:27:42 -0000 Received: (qmail 44653 invoked by uid 500); 2 Jan 2006 23:27:41 -0000 Delivered-To: apmail-forrest-user-archive@forrest.apache.org Received: (qmail 44613 invoked by uid 500); 2 Jan 2006 23:27:40 -0000 Mailing-List: contact user-help@forrest.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: user@forrest.apache.org List-Id: Delivered-To: mailing list user@forrest.apache.org Received: (qmail 44601 invoked by uid 99); 2 Jan 2006 23:27:40 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 02 Jan 2006 15:27:40 -0800 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: neutral (asf.osuosl.org: local policy) Received: from [65.77.211.84] (HELO www2.kc.aoindustries.com) (65.77.211.84) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 02 Jan 2006 15:27:39 -0800 Received: from fo2.kc.aoindustries.com (www2.kc.aoindustries.com [65.77.211.84]) by www2.kc.aoindustries.com (8.13.1/8.13.1) with ESMTP id k02NRHtt006179 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 2 Jan 2006 17:27:18 -0600 Received: from localhost (localhost [[UNIX: localhost]]) by fo2.kc.aoindustries.com (8.13.1/8.13.1/Submit) id k02NRHbW006100 for user@forrest.apache.org; Mon, 2 Jan 2006 17:27:17 -0600 X-Authentication-Warning: fo2.kc.aoindustries.com: indexgeo set sender to crossley@apache.org using -f Date: Tue, 3 Jan 2006 10:27:09 +1100 From: David Crossley To: user@forrest.apache.org Subject: Re: [Fwd: [mail@leosimons.com: Re: [RT] Super Simple Site Generation Tool]] Message-ID: <20060102232709.GA12661@igg.indexgeo.com.au> References: <43B67B35.5090006@apache.org> <43B67C2A.8030604@apache.org> <20060102054037.GA11858@igg.indexgeo.com.au> <43B8C2B3.8090303@apache.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <43B8C2B3.8090303@apache.org> User-Agent: Mutt/1.4i X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Ross Gardler wrote: > David Crossley wrote: > >Ross Gardler wrote: > >>Leo Simons wrote: > > >>>Even if it works once I get forrest built > >>>(why do I need to build anything?) > >> > >>You don't have to build anything, just download a binary distribution, > >>this is more misinformation. > > > >Actually, sorry to say Ross, this time you are > >spreading the mis-information. The Incubator docs > >are very clear about using the current forrest_07_branch. > >http://incubator.apache.org/guides/website.html > > OK, sorry, I didn't realise there were bug fixes in the branch. If they > are critical we should consider a 0.7.1 release. If they are only for > Incubator (and they stay with Forrest) we should consider providing > "stable snapshots" (see thread on dev). The trouble is that we might need even more modifications. We would already probably be up to 0.7.2 if we took that approach. Forrest project is too small to cope with that. Perhaps your "stable snapshots" idea will work. More on dev. > >>>I have no idea what the first two columns mean. They don't seem to > >>correspond > >>>to anything, since the numbers change at random between pages. Ugh. > >> > >>You know I don't know what they mean either. I never bothered to find > >>out because I never needed to know and I never saw a user question that > >>involved them. > > > >They are explicitly explained in the build output > >and there is a nice FAQ about it. I find them > >extremely useful and would like them to remain. > > They are explained in the FAQ, but not in the build output: > > # Column 2 is the page count - the number of pages processed and the > number remaining. The latter will change because during processing one > page, Cocoon will discover more. > # Column 3 is the number of links that were gathered from that page. > > (I'm guessing Leo was actually referring to the second two columns since > he refers to numbers and the first is indeed explained in the build output) Ah yeah, sorry they are only fully-explained via the build output in 0.8-dev (damn our holdups between releases). > >>this is an often > >>requested feature. We are a little limited by Cocoon here, but it is > >>possible to manually edit a config file that will restrict the > >>generation to a limited number of pages. Problem there is the need to > >>manually edit the file - too complex. > > > >This is because Cocoon crawls the site looking for > >links to build. Perhaps the navigation has changed > >to add other menu items to this page. Perhaps the > >skin has changed. So perhaps Cocoon needs to re-build > >every page. I cannot see how or why we would change this. > > One has to be very careful about this. If I fix a spelling error in a > single page of a 500 page site, I really don't want to generate all 500 > pages. It would be good to just generate that single page... > > >There are FAQs about generating single pages. > >It is not hard. However this is a dangerous thing > >to do. It would be easy to end up with a site > >that is out-of-sync. > > Yes, there are FAQs. But we know people don't read docs, our discussions > on the Incubator list prove it. Well i am not sure what that Incubator discussion proves. If they had asked questions, then we could have pointed to FAQs about techniques. > For me, the question is can we make it even simpler than it already is? > I think we can, see proposal on dev list. Thanks for trying. -David