Topic

THESE PAGES ARE STILL UNDER CONSTRUCTION AND DO NOT NECESSARELY REFLECT THE CURRENT VERSION OF TÓPICO

Although the topic file is a standard XHTML file, this topic documents some specific (microformat) elements that make up this file and tries to explain the design decisions behind the choice and hopefully some insights on how they're inteded to be used.

%wip%

Related links

Related links are saved within the actual topic and are appended by Tópico upon saving the topic to disk. When the topic is opened, the following markup is again strippd from the topic file and presented in a data grid within the Tópico user interface.

XML
<div id="topico">
 <div id="related_links">
  <p><a href="rleated_link1_url">Related link 1 text</a></p>
  <p><a href="rleated_link2_url">Related link 2 text</a></p>
 </div>
</div>	

This way, formatting related links becomes only a matter of creating the appropriate template and telling the processor if we want to use it or not, which is done through the "Related links" property of each topic.

By default, the <div id="topico"> element is stripped out from the published output. The template that does this looks like:

XSLT
<xsl:template match="xhtml:div[@id='topico']" mode="import"> </xsl:template>	

This template is found in the imports.xsl file.

THESE PAGES ARE STILL UNDER CONSTRUCTION AND DO NOT NECESSARELY REFLECT THE CURRENT VERSION OF TÓPICO

169 / 194