Summary: | Example XML syntax for Ant manual + matching XSLs | ||
---|---|---|---|
Product: | Ant | Reporter: | Dominique Devienne <ddevienne> |
Component: | Documentation | Assignee: | Ant Notifications List <notifications> |
Status: | NEW --- | ||
Severity: | enhancement | ||
Priority: | P2 | ||
Version: | 1.7.0 | ||
Target Milestone: | --- | ||
Hardware: | Other | ||
OS: | other | ||
Attachments: |
ZIP file with XML+XSL files (+comparison HTML files)
Updated XSLs |
Description
Dominique Devienne
2005-03-21 23:56:51 UTC
Created attachment 14529 [details]
ZIP file with XML+XSL files (+comparison HTML files)
Nice stuff in it. Especially the google and bugzilla search :-) When looking into the WHATSNEW I played a little bit the these templates. It would be nice if the taskname could be linked to the manual page. Because it´s not easy to find the right link destination (CoreTypes|OptionalTasks|...) I adopted the google search. I didn´t change the WHATSNEW.xml, but made two modifications in the XSL: 1) a new template <xsl:template name="w:manual"> <xsl:param name="name"/> <a href="http://www.google.de/search?as_q={$name}&as_occt=title&as_sitesearch=http%3A%2F%2Fant.apache.org%2Fmanual%2F"> <xsl:value-of select="$name" /> </a> </xsl:template> 2) call of that template <xsl:template match="*[starts-with(namespace-uri(), 'antlib:')]"> - <span class="tag"><xsl:value-of select="local-name()" /></span> + <span class="tag"> + <xsl:call-template name="w:manual"> + <xsl:with-param name="name" select="local-name()"/> + </xsl:call-template> + </span> When looking into the manual I see a problem with more complex examples. E.g. in <script> (last example). I know the formatting of the examples is still a bit broken. I've fixed one value-of into a copy of already, but there's still whitespace issues. It's strange, because this XSL code is derived from a stylesheets that correctly styles whole build files. I'll investigate. Nice idea about linking to a Google search for Ant external cross-ref to other tasks. I was thinking of creating links, but I wanted to postpone this until the final structure of the manual emerges. I was hoping for some comment on the XML manual files though (and also the whatsnew vocab too). Too verbose? Should be able to have a DTD/Schema? Etc... Or put another way, is this prototype going in the right direction or not? And should I persue it or abandon it because it's not what the community wants. --DD I'm looking forward to (not really ;-) eight+ hours of train driving tomorrow and will come back after that. Created attachment 14540 [details]
Updated XSLs
Fixed the example space issue + add build.xml. --DD
|