User manual TEFAL FV5225 AQUASPEED ULTRACORD RANGE

[. . . ] For information on installing DITA Open Toolkit, see "Appendix 1: Installing the DITA Open Toolkit" on page 9, and "Appendix 2: Installing the Open Toolkit plug-in for FrameMaker" on page 13. FrameMaker 3 9 Advanced features Appendix 1: Installing the DITA Open Toolkit 13 Appendix 2: Installing the Open Toolkit plugin for FrameMaker 14 Next steps 14 Resources Overview of DITA Open Toolkit DITA Open Toolkit is a set of software tools, originally developed by IBM®, for publishing DITA to various formats, including HTML, Microsoft HTML Help (. CHM) and JavaTM Help. If your content conforms to the DITA structure, you can use the DITA Open Toolkit to generate a wide variety of outputs. HTML Compiled Help XML XML conforming to DITA Structure DITA Open ToolKit Java Help The DITA Open Toolkit--an Open Source tool chain for multichannel publishing DITA Open Toolkit is available for free distribution on the Organization for the Advancement of Structured Information Standards (OASIS) website at http://www. oasis-open. org/ committees/tc_home. php?wg_abbrev=dita. OASIS maintains the DITA specification. Working with the Open Toolkit plug-in for FrameMaker The Open Toolkit plug-in for FrameMaker lets you manage publishing through the FrameMaker user interface. The plug-in provides a DITA menu for publishing multiple outputs through the DITA Open Toolkit, using the default options or your customized builds. The Open Toolkit plug-in for FrameMaker Generating output from the current file After installation, you can run the DITA Open Toolkit processes from within FrameMaker. [. . . ] At this stage, Test. xml must include all parameters required for running builds that target the specific test folders and files. However, such Ant scripts must be referenced in the initialization file before their targets show as options in the DITA Generate Output dialog box. Editing the DITA initialization file To complete the process of adding the selected targets, edit the DITA initialization file. Note: Take a backup of the DITA initialization file before changing anything. 1 Using Windows Notepad, open ditafm. ini from the fminit\ditafm folder. 2 Add the following lines at the end of the file: Using the Open Toolkit plug-in for FrameMaker 5 [AntBuild] AntCommand=ant Count=2 1=Test - CHM 2=Test - HTML [ANT:Test - CHM] BuildFile=C:\DITA-OT1. 4. 2. 1\Test. xml Target=chm OutputDir=C:\Projects\Test\out\chm Logfile=C:\Projects\Test\ant-buildlog-chm. txt [ANT:Test - HTML] BuildFile=C:\DITA-OT1. 4. 2. 1\Test. xml Target=html OutputDir=C:\Projects\Test\out\html Logfile=C:\Projects\Test\ant-buildlog-html. txt 3 Save and close ditafm. ini. Note that Test. xml is a single script that contains multiple targets, such as CHM and HTML. To run the selected targets you have defined (formats like CHM, PDF, and so on): 4 In FrameMaker, select DITA > Generate Output. The list of targets specified in the . ini file appears. DITA Generate Output dialog box with Selected Target option selected 6 Select one of the targets and click Build. You can review the output, which is similar to the output generated using the Current File option. Using the Open Toolkit plug-in for FrameMaker 6 Customizing Ant You can customize Ant scripts to automate a wide range of publishing processes. For example, you might use an Ant script to copy files from one location to another. 5 Open Windows Explorer by right-clicking the Windows Start menu and choosing Explore from the pop-up menu. Create a folder within the root folder called Saxon (for example, C:\Saxon). 6 In Windows Explorer, navigate to the folder where you saved the archive file. 7 Extract the contents of the archive file to the C:\Saxon folder that you created. Installing Microsoft HTML Help Microsoft HTML Help is a tool for authoring online Help, which is used by the Open Toolkit to create compiled Help (. chm) files. To install Microsoft HTML Help: 1 Go to http://msdn. microsoft. com/library/default. asp?url=/library/en-us/htmlhelp/ html/hwMicrosoftHTMLHelpDownloads. asp (make sure this is a single line). 2 Click Download Htmlhelp. exe and click Save to save the executable file to your hard disk; note where you saved the file. 3 Open Windows Explorer by right-clicking on the Windows Start menu, and choosing Explore from the pop-up menu. Double-click the Htmlhelp. exe file and follow the steps in the HTML Help installation wizard to complete the installation. Installing the DITA Open Toolkit The DITA Open Toolkit itself provides files that control the dependent applications, such as the JDK, Ant, and SAXON, to generate published output. To install the DITA Open Toolkit: 1 Go to http://dita-ot. sourceforge. net/. [. . . ] If you don't have a Classpath variable, create one by clicking New and setting the variable name to Classpath, and the variable value to the path of xml-resolver-1. 2. jar file (for example, C:\xmlresolver-1. 2. jar). Set the ANT_Home variable to the location where you installed Apache Ant. Set the ANT_OPTS variable to allow sufficient memory to run the test Ant script. Set the Classpath variable to include the Open Toolkit dost. jar file. Set the Classpath variable to include the SAXON . jar file. Set the JAVA_Home variable to the folder where you installed the JDK. Set the JHHome variable to the folder where you installed JavaHelp. Set the Path variable to the folder where you installed the Apache Ant bin folder. Set the Classpath variable to include the xmlresolver-1. 2. jar file. Overview of environment variables and instructions Verifying the installation To verify that you have installed the DITA Open Toolkit correctly, including its dependencies and configuration: 1 Go to the command prompt by choosing Run from the Windows Start menu, and then typing cmd and clicking OK. 2 Type cd \ at the command prompt to move to the root folder. Using the Open Toolkit plug-in for FrameMaker 12 Moving to DITA Open Toolkit folder in command window 3 Navigate to the DITA Open Toolkit folder (for example, by typing CD dicta-ot1. 4. 2. 1). Note: This folder name must exactly match the folder where you installed the DITA Open Toolkit. 4 At the command prompt, type ant all If your toolkit is properly installed, you should see text scrolling through the command window for several minutes, as the DITA Open Toolkit generates test output, completing with the text "BUILD SUCCESSFUL. " Successful build reported in command window If you receive an error, double-check the installation instructions above, or see the DITA Open Toolkit documentation. Appendix 2: Installing the Open Toolkit plug-in for FrameMaker This section guides you through installing the Open Toolkit plug-in for FrameMaker and its associated components. [. . . ]