forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Ramon Prades" <rpra...@porcelanosa.com>
Subject RE: document attributs
Date Mon, 25 Aug 2003 06:18:15 GMT
Hi Jeff

I agree having those attributes in the xml doc is mixing layers, but I still
think we need a way to produce slightly different documents. I mean, a flag
in skinconf would disable the TOC in all documents, but not in only a few of
them.

Perhaps site.xml is a better place? It would be something like:

 <index label="Index" href="index.html" notoc="true"/>

Regards.

Ramon


-----Mensaje original-----
De: Jeff Turner [mailto:jefft@apache.org] 
Enviado el: sábado, 23 de agosto de 2003 9:52
Para: forrest-dev@xml.apache.org
Asunto: Re: document attributs


On Fri, Aug 22, 2003 at 12:18:48PM +0200, Ramon Prades wrote:
> Hi all
>  
> Wouldn't it be a good idea to add a bit mnore control on the final 
> appearance of the forrest document.
>  
> One of the things I would like is to be able of telling Forrest when 
> NOT to generate the TOC at the beginning of the rendered document. 
> Another thing I think would be useful is to have control on how deep 
> to scan for "title" elements to generate the above toc (at the moment 
> forrest includes only two levels).
>  
> I think this could be done adding a couple of optional attributes to 
> the root element.
>  
> For example:
>  
> <document notoc="true" >
>  
> This will tell forrest not to generate the TOC for this document.
>  
> Another example:
>  
> <document toclevel="3">
>  
> This will tell forrest to include up to the third level of "title" in 
> the TOC.
>  
> Please share your thoughts with the list and if more people find this 
> could be good I can do it myself and post it here.

Sounds nice.

Whether to generate a toc is up to the skin, which is in the presentation
layer. The flag shouldn't be in the XML content, as that mixes concerns.

How about adding a flag to skinconf.xml for this?

--Jeff

> Thanks
>  
> Ramon Prades
>  




Mime
View raw message