Ross Gardler wrote: > >Author: crossley > >Date: Thu Apr 6 15:47:46 2006 > >New Revision: 392105 > > > >URL: http://svn.apache.org/viewcvs?rev=392105&view=rev > >Log: > >Remove examples of acronym and definition/@cite until we know how to use > >them. > > See inline... > > >Modified: > >forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml > >URL: > >http://svn.apache.org/viewcvs/forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml?rev=392105&r1=392104&r2=392105&view=diff > >============================================================================== > >--- > >forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml > > (original) > >+++ > >forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.input.glossary/src/documentation/content/xdocs/glossary.xml > > Thu Apr 6 15:47:46 2006 > >@@ -23,10 +23,11 @@ > > <title>C</title> > > <item id="CSS"> > > <term>Cascading Style Sheets</term> > >- <acronym>CSS</acronym> > >- <definition cite="http://www.w3.org/Style/CSS/";>Cascading Style > >Sheets (CSS) > >+ <definition>Cascading Style Sheets (CSS) > > is a simple mechanism for adding style (e.g. fonts, colors, > > spacing) to Web > >- documents.</definition> > > Cite is used to link to an original source for the definition. Each > glossary term can have multiple definitions, some of which may not be > our copyright, therefore we need to cite the source.
Yes definitely. That is why i was careful to add this workaround. > >+ documents. > >+ Source: <a href="http://www.w3.org/Style/CSS/";>W3C</a>. That was my workaround because i could not get the @cite to work. The generated html had links that went nowhere. Now that i look more carefully at your example site, i understand more. It seems that it is somehow magically linked to a citations document. Great, however we don't yet have the Citations plugin at Forrest. FOR-756 Also i was getting xml validation errors, e.g. "An element with the identifier "W3C-CSS" must appear in the document." Same with your example document below. > Putting it in the @cite attribute allows us to do this processing in > XSLT. We can do clever stuff like "only show defininitions from the w3c". > > > <item id="SVG"> > > <term>Scalable Vector Graphics</term> > >- <acronym>SVG</acronym> > >- <definition cite="http://www.w3.org/Graphics/SVG/";>SVG is a > >language for describing > >+ <definition>Scalable Vector Graphics (SVG) is a language for > >describing > > two-dimensional graphics and graphical applications in XML. > >+ Source: <a href="http://www.w3.org/Graphics/SVG/";>W3C</a>. > > </definition> > > Again, putting the accronym in an attribute allows us to do powerful > stuff like search for the term associated with this accronym. Why is > this not an attribute? Because some terms have multiple accronyms > > For complete examples, see the glossary.xml file I originally attached > to the issue. This document is rendered at [1]. You can see that the > @cite is rendered by the XSLT in almost the same way you have hard coded > above. The accronyms are also rendered in a similar way to what you ahve > above, for example "Data Definition Language (DDL)". Hmm, i have the acronym stuff working now. Don't know what the problem was. -David > > Ross > > [1] http://www.gardler.org/teaching/glossary.html
