To current commiters: 
        
        When building the WAR file, I noticed that some  part
of the HTML documentation is incomplete, there are
some graphics files missing, the styling, and some
other things..
        I traced a few bugs, however my question is: 
  Will the documentation by rendered by Cocoon in the
WAR file ? or will you replace the documentation link
with the HTML docs generated by the ant build,already
rendered ? 

    In case it is accorded that cocoon will render de
XML Documentation through XSLT in the WAR file, here
are some bugs I found, 
    If a yes, please advise to continue checking the
docs as they are passed into the WAR.

BUGS:
  
BUG

Directory for images in xdocs is not copied to WAR.

MODIFICATION 

Modify the build.xml file in section WEBAPP
directories: 
Add the following: 
    <copy todir="${build.war}/docs/xdocs/images"
filtering="off">
      <fileset dir="${images.dir}">
        <include name="*.gif"/>
        <include name="*.jpg"/>
        <include name="*.png"/>
      </fileset>
    </copy>

BUG
XSLSheet for HTML documentation fails to render
<figure> tag to <img> 

MODIFICATION
Modify the root2html.xsl sheet in
webapp/stylesheets/documents/
Add the following template to the bottom of the XSL
stylesheet: 
<xsl:template match="body//figure">
   <xsl:element name="img">
        <xsl:for-each select="@*">
          <xsl:attribute name="{name(.)}">
            <xsl:value-of select="."/>
          </xsl:attribute>
        </xsl:for-each>
   </xsl:element>
</xsl:template>  

BUG
No Pipline's (Maps) defined for images (jpg,gif,png)
in HTML documentation 

MODIFICATION 
Add Static maps to sitemap.xmap in webapp:
   <map:match pattern="documents/images/**.gif">
    <map:read src="docs/xdocs/images/{1}.gif"
mime-type="image/gif"/>
   </map:match>

   <map:match pattern="documents/images/**.jpg">
    <map:read src="docs/xdocs/images/{1}.jpg"
mime-type="image/jpg"/>
   </map:match>

   <map:match pattern="documents/images/**.png">
    <map:read src="docs/xdocs/images/{1}.png"
mime-type="image/png"/>
   </map:match>

--



__________________________________________________
Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail
http://personal.mail.yahoo.com/

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Reply via email to