<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2xhtml-configuration-template" indexer="include">
<title xml-lang="en-US">Content</title>
<filename>org.openoffice.da.writer2xhtml.oxt/Configuration/Template.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Template</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Use this page to define an XHTML template to use as a basis for the
generated XHTML documents.</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2xhtml - Template</emph>
</section>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2xhtml.oxt:UseCustomTemplate" id="bm_configusecustomtemplate"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use custom XHTML template</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to define an XHTML template. Otherwise a default
template will be used.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">A template should be an ordinary XHTML file (do not include a DOCTYPE declaration)
with some special elements:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">A <emph>div</emph>-element with the id <emph>content</emph> is used to
fill the text content.
If no such element exists, the <emph>body</emph> element is used. If there is no <emph>body</emph> element
in the template, the root element is used.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>div</emph>-elements with the id <emph>header</emph> or
<emph>footer</emph> (optional) will be filled with a simple navigation panel using a first/previous/next/last scheme
(for spreadsheet documents, sheet names are used for navigation).</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">A <emph>div</emph>-element with the id <emph>panel</emph> (optional)
will be filled with a simple navigation panel using a table of contens-like scheme.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US">You can change the names of the id attributes at the bottom of this page.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">A simple template including a header might look like this:</paragraph>
<paragraph role="code" xml-lang="en-US">
<html><br/>
  <head><br/>
    <title/><br/>
  </head><br/>
  <body><br/>
    <div id='header' /><br/>
    <div id='content' /><br/>
  </body><br/>
</html>
</paragraph>
<paragraph role="paragraph" xml-lang="en-US">As the template does not include footer and panel nodes, these elements will not be included.
</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The absolute mininal template is this:</paragraph>
<paragraph role="code" xml-lang="en-US">
<div/>
</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The <emph>div</emph>-element will be used as the content container.
The generated document will not be a complete XHTML document (no <emph>html</emph>, <emph>head</emph> and
<emph>body</emph> nodes). It will however still be a well-formed XML file that can be handled with standard tools.
The use case for this is that you can produce XHTML fragments suitable for inclusion in e.g. a CMS.</paragraph>
<paragraph role="note" xml-lang="en-US">Make sure to check the option <emph>Do not include DOCTYPE</emph> in this case!</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2xhtml.oxt:LoadTemplate" id="bm_configloadtemplate"/>
<paragraph role="heading" level="3" xml-lang="en-US">Load...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this to load a template from a file. This will overwrite the current contents
of the template.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2xhtml.oxt:ContentId" id="bm_configcontentid"/>
<paragraph role="heading" level="3" xml-lang="en-US">Content id</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the id to use for the content node.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2xhtml.oxt:PanelId" id="bm_configpanelid"/>
<paragraph role="heading" level="3" xml-lang="en-US">Panel id</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the id to use for the panel node.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2xhtml.oxt:HeaderId" id="bm_configheaderid"/>
<paragraph role="heading" level="3" xml-lang="en-US">Header id</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the id to use for the header node.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2xhtml.oxt:FooterId" id="bm_configfooterid"/>
<paragraph role="heading" level="3" xml-lang="en-US">Footer id</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the id to use for the footer node.</paragraph>
</body>
</helpdocument>