On 01/06/2012 10:38 PM, Julie McHam wrote:
> I am ready to start customizing my ditac stylesheets.

Please do not send us any question about that. We don't answer questions 
about customizing the XSLT stylesheets, whether your are a customer of 
one of our product or not.

Please understand that we are selling products costing just a few 
hundred dollars and these products definitely do not include any 
customization service (such as  customizing the XSLT stylesheets) or any 
extensive assistance to the customer. Such services are generally worth 
thousands of dollars.




> 1. On page 41 of the XMLmind DITA Converter Manual,

Please use the HTML version of XMLmind DITA Converter Manual, not the 
PDF, .docx or .chm version.

> there is a reference to
> a custom stylesheet named custom_fo.xsl. I can't find this file anywhere.
> Is it provided with XSL Utility? If so, where might I find this file?

Generally the easiest is to open the local copy of the documentation in 
a web browser and to click on the link to ``download'' the resource.

The local copy of the documentation is found in
<ditac_install_dir>/doc/index.html

index.html has a link which points to:
<ditac_install_dir>/doc/doc/manual/index.html

which in turn has a link which points to:
<ditac_install_dir>/doc/manual/customize/custom_fo.xsl

(Yes, you should now consider downloading the distribution of XMLmind 
DITA Converter:
http://www.xmlmind.com/ditac/download.shtml )



> 2. Also, where is the ditac.options file?

Excerpts from 
http://www.xmlmind.com/ditac/_distrib/doc/manual/commandLine.html#commandLine__ditac_options_file
---
The ditac.options options file is found in the ditac user preferences 
directory. This directory is:

     * $HOME/.ditac/ on Linux.
     * $HOME/Library/Application Support/XMLmind/ditac/ on the Mac.
     * %APPDATA%\XMLmind\ditac\ on Windows 2000, XP, Vista, 7.
       Example: C:\Documents and Settings\john\Application 
Data\XMLmind\ditac\ on Windows 2000 and XP. 
C:\Users\john\AppData\Roaming\XMLmind\ditac\ on Windows Vista and 7.
---

However, if you are using XMLmind XSL Utility, you don't need 
ditac.options at all. You must create a custom fo.xsl (give it any name 
you want) then edit the specification of the conversion (e.g. 
ditaToDocx) using XMLmind XSL Utility in order to specify the location 
of your custom fo.xsl.

Your custom fo.xsl would typically start as follows:

---
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                 xmlns:fo="http://www.w3.org/1999/XSL/Format";
                 version="2.0">

   <xsl:import href="xslutil-config:dita/xsl/fo/fo.xsl"/>

</xsl:stylesheet>
---

In the context of XMLmind XSL Utility, "xslutil-config:" is an ``alias'' 
for directory <xslutil_install_dir>/addon/config/

OR as follows (both variants should work fine):

---
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                 xmlns:fo="http://www.w3.org/1999/XSL/Format";
                 version="2.0">

   <xsl:import href="ditac-xsl:fo/fo.xsl"/>

</xsl:stylesheet>
---

"ditac-xsl:" is an ``alias''

* in the context of XMLmind DITA Converter,
for directory  <ditac_install_dir>/xsl/

AND

* in the context of XMLmind XSL Utility,
for directory <xslutil_install_dir>/addon/config/dita/xsl/

Sorry if this is confusing. In a nutshell, once you have specified the 
correct ``alias''[*], your custom fo.xsl should work fine no matter 
where you have installed (or upgraded) XMLmind XSL Utility and/or 
XMLmind DITA Converter.





---
[*] In fact, what I call an ``alias'' is an entry in one of the XML 
catalogs 
(http://www.oasis-open.org/committees/download.php/14809/std-entity-xml-catalogs-1.1.html)
 
included in the distribution of XMLmind XSL Utility and XMLmind DITA 
Converter.

Example:
---
<?xml version="1.0" ?>
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"
          prefer="public">

   <rewriteURI uriStartString="ditac-xsl:" rewritePrefix="xsl/" />
...
---

You don't need to know anything about XML catalogs. I merely mentioned 
that to explain the ``magic'' behind these strange ``aliases''.
 
--
XMLmind DITA Converter Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/ditac-support

Reply via email to