Document! X 2022
Creating Localized Help Systems / Localization in Document! X
In This Topic
    Localization in Document! X
    In This Topic

    Document! X is the only mainstream Tool that allows you to author multiple languages within a single project.

    Define your Topics, Table of Contents, and Index Keywords once and manage each language you wish to localize to within the same project. Easily switch between locales and track localization tasks all from within Document! X.

    Localization Fundamentals

    Add a secondary locale to the Project

    1. On the Project ribbon tab, click the New Locale button.
    2. On the displayed dialog, choose the Locale that you wish to add to the project.
    3. Click Ok and the new Locale is added to the Project.           

    Switch between locales

    To switch to another locale, use the Current Locale dropdown on the Project ribbon tab.

    When you switch to another locale, Titles on the Project Explorer and Table of Contents Editor are shown in that locale and any new editors or project tools you open will open in that locale. The Properties window also shows localizable properties in the current locale.

    Localization Issue Indicator

    When you are working in a secondary locale and a localization for the current locale cannot be located, HelpStudio displays a localization issue indicator next to the text from the Primary Locale so that you can easily spot the problem. 


    Localization Issue Indicator on the Project Explorer

               


    Localization Issue Indicator in the Properties Window

               

    Hover your mouse over the localization issue indicator to see a list of locales with missing or out of date localizations.          

    Open a Topic for edit in a specific locale

    To open a Topic for edit in a specific Locale without changing the current locale, right-click on the Topic in the Project Explorer and select the required Locale from the Edit (Other Locale) sub-menu.

    The Topic Editor opens for the chosen Locale.           

    Open a Content File for edit in a specific locale

    To open a Content File for edit in a specific Locale without changing the current locale, right click on the Content File in the Project Explorer and select the required Locale from the Edit (Other Locale) sub-menu.

    The Content File Editor will open for the chosen Locale.           

    To build an output for a secondary locale

    1. Click the Build button on the Project ribbon tab.
    2. Select the secondary locales you wish to build.
    3. Click the Start Build button.
    The output generated for secondary locales is named with a suffix corresponding to the locale. For example if you are generating a help file named myhelpfile.chm then the file name generated for a German secondary locale would be myhelpfile.de-DE.chm and the web output would be generated to a \de-DE sub-directory of the chosen output folder.