Documentation Center

Defining structure information properties

Use structure information to show the context of a structure element inside an XML document. For example, you can specify that an element is a <title> so that translators can consider this context when translating the content of this element. Titles may need to be translated differently than the text in the body of a document

About this task

The information that you specify here is visible in the Document Structure column of the Editor view.

Structure information is called Context on the XML Parser dialog box.

Opening the Structure Information Properties dialog box

To open the Advanced Tag Settings dialog box:

Procedure

  1. Go to the Parser page of your XML file type.
  2. Click Add to add a new XML Parser rule or select an existing rule and click Edit to customize it.
  3. On the Add Rule or Edit Rule dialog box, click the Edit button next to the Structure info field.

    The Structure Information properties page is displayed. Here you can see an overview of the existing structure information for a structure element.

    BoxDescription
    Name

    The name specified for an element. You cannot change these in this dialog box. Click Edit and use the Edit Structure Information dialog box to change them.

    Code

    Shows the specified abbreviation code for an element. Codes show where the segment text appears in he XML document. When translating, this information can be useful as, for example, heading elements may be translated differently than paragraph elements.

    Description

    The description specified for an element. You can set this for Custom elements on the Add Structure Information or Edit Structure Information page.

    This description is displayed in the Additional Information column when you click on the element code in the Editor view.

    Document Explorer
    Specifies the information that is displayed to the translator. Select a cell in the Document Explorer column, and choose from the drop-down list:
    • Show name - Displays the element name
    • Show content - Displays the content of the element
    • Not Set. Do not display structural information

    Only one item in the list can have a Show... setting. All the other items are automatically set to DoNotShow.

    If every item is DoNotShow , no information for this element is shown to the translator, unless the information is inherited from the parent element.

    Don't inherit Parent

    If set, this disables inheritance from the parent element. When clear, information is inherited if the Document Explorer column in the Structure Information Properties dialog box does not have any items that have been set to ShowDisplayName or ShowElementContent.

Adding or editing structure information

Click the Add or Edit button on the Structure Information Properties page to display the Add Structure Information or Edit Structure Information. Here you can customize the properties of a structure element.

About this task

BoxDescription
Standard

Offers a list of standard XML structure elements with predefined context information. Choose Custom if you want to create your own element and customize its context information.

For example, if you select List, SDL Trados Studio automatically adds default preset structure properties.

All LI elements in the XML documents processed with your XML file type will be displayed as in the Document Structure column of the Editor. You can still customize the formatting used for displaying the content of the XML element in the Editor view.

Choose Custom if you want to add custom Name, Code, Identifier, Description and Color properties for your structure element.

Purpose

Choose Match if you want Studio to store the document structure information as additional information in the translation memory. Studio will then use this information during context matching when doing a lookup in the translation memory.

Choose Information if you do not want to store document structure information when confirming the segments that include the content of your XML element.

Name

If you selected Custom in the Standard field, you can give a custom name for your structure element. This is displayed in the Location column when you click on the element code in the Editor view.

Code

Code is the abbreviation of an XML element. Codes show where the segment text appears in the XML document.

Studio displays the code of a structure element in the Document Structurecolumn of the Editor. For example, a Heading element is displayed as in the Editor view. This information can be useful when translating as you may need to translate heading elements differently than paragraph elements.

If you selected Custom in the Standard field, you can give a custom code for the structure information of your element.

A plus sign next to a code indicates that the segment includes more than one document structure information

IdentifierA unique identifier which Studio can then use for other tasks like processing embedded content.
DescriptionIf you selected Custom in the Standard field, you can add custom description for your structure element. This is displayed in the Additional Information column when you click on the element code in the Editor view.
Set description from content of this relative XPath

If the description is not set, you can use an XPath in this text box to pull out a value from the XML document to use as a description.

For example, you have the following element: <content description="This content is a car type">Content goes here </content>.

In this box, you can specify the XPath @description . This pulls the string, This content is a car type , as the description. This means that if the description changes for each <content>...</content> element, a different description for each context associated with that element is used instead of having the same description. Therefore, the XPath is relative to the element it describes.

Color

If you selected Custom in the Standard field, you can choose a custom highlighting color for displaying your element in the Document structure column. For example, default List elements are always displayed in light green whereas Heading elements are highlighted with dark green

Formatting

Choose how Studio displays the content of your element in the Editor view.