Pages: 1
Print
Author Topic: DITA: Configuring XMetaL Author Enterprise to Generate Localized CHM Files  (Read 9986 times)
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2502



WWW
« on: December 09, 2008, 02:15:48 PM »

Product(s):
XMetaL Author Enterprise 5.1+ (working with DITA Map and Topics)

Description:
Instructions included in the attached PDF document explain how to configure XMetaL Author Enterprise 5.1 to generate CHM files with the Contents, Index and Search tab features fully enabled for languages other than English from a DITA Map and associated topics.

The PDF instructions are included inside the zip file named Configuring_XMetaL_Author_Enterprise_to_Generate_Localized_CHM_Files.zip

Problem and Solution:
When a CHM file that has been generated using the standard DITA OT and HTML Help Workshop is viewed in the standard Windows help viewer (HTML Help Viewer or hh.exe), Internet Explorer is used to render the content for each topic in the content pane (on the right side). Internet Explorer is typically able to render this content as it is a Unicode capable application. This often causes confusion because this content is rendered correctly while the text in the Contents and Index tabs may not be, and the Search functionality may be broken.

After following the steps in this document the files that the DITA Open Toolkit generates
will be re-encoded before they are passed to HTML Help Workshop. Normally, output from
the DITA OT is encoded in UTF-8 (Unicode) but because HTML Help Workshop is a
legacy tool it requires input documents to be encoded using Windows codepages.

« Last Edit: December 09, 2008, 02:19:09 PM by Derek Read » Logged
mmoulder
Member

Posts: 43


« Reply #1 on: May 21, 2009, 11:26:28 AM »

Derek,

Do you know where you can get a list of the localID per language and the charset that should be used for each language? In your PDF you have examples for some of the languages, but we use many more.
Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2502



WWW
« Reply #2 on: May 21, 2009, 02:52:39 PM »

The PDF only lists those I have personally tested (as examples).

The PDF also includes information on where to find the codes required for other languages on pages 7 and 8 inside the topic "Parameter Formats and References".

If you test other values and confirm they work I would be interested in adding them to this document so that others may benefit from this information.
Logged
mmoulder
Member

Posts: 43


« Reply #3 on: October 06, 2009, 03:49:20 PM »

Where are the outputs stored so I can distribute those to the other writers without them having to create all the 29 different language outputs for chm files?
Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2502



WWW
« Reply #4 on: October 07, 2009, 02:32:24 PM »

Settings are stored in this file for each user:

%appdata%\SoftQuad\XMetaL\<version>\print_local.xml

Note that if you were to make settings changes and then distribute the same file to multiple users you might need to check inside the file for any full paths and replace those with Windows path variables (ie: %variablename%). Doing this is not something we test or officially support at the moment so I cannot say for sure what the exact configuration should be. You may wish to compare the per user version of the file (the one above) against the one we install to see what the path variables are set to by default:
C:\Program Files\XMetaL <version>\Author\DITA\XACs\shared\renditions\print_local.xml
« Last Edit: October 07, 2009, 03:34:12 PM by Derek Read » Logged
Fa
Member

Posts: 22


« Reply #5 on: November 22, 2011, 01:38:33 AM »

Hi Derek,

Would you have an updated guide for Windows7? I find myself having TOC and Index display issues in non-English languages.

Best regards,

Fabien
Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2502



WWW
« Reply #6 on: November 22, 2011, 11:36:38 AM »

I do not. I have quite a few things going on this week but if I can get some time I could run some tests on Windows 7 and see what is different.
Logged
Pages: 1
Print
Jump to: