forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [JIRA] Commented: (FOR-446) Dokumentation: HowTo Customize HTML Processing
Date Wed, 23 Feb 2005 22:51:42 GMT
The following comment has been added to this issue:

     Author: Ross Gardler
    Created: Wed, 23 Feb 2005 4:50 PM
Excellent contribution to our docs. There are a few spelling/grammatical errors, but I've
ignored them for the moment. Here are the more important points:


"In doing the research for this How To, Ross Gardler taucht me so many interesting facts"

- much as I appreciate the acknowledgement we don't directly reference developers in the docs.
This is because over time many people will typically contribute to documents such as this.


"A basic understanding of coocons pipelines and their compontents." 
- perhaps a link to relevant Cocoon docs would be helpful, there are some links on


"If you plan on creating your own custom processing for
				HTML-pages, you'll also need write access to Forrest's
				project directory.


"Follow this link to the <a href="sitemap.xmap.html#%3C%21--Start+of+Sitemap--%3E">start
of the Sitemap.</a>" 

- why a .html file?


"'*.xlex' that would match if our file ended with '.xlex'" 

- it's the request that needs to end with .xlex rather than the file.


&lt;map:match pattern="**/*.html"&gt;
    &lt;map:aggregate element="site"&gt;

- if you use "<source><![CDATA[ ... ]]></source>" 
there is no need to escape the '<' and '>' symbols. 


					<td>the second match</td>

- {2} matches the second match :-)


"At the output of this transformer we will have some rough kind of XHTML."

- probably better to say that we get a valid XML document.


"<fixme>I'm unclear about the calling of skinit here. Why is it called twice (in processing
the body here and the final page later on), what is the difference?.</fixme>"

- the first call skins the body, whilst the second skins the whole page (including layount
of menus and tabs) Note the value of the type parameter in each call.


I'm unclear about the translation from the property project.stylesheets-dir to the variable
{forrest:stylesheets}. How and where does it take place and why are the names different? That
seems very confusing!					

- There is no such translation. The two values are not connected


" <strong>&lt;map:transform src="{forrest:stylesheets}/fixMyBadHTML.xsl"/&gt;</strong>"

- should be src="project:stylesheets-dir/fixMyBadHTML.xsl" 


A complete example, with the stylesheet and the source document would be great. But the document
stands up as a good document even as it is.

Great work!
View this comment:

View the issue:

Here is an overview of the issue:
        Key: FOR-446
    Summary: Dokumentation: HowTo Customize HTML Processing
       Type: Improvement

     Status: Unassigned
   Priority: Minor

    Project: Forrest
             Documentation and website

   Reporter: Ferdinand Soethe

    Created: Wed, 23 Feb 2005 2:24 PM
    Updated: Wed, 23 Feb 2005 4:50 PM

A long HowTo with lots of info on how Forrest processes requests for html document. Requires
checking for facts, language and a few fixmes.

This message is automatically generated by JIRA.

If you think it was sent incorrectly contact one of the administrators:

If you want more information on JIRA, or have a bug to report see:

View raw message