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 [EMAIL PROTECTED] [EMAIL PROTECTED]
