1. DITA and XLIFF

2. Background I am co chair of the OASIS XLIFF TCI am co chair of the OASIS XLIFF TC I wrote an open source tool called xliffRoundTrip Tool ()I wrote an open source tool called xliffRoundTrip Tool (http://sourceforge.net/projects/xliffroundtrip/)http://sourceforge.net/projects/xliffroundtrip/ It works great with document-centric XML filesIt works great with document-centric XML files I wrote the tool without much thought about topic-based XML filesI wrote the tool without much thought about topic-based XML files

3. Continued It eventually became clear to me that I would need to write a DITA-specific moduleIt eventually became clear to me that I would need to write a DITA-specific module Here’s the storyHere’s the story

4. The DITA TC began thinking about translation About the time the DITA Translation Subcommittee was forming I was asked if my tool would be a good fit I tested the DITA Open Toolkit samples (DITA-OT1.2.2_bin.zip) with the original xliffRoundTrip tool

5. Started with the Garage topic <!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. *--> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../../dtd/concept.dtd"> Garage Concepts A well-stocked garage can be the envy of the neighborhood.

6. Ran the xliffRoundTrip tool: XML to XLIFF step

7. Created a perfectly valid XLIFF File <xliff xmlns="urn:oasis:names:tc:xliff:document:1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xmrk="http://www.xmarker.com" version="1.1" xsi:schemaLocation="urn:oasis:names:tc:xliff:document:1.1 xliff-1.1.xsd"> Garage Concepts Garage Concepts A well-stocked garage can be the envy of the neighborhood. A well-stocked garage can be the envy of the neighborhood.

8. Did a quick and dirty translation <xliff xmlns="urn:oasis:names:tc:xliff:document:1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xmrk="http://www.xmarker.com" version="1.1" xsi:schemaLocation="urn:oasis:names:tc:xliff:document:1.1 xliff-1.1.xsd"> Garage Concepts Garage Concepts Garagen-Konzepte Garagen-Konzepte A well-stocked garage can be the envy of the neighborhood. A well-stocked garage can be the envy of the neighborhood. Eine gut-gefüllte Garage kann die Nachbarn neidisch machen Eine gut-gefüllte Garage kann die Nachbarn neidisch machen

9. Did the XLIFF to XML step

10. Got a translated DITA file <!-- (C) Copyright IBM Corporation 2001, 2005. All Rights Reserved. *--> Garagen-Konzepte Eine gut-gefüllte Garage kann die Nachbarn neidisch machen

11. Problem: lots of DITA files can be tedious to process, 1 by 1

12. Translating can be difficult or translating can be easy The ParadoxThe Paradox –DITA’s strength its ability to harness many topics for a variety of outputs –DITA’s difficulty for the LSP is its many files Strategy:Strategy: –Take advantage of DITA’s mapfile in order to manage the many topic files –Create an XSLT to read the mapfile, and convert each of the referenced files to a single XLIFF file

13. DITA/XLIFF Roundtrip Open Source tool Demonstration

14. Begin with a set of DITA Topics and Map files

15. Rendered with the DITA OT

16. Step 1: DITA to XLIFF

17. A Single XLIFF file is created

19. Step 2: translate the XLIFF file

20. Target elements are translated

22. Step 3: XLIFF to DITA

23. Creates new folders with translated topics and SVG files

24. Render the translated files

25. In the real word Use your own DITA projectUse your own DITA project Generate the XLIFF fileGenerate the XLIFF file Have an LSP translate the XLIFF fileHave an LSP translate the XLIFF file Run the Import stepRun the Import step Enjoy your translated DITA Topics and SVG filesEnjoy your translated DITA Topics and SVG files