| Server IP : 121.121.20.254 / Your IP : 216.73.216.42 Web Server : Microsoft-IIS/10.0 System : Windows NT WEB-SERVER 10.0 build 20348 (Windows Server 2022) AMD64 User : IUSR ( 0) PHP Version : 8.3.28 Disable Function : NONE MySQL : ON | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/Program Files/LibreOffice/help/en-US/text/shared/guide/ |
Upload File : |
<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<base href="../../../../">
<noscript><meta http-equiv="refresh" content="0; URL=../../../../en-US/noscript.html"></noscript>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Creating XML Filters </title>
<link rel="shortcut icon" href="media/navigation/favicon.ico">
<link type="text/css" href="normalize.css" rel="Stylesheet">
<link type="text/css" href="prism.css" rel="Stylesheet">
<link type="text/css" href="default.css" rel="Stylesheet">
<script type="text/javascript" src="polyfills.js"></script><script type="text/javascript" src="languages.js"></script><script type="text/javascript" src="en-US/langnames.js"></script><script type="text/javascript" src="flexsearch.debug.js"></script><script type="text/javascript" src="prism.js"></script><script type="text/javascript" src="help2.js" defer></script><script type="text/javascript" src="a11y-toggle.js" defer></script><script type="text/javascript" src="paginathing.js" defer></script><script type="text/javascript" src="en-US/bookmarks.js" defer></script><script type="text/javascript" src="en-US/contents.js" defer></script><script type="text/javascript" src="help.js" defer></script><meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body>
<header id="TopLeftHeader"><a class="symbol" href="en-US/text/shared/05/new_help.html"><div></div></a><a class="logo" href="en-US/text/shared/05/new_help.html"><p dir="auto">LibreOffice 24.2 Help</p></a><div class="dropdowns"><div class="modules">
<button type="button" data-a11y-toggle="modules-nav" id="modules" aria-haspopup="true" aria-expanded="false" aria-controls="modules-nav">Module</button><nav id="modules-nav" hidden=""></nav>
</div></div></header><aside class="leftside"><input id="accordion-1" name="accordion-menu" type="checkbox"><label for="accordion-1" dir="auto">Contents</label><div id="Contents" class="contents-treeview"></div></aside><div id="SearchFrame"><div id="Bookmarks">
<input id="search-bar" type="search" class="search" placeholder="Search in bookmarks for all modules" dir="auto"><div class="nav-container" tabindex="0"><nav class="index" dir="auto"></nav></div>
</div></div>
<div id="DisplayArea" itemprop="softwareHelp" itemscope="true" itemtype="http://schema.org/SoftwareApplication">
<a name="bm_id7007583"></a>
<meta itemprop="keywords" content="testing XML filters">
<meta itemprop="keywords" content="XML filters, creating/testing">
<h1 id="hd_id1413922" dir="auto">
<a name="xsltfilter"></a>Creating XML Filters </h1>
<h2 id="par_idN1053D" dir="auto">Creating an XML Filter for LibreOffice</h2>
<p id="par_idN109A9" class="paragraph" dir="auto">When you create an XML filter for LibreOffice, you need to design an <span class="emph">XSLT stylesheet</span> that can convert to and from the OpenDocument XML file format.</p>
<div class="tip">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/tip.svg" alt="Tip Icon
" style="width:40px;height:40px;"></div>
<div class="notetext"><p dir="auto">For more information about the OpenDocument XML format, go to <a target="_blank" href="https://www.openoffice.org/xml/">https://www.openoffice.org/xml/</a>.</p></div>
</div>
<br>
<p id="par_idN109C5" class="paragraph" dir="auto">If you want, you can include a <span class="emph">template</span> with your filter to apply LibreOffice styles to an XML document that you import.</p>
<h2 id="par_idN10531" dir="auto">To Create an XML Filter</h2>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN109E0" class="paragraph" dir="auto">Create an XSLT transformation <span class="emph">stylesheet</span> that maps the elements of the external XML format to the elements of the OpenDocument XML file format and back again.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN109E8" class="paragraph" dir="auto">Create a template that assigns LibreOffice styles to elements in the external XML format when you import a file in this format into LibreOffice.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN109EC" class="paragraph" dir="auto">In LibreOffice Writer, create a text document, and choose <span class="menuitem">Tools - XML Filter Settings</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN109F4" class="paragraph" dir="auto">Click <span class="emph">New</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN109FC" class="paragraph" dir="auto">In the <span class="emph">XML Filter</span> dialog, click the <span class="emph">General</span> tab, and define the properties of the filter.</p>
</li>
</ol>
<ul itemprop="Unordered" itemscope="true" itemtype="http://schema.org/ItemList" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A03" class="paragraph" dir="auto">In the <span class="emph">Filter Name</span> box, enter a name for the XML filter.</p>
<p id="par_idN10CA1" class="paragraph" dir="auto">This name is displayed in the <span class="emph">XML Filter Settings</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A09" class="paragraph" dir="auto">In the <span class="emph">Application</span> box, select the LibreOffice application that the filter is for.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A0F" class="paragraph" dir="auto">In the <span class="emph">Name of File Type</span> box, enter the file type that the filter is for.</p>
<p id="par_idN10CC6" class="paragraph" dir="auto">This name is displayed in the list of file types in the <span class="emph">Open</span>, <span class="emph">Export</span>, and <span class="emph">Save As</span> dialogs.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A15" class="paragraph" dir="auto">In the <span class="emph">File extension</span> box, enter the extension for the exported file.</p>
<div class="note">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/note.svg" alt="Note Icon
" style="width:40px;height:40px;"></div>
<div class="notetext"><p dir="auto">To differentiate the file from other XML files, enter an extension other than *.xml.</p></div>
</div>
<br>
</li>
</ul>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto" start="6">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A1F" class="paragraph" dir="auto">On the <span class="emph">Transformation</span> tab page, define the transformation properties for the filter.</p>
</li>
</ol>
<ul itemprop="Unordered" itemscope="true" itemtype="http://schema.org/ItemList" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A26" class="paragraph" dir="auto">(Optional) In the <span class="emph">DocType</span> box, enter the document type identifier for the external file format.</p>
<p id="par_idN10D0E" class="paragraph" dir="auto">This identifier is used to detect the file type on import.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A32" class="paragraph" dir="auto">In the <span class="emph">XSLT for export</span> box, enter the path and file name of the XSLT stylesheet that defines the transformation from OpenDocument format to the external format.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A38" class="paragraph" dir="auto">In the <span class="emph">XSLT for import</span> box, enter the path and file name to the XSLT stylesheet that defines the transformation from the external format to OpenDocument format.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10A3E" class="paragraph" dir="auto">(Optional) In the <span class="emph">Template for import</span> box, enter the path and name of the template that defines the LibreOffice styles that are used in the imported file.</p>
<div class="note">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/note.svg" alt="Note Icon
" style="width:40px;height:40px;"></div>
<div class="notetext"><p dir="auto">The files that are specified on the <span class="emph">Transformation</span> tab page are copied to the local LibreOffice users directory.</p></div>
</div>
<br>
</li>
</ul>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto" start="7">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A4C" class="paragraph" dir="auto">Click <span class="emph">OK</span>.</p>
</li>
</ol>
<h2 id="par_idN10A56" dir="auto">To Test an XML Filter</h2>
<p id="par_idN10A5A" class="paragraph" dir="auto">You can perform basic tests on a custom XML filter in LibreOffice.</p>
<div class="note">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/note.svg" alt="Note Icon
" style="width:40px;height:40px;"></div>
<div class="notetext"><p dir="auto">The document is not altered by these tests. </p></div>
</div>
<br>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A60" class="paragraph" dir="auto">Create or open a text document.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A67" class="paragraph" dir="auto">Choose <span class="menuitem">Tools - XML Filter Settings</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A6F" class="paragraph" dir="auto">In the list of filters, select the filter that you want to test, and click <span class="emph">Test XSLTs</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A82" class="paragraph" dir="auto">To test an <span class="emph">Export</span> filter, do one of the following in the <span class="emph">Export</span> area of the dialog:</p>
</li>
</ol>
<ul itemprop="Unordered" itemscope="true" itemtype="http://schema.org/ItemList" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10DEB" class="paragraph" dir="auto">Click <span class="emph">Browse</span>, select the LibreOffice document that you want to test, and click <span class="emph">Open</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_idN10DF7" class="paragraph" dir="auto">To test the current document, click <span class="emph">Current Document</span>.</p>
</li>
</ul>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto" start="5">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_idN10A99" class="paragraph" dir="auto">To test an <span class="emph">Import</span> filter, click <span class="emph">Browse</span> in the <span class="emph">Import</span> area of the dialog, select a document, and click <span class="emph">Open</span>.</p>
</li>
</ol>
<a name="relatedtopics"></a><div class="relatedtopics">
<p class="related" itemprop="mentions" dir="auto"><a name="related"></a><span class="emph">Related Topics</span>
</p>
<div class="relatedbody" itemprop="mentions">
<p id="par_id8579668" class="paragraph" dir="auto"><a target="_top" href="en-US/text/shared/guide/xsltfilter.html">About XML Filters</a></p>
<p id="par_id5569017" class="paragraph" dir="auto"><a target="_top" href="en-US/text/shared/guide/xsltfilter_distribute.html">Distributing XML filters</a></p>
</div>
</div>
</div>
<div id="DonationFrame"></div>
<footer><div id="DEBUG" class="debug">
<h3 class="bug">Help content debug info:</h3>
<p dir="auto">This page is: <a href="https://opengrok.libreoffice.org/xref/help/source/text/shared/guide/xsltfilter_create.xhp" target="_blank">/text/shared/guide/xsltfilter_create.xhp</a></p>
<p dir="auto">Title is: Creating XML Filters </p>
<p id="bm_module" dir="auto"></p>
<p id="bm_system" dir="auto"></p>
<p id="bm_HID" dir="auto"></p>
</div></footer>
</body>
</html>