blob: 0607b4f445140d05ca27120fbcbad2a9381f0b46 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--***********************************************************
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
***********************************************************-->
<helpdocument version="1.0">
<meta>
<topic id="textsharedguidexsltfilterxml" indexer="include" status="PUBLISH">
<title xml-lang="en-US" id="tit">Working With %PRODUCTNAME XML Filters </title>
<filename>/text/shared/guide/xsltfilter.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id7007583"><bookmark_value>saving;to XML</bookmark_value> <bookmark_value>loading;XML files</bookmark_value> <bookmark_value>importing;from XML</bookmark_value> <bookmark_value>exporting;to XML</bookmark_value> <bookmark_value>file filters;XML</bookmark_value>
<bookmark_value>XSLT filters, see also XML filters</bookmark_value>
</bookmark>
<comment>mw moved 2 index entries to the new file xsltfilter_distribute.xhp and 2 entries to new file xsltfilter_create.xhp</comment>
<paragraph xml-lang="en-US" id="par_idN10923" role="heading" level="1" l10n="NEW"><variable id="xsltfilter"><link href="text/shared/guide/xsltfilter.xhp">About XML Filters</link>
</variable></paragraph>
<paragraph xml-lang="en-US" id="par_idN10927" role="paragraph" l10n="CHG">%PRODUCTNAME <link href="text/shared/00/00000021.xhp">stores documents in XML format</link>. You can create customized filters that convert the native OpenDocument XML file format used by %PRODUCTNAME into another format. These filters can be integrated into %PRODUCTNAME seamlessly so that you can save or load these formats transparently.</paragraph>
<paragraph xml-lang="en-US" id="par_idN1093A" role="note" l10n="NEW">To create an XML filter, you must have a good understanding of XML and XSLT concepts. These concepts are beyond the scope of this help.</paragraph>
<paragraph xml-lang="en-US" id="par_idN1093D" role="paragraph" l10n="NEW">An XML filter contains <emph>stylesheets</emph> that are written in the XSLT language. The stylesheets define the transformation from the OpenDocument file format to another XML format through export and import filters. There are three types of XML filters:</paragraph>
<list type="unordered">
<listitem>
<paragraph xml-lang="en-US" id="par_idN10947" role="paragraph" l10n="NEW"> <emph>Import Filters</emph> load external XML files and transform the format of the files into the OpenDocument XML file format. After you install an import filter, the name of the filter is added to the list of file types in the <link href="text/shared/01/01020000.xhp">File Open dialog</link>.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN10960" role="paragraph" l10n="NEW"> <emph>Export Filters</emph> transform OpenDocument XML files and <emph>save</emph> the files to a different XML format. After you install an export filter, the name of the filter is added to the list of file types in the <link href="text/shared/01/01070001.xhp">Export dialog</link>.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN10979" role="paragraph" l10n="NEW"> <emph>Import/Export Filters</emph> load and save OpenDocument XML files into a different XML <emph>format</emph>. After you install these filters, the names of the filters are added to the list of file types in the <link href="text/shared/01/01020000.xhp">File Open dialog</link> and the <link href="text/shared/01/01070000.xhp">File Save As dialog</link>.</paragraph>
</listitem>
</list>
<section id="relatedtopics">
<paragraph xml-lang="en-US" id="par_idN10B39" role="paragraph" l10n="NEW"><link href="http://www.w3.org/Style/XSL/">World Wide Web Consortium Pages on Extensible <emph>Stylesheet</emph> Language (XSL)</link></paragraph>
<paragraph xml-lang="en-US" id="par_idN10B4E" role="paragraph" l10n="NEW"><link href="http://www.w3.org/XML/">World Wide Web Consortium Pages on Extensible Markup Language (XML)</link></paragraph>
<paragraph xml-lang="en-US" id="par_idN10D97" role="paragraph" l10n="NEW"> <embedvar href="text/shared/00/00000021.xhp#xmlformat"/> </paragraph>
<paragraph xml-lang="en-US" id="par_id5569017" role="paragraph" l10n="NEW"><link href="text/shared/guide/xsltfilter_distribute.xhp">Distributing XML filters</link></paragraph>
<paragraph xml-lang="en-US" id="par_id6426892" role="paragraph" l10n="NEW"><link href="text/shared/guide/xsltfilter_create.xhp">Creating and Testing XML filters</link></paragraph>
</section>
</body>
</helpdocument>