forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Thorsten Scherler <thorsten.scher...@wyona.com>
Subject Re: [jira] Commented: (FOR-797) Move all v3 resources and code to the new plugins
Date Tue, 02 May 2006 10:41:13 GMT
El mar, 02-05-2006 a las 09:20 +0200, Cyriaque Dupoirieux escribió:
> le 29/04/2006 00:25 Ross Gardler a écrit :
> > Cyriaque Dupoirieux wrote:
> >> le 21/04/2006 20:44 Thorsten Scherler a écrit :
> >>
> >>> El vie, 21-04-2006 a las 09:55 +0200, Cyriaque Dupoirieux escribió:
> >>>  
> >>>
> >>>> le 21/04/2006 01:21 Thorsten Scherler (JIRA) a écrit :
> >>>>   
> >>>>>     [ 
> >>>>> http://issues.apache.org/jira/browse/FOR-797?page=comments#action_12375442

> >>>>> ]
> >>>>> Thorsten Scherler commented on FOR-797:
> >>>>> ---------------------------------------
> >>>>>
> >>>>> We should remove following contracts:
> >>>>>
> >>>>> content-feeder.ft -> this is actually a feed2htmlSnippet contract

> >>>>> but to clumpsy
> >>>>> content-main-lenya.ft -> obsolete
> >>>>> content-include-html.ft -> obsolete, can be done with genericXhtml
> >>>>> content-ls-contracts.ft -> never used
> >>>>>         
> >>>>
> >>>> Was this the contract which displayed a list of available contracts

> >>>> (standard and custom) ?
> >>>>     
> >>>
> >>>
> >>> yes, but IMO that is not really suitable since the descriptions are
> >>> quite big.
> >>> Why do you ask, do you think we should keep it?
> >>>   
> >>
> >> If your are talking about the content-ls-contracts, I think it was 
> >> very nice and useful to have an automatic generated documentation of 
> >> every contracts available for a project.
> >> It was also interesting to generate the page and include it in the 
> >> forrest site - in the dispatcher documentation - just like we do with 
> >> the DTDs.
> >
> > Like Cyriaque I don't fully understand the problem that Thorsten sees. 
> 
> > But I do think auto generated documentation like this is a very good idea.
> You do or you don't think ?
> (The "But" at the beginning of your sentence leave me puzzled... )
> 
> Cyriaque,
> > If it is replaced with something better then fine, go ahead and remove 
> > it, otherwise lets keep it since it is the best we have.
> >

To easier recall
http://svn.apache.org/viewcvs.cgi/forrest/trunk/whiteboard/plugins/org.apache.forrest.themes.core/themes/common/html/content-ls-contracts.ft?rev=373373&view=markup

This contracts is waiting for xdocs as input format and will transform
it to html. 

However this transformation can be done with content-main (~-*). The ls
contract was thought to be something like an overview contract (usable
everywhere). It displays the same as
http://localhost:8888/ls.contracts.html but it is *not* used in this
page!

The http://localhost:8888/ls.contracts.html is the overview of all
forrest provided contracts including documentation/usage/... information
about each contract. We use the "normal" content-main/-* contracts to
display this page.

The content-ls-contracts.ft is heavily out of sync (not only the
contract-grammar but as well the awaited input format). Since I have not
seen a useful use case for the contract I thought we should just drop
it.

...but I am happy to keep it. ;) If we decide to keep it needs work to
add some filter as forrest:property to limit the output to a reasonable
set of information and an update of the xsl:templates to reflect current
ls.contracts.xml as input.

salu2
-- 
Thorsten Scherler
COO Spain
Wyona Inc.  -  Open Source Content Management  -  Apache Lenya
http://www.wyona.com                   http://lenya.apache.org
thorsten.scherler@wyona.com                thorsten@apache.org


Mime
View raw message