Updated documentation and CSS styles on the ODF reference
<!--
.left { width: 30%; }
.right { width: 100%; }
-td { text-indent:0em; }
+td { text-indent:0em;
+ font-family: 'Liberation Mono';}
.unbreakable { white-space:nowrap; }
.mandatory { color:navy; font-weight:bold; }
-->
@@ -42,17 +43,19 @@ td { text-indent:0em; }
<body>
<h2>ODF ${xmlModel.getGrammarVersion()} (${xmlModel.getGrammarID()}) XML Reference</h2>
-<p>This is a list of elements defined in ODF-Spec together with allowed parent and child elements and allowed attributes.</p>
-<p>Please note that "allowed" has the meaning of "may be allowed" as there might be a condition (like a special attribute value)
-for an element to have a special child element.</p>
+<p>This is an alphabetical ordered list of the XML defined in ODF ${xmlModel.getGrammarVersion()} (${xmlModel.getGrammarID()}) together with allowed parent, child elements and allowed attributes.</p>
-<p>left displayed in bold blue letters describe a mandatory relationship. All other relationships are optional.</p>
+<h3>Explanation</h3>
+<ol>
+<li><span class="mandatory">Bold blue letters</span> describe a mandatory XML node.</li>
+<li>The asterisk * symbol marks child elements which can occur multiple times.</li>
+<li>The square brackets with a number within [0] after an XML node like <a href="#attribute_office:value-type_0">office:value-type[0]</a> mark different grammar definitions.</li>
+</ol>
-<p>The asterisk (*) symbol marks child elements which can occur multiple times.</p>
-
-<p>Here's a shortcut to the content <a href="#element_office:document_0">toplevel</a> element.</p>
+<p>Here's a shortcut to the content's <a href="#element_office:document_0">toplevel</a> element.</p>
+</br/>
#foreach( $element in ${xmlModel.getElements()} )
#if ($element != "*")
@@ -100,7 +103,7 @@ for an element to have a special child element.</p>
#else
#set ($duplicates = "[${parent.getMultipleNumber()}]")
#end
- <a href="#element_${parent}_${parent.getMultipleNumber()}" class="unbreakable">${parent}${duplicates}</a>&nbsp;
+ <a href="#element_${parent}_${parent.getMultipleNumber()}" class="unbreakable">&lt;${parent}${duplicates}&gt;</a>&nbsp;
#end
#end
&nbsp;</td>
@@ -154,7 +157,7 @@ for an element to have a special child element.</p>
#set ($multiple = "*")
#end
##
- <a href="#element_${child}_${child.getMultipleNumber()}" class="unbreakable ${mandatory}">${child}${duplicates}</a>${multiple}&nbsp;
+ <a href="#element_${child}_${child.getMultipleNumber()}" class="unbreakable ${mandatory}">&lt;${child}${duplicates}&gt;</a>${multiple}&nbsp;
#end
#end
&nbsp;</td>
