Reusing Content

Using XInclude syntax to reuse XML content chunks

To get the basics on how to use XInclude, follow the Include referenced content tutorial.

You can add also a "fallback" element to the "include" node and Tópico will use it if it cannot find the file or the target element. Only XHTML tags are allowed in the "fallback" element.

Using XInclude with an XPath pattern

You can also include an element by referencing it with an XPath pattern. As an example, to include the whole body of another topic/page, you could use "//xhtml:body" as the xpointer attribute value.

Inserting a predefined content chunk

By editing the file "insert.xml" that's found in the root of the collection, you can define various content that can be inserted with the Insert button. This file has a simple structure that borrows a lot from the XStandard styles.xml files.

Here's how the site map XInclude is defined in this file:

			<tag>
			<name>
			<en>Include Site Map</en>
			<fr>Include Site Map</fr>
			</name>
			<elt>include</elt>
			<attr>
			<name>class</name>
			<value>sitemap</value>
			</attr>
			<attr>
			<name>href</name>
			<value>ul.sitemap.en.xml</value>
			</attr>
			<attr>
			<name>xpointer</name>
			<value>sitemap</value>
			</attr>
			<attr>
			<name>xmlns</name>
			<value>http://www.w3.org/2001/XInclude</value>
			</attr>
			<content/>
			</tag>
		

The above tag definition, which has an English and French label, creates an "include" element with three attributes:

• href with a value of ul.sitemap.xml
• xpointer with a value of sitemap (the id of the top ul element)
• xmlns with a value of http://www.w3.org/2001/XInclude (the namespace URI for XInclude)

No content is created within this element since the "content" node under the tag is empty.

If you ever find yourself including a complex block of markup repeatedly, you might want to consider creating a custom tag that would appear when you click the Insert button. You can define a different set of custom tags for each collection you create.