Hi Hussein, I don't plan on forwarding any questions to you regarding the customization of the XSLT stylesheets. I just have a few questions about getting to that point with your software. I read through your email response (below) and I am a little confused. First, I have downloaded XSL Utility and I have been using that with no problem. Second, I downloaded and extracted the XMLmind XSL-FO Converter engine (DITAC-2_1_0.zip) which apparently what is where I need to go to find the proper documentation (http://www.xmlmind.com/ditac/_distrib/doc/manual/install.html#install). Is this correct? Is there some reason that I need to use the XSL-FO Converter engine in addition to the XSL Utility? Thank you, Julie
>>> Hussein Shafie <[email protected]> 1/7/2012 3:22 AM >>> 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
