Using the node-based localization method

You configure IXIASOFT CCMS to use the node-based localization method by enabling the NodeBasedLocalizationManagerService manager in the localizationManagers.xml file.

The following code shows the node-based localization manager class in the localizationManagers.xml file.

<manager
   class = 
     "com.ixiasoft.cms.controller.localization.NodeBasedLocalizationManagerService"              
   name = "Node based Localization manager" >           
   <config name = "substantialChange">false</config>      
</manager>
You can configure the following option for the node-based localization manager:
Option Description
substantialChange Specifies whether to localize the objects with substantial changes only.

The substantial change flag, which is set when a document is released, allows users to specify whether a document contains substantial or minor changes.

You can configure the localization manager so that only the objects with substantial changes are sent for localization to reduce localization costs. To enable this feature, set the substantialChange option to true. The localization manager then checks the substantial change flag when preparing the localization kit; only the objects with substantial changes are packaged in the localization kit.

Note that the status of the objects that are not packaged in the localization kit (that is, the objects with minor changes) is moved directly to the review state.

Set the substantialChange option to false to ignore the substantial change flag and include all the files in the localization kit.

Default value is false.

To use the node-based localization manager:

  1. Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the tool bar. If the shortcut is not displayed, follow these steps:
    1. Select Window > Open Perspective > Other
    2. Click TEXTML Administration.
    3. Click OK.
  2. In the TEXTML Administration view, double-click the server. If your server is not displayed in the view, you must add it to the view.
  3. When the Connect as dialog opens, type your username and password and click OK.
  4. Double-click the name of your docbase to open a connection to the Content Store.
  5. Expand the Content Store's Repository node and browse to /system/conf to locate the localizationManagers.xml file.
  6. Right-click localizationManagers.xml and select Check Out.
  7. Open the file in an XML editor.
  8. Search for the NodeBasedLocalizationManagerService class.
    For example:
    <!-- Node-Based Localization Manager -->
    <!-- manager 
    class="com.ixiasoft.cms.controller.localization.NodeBasedLocalizationManagerService" 
         description="Tries to determine content to localize by applying an XML
                      diff to all the nodes." 
         name="Node based Localization manager">
         <config name="substantialChange">false</config>
    </manager -->
  9. To use the node-based localization manager, remove the comments from the <manager> element, as shown below:
    <!-- Node-Based Localization Manager -->
    <manager 
    class="com.ixiasoft.cms.controller.localization.NodeBasedLocalizationManagerService" 
         description="Tries to determine content to localize by applying an XML 
                      diff to all the nodes." 
         name="Node based Localization manager">
         	<config name="substantialChange">false</config>
    </manager>
  10. If necessary, set the substantialChange configuration option.
    For example:
    <!-- Node-Based Localization Manager -->
    <manager 
    class="com.ixiasoft.cms.controller.localization.NodeBasedLocalizationManagerService" 
         description="Tries to determine content to localize by applying an XML 
                      diff to all the nodes." 
         name="Node based Localization manager">
         	<config name="substantialChange">true</config>
    </manager>
  11. Since only one localization manager can be enabled at any time, make sure that the sequential localization manager is commented out.
    For example:
    <!-- Sequential Localization Manager, with auto-translation disabled -->
    <!-- manager class="com.ixiasoft.cms.controller.localization.sequential.SequentialLocalizationManagerService" 
       description="Tries to determine content to localize by applying an XML
                    diff to all the nodes." 
       name="Sequential Localization manager">
          <config name="substantialChange">false</config>
          <config name="full.context">false</config>
          <config name="context.document.type">Dita2Pdf</config>
          <config name="include.default.images">true</config>
          <config name="in.context.exact.matches">false</config>
    </manager>
    
    <manager class="com.ixiasoft.cms.controller.localization.sequential.SequentialImageLocalizationManagerService" 
       description="Tries to determine content to localize for images 
                    without revision history." 
       name="Sequential Image Localization manager"
       type="image">
    </manager -->
  12. Save, close, and check in the file.
  13. Inform users of the changes.
    The changes will be applied automatically once users close and then reopen their . Users can also apply the changes without restarting their IXIASOFT CCMS Desktop by clicking DITA CMS > Synchronize Configuration.