Return-Path: 
 <user-return-3437-apmail-forrest-user-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-user-archive@www.apache.org
Received: (qmail 63873 invoked from network); 20 Mar 2006 22:06:45 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 20 Mar 2006 22:06:45 -0000
Received: (qmail 91300 invoked by uid 500); 20 Mar 2006 22:06:44 -0000
Delivered-To: apmail-forrest-user-archive@forrest.apache.org
Received: (qmail 91267 invoked by uid 500); 20 Mar 2006 22:06:44 -0000
Mailing-List: contact user-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:user-help@forrest.apache.org>
list-unsubscribe: <mailto:user-unsubscribe@forrest.apache.org>
List-Post: <mailto:user@forrest.apache.org>
Reply-To: user@forrest.apache.org
List-Id: <user.forrest.apache.org>
Delivered-To: mailing list user@forrest.apache.org
Received: (qmail 91258 invoked by uid 99); 20 Mar 2006 22:06:43 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 20 Mar 2006 14:06:43 -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 [212.23.3.142] (HELO rutherford.zen.co.uk) (212.23.3.142)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 20 Mar 2006 14:06:43 -0800
Received: from [82.69.78.226] (helo=[192.168.0.2])
	by rutherford.zen.co.uk with esmtp (Exim 4.34)
	id 1FLSW4-0000IR-B6
	for user@forrest.apache.org; Mon, 20 Mar 2006 22:06:20 +0000
Message-ID: <441F2753.3020302@apache.org>
Date: Mon, 20 Mar 2006 22:06:11 +0000
From: Ross Gardler <rgardler@apache.org>
User-Agent: Mozilla Thunderbird 1.0 (Windows/20041206)
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: user@forrest.apache.org
Subject: Re: Hiding sections
References: <5608fb200603200920s354b3323vfcc055112488a2fd@mail.gmail.com>
	 <70120C24-058E-48F4-8185-D194990636DE@gmail.com>
	 <441F0D77.4090204@apache.org>
	 <BC9B1699-0526-45E1-90B5-82678C7CD8FB@gmail.com>
 <5608fb200603201348j4c4f9a22k78be7c789c7b8250@mail.gmail.com>
In-Reply-To: <5608fb200603201348j4c4f9a22k78be7c789c7b8250@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Originating-Rutherford-IP: [82.69.78.226]
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Flavio Cordova wrote:
>>> However, this
>>>approach is much more difficult to implement and requires fairly
>>>detailed knowledge of the internals of Forrest.
> 
> 
> Should I understand this as "forget about it" ? :-D

Either that or it was a challenge ;-)

> Supposing I was crazy enought to try, where should I start ? :-)
> First, how would I flag which sections I wan't to render and which I don't ?

I would recomend using the class attribute for both solutions:

<section class="user">
   <title>some user instructions</title>
   ...
</section>

<section class="dev">
   <title>some dev instructions</title>
   ...
</section>

This way you can easily switch between the two different imemntation 
methods (XSL or CSS) without touching your sources.

Next you need to create a custom skin [1]. The file you will need to 
work with is document2html.xsl

I think I originally suggested passing a parameter in from the sitemap. 
Forget that. My second idea is better, add an attribute to skinconf.xml. 
There are already examples in the above xsl showing how to extract 
settings from skinconf.xml in order to make a decision on what to 
include/exclude in the output.

Note, using skinconf is not really correct. That file should specifiy 
skin configuration, not content. But it will get you up and running 
quickly. If you want to use the "proper" way (forrest.properties). We 
can revisit it when you have the above working.

Ross


[1] http://forrest.apache.org/docs_0_70/your-project.html#skins