{"id":794,"date":"2014-07-06T16:06:16","date_gmt":"2014-07-06T15:06:16","guid":{"rendered":"http:\/\/wasaty.pl\/blog\/?p=794"},"modified":"2014-07-06T16:06:16","modified_gmt":"2014-07-06T15:06:16","slug":"xml-translation-part-2-memoq","status":"publish","type":"post","link":"http:\/\/wasaty.pl\/blog\/2014\/07\/06\/xml-translation-part-2-memoq\/","title":{"rendered":"XML translation \u2013 part 2: memoQ"},"content":{"rendered":"
Tweet<\/a><\/div>\n

\"new_memoQ\"In my previous post<\/a> I\u2019ve described what is XML, what is it for and what are the particular components. This time I\u2019m going to show you how to properly import almost any XML file into memoQ for translation. I\u2019m going to reference the files described in previous part, so you might want to look there for comparison and file structure description.<\/p>\n

<\/p>\n

The posts are an adaptation of the presentation I gave at the Translation Conference<\/a> in Warsaw, March 2014.<\/p>\n

The standard way of adding files into a new project in memoQ is to use Import files<\/strong> command on the second screen of New Project Wizard<\/strong>. However, when creating projects I usually skip that step and I\u2019m adding files to an already created project by simple drag and drop from file explorer (in my case it\u2019s usually Total Commander). When you add files like that, memoQ asks no questions – the default filter settings are being used. In case of our book collection file, the result will look like this:<\/p>\n

\"Simple<\/a>

Simple XML file imported without defining any settings<\/p><\/div>\n

As you can see, text was imported correctly, but formatting tags were treated as external, so text which should be one segment was split into three. How can we fix it?\u00a0 We need to import the file in a bit more complicated way. What we need is Import with options<\/b> command. Or you can even drag and drop the same file for the second time – this will lead to Document import options<\/b> dialog being displayed. Click Change filter and configuration<\/b> command to display Document import settings<\/b> dialog. Switch to Tags and attributes<\/b> tab.<\/p>\n

\"Document<\/a>

Document import settings dialog, Tags and attributes tab<\/p><\/div>\n

Click Populate<\/b> button. memoQ will read the tags and attributes from the file and display them in the Handled tags<\/b> field. It will also try to assign properties to tags, as you can see below:<\/p>\n

\"Populated<\/a>

Populated Handled tags field<\/p><\/div>\n

Tags <b><\/b> and <i><\/b> are marked as inline. Of course you can mark tags manually too. And since these settings can be useful in the future (especially if you enter any changes), you can save them using this button:<\/p>\n

\"Save<\/a>

Save filter settings button<\/p><\/div>\n

In the displayed dialog enter a name for the filter plus optional description and click OK<\/b>. The file will be imported and this time <i><\/em> tags will be properly treated as inline, so the segment won\u2019t be split, making the translation easier.<\/p>\n

Now, let\u2019s take a look at somewhat more complex XML file:<\/p>\n

\"Complex<\/a>

Complex XML file with scrambled content<\/p><\/div>\n

If you drag and drop this file into memoQ, the result won\u2019t be encouraging. By importing this way I\u2019ve got 106 segments for translation \u2013 some of them are splitted incorrectly, others should not be translated at all. So you can try to repeat the process in of importing by using Import with options<\/b> command, changing filter configuration and using Populate<\/b> command to force memoQ to analyze tags. The result will look like this:<\/p>\n

\"Complex<\/a>

Complex XML file imported into memoQ<\/p><\/div>\n

That\u2019s actually not so bad with regard to inline tags \u2013 we\u2019ve got 94 segments this time, but there is still some content which should not be imported – particularly strings inside curly braces ({}). What you have to do now is to re-import the file again, but this time manually change settings for some tags. Please note names of the tags the content of which should not be imported. In this case it\u2019s mainly <reference><\/i>. So go back to import settings and find the <reference><\/i> tag \u2013 please note, that there are actually two <reference><\/i> tags, written with capital R and small “r” \u2013 these are different entities, since XML names are case sensitive. Click the <reference><\/em> tag in the Handled tags<\/b> list, and then select Not translated<\/b> setting.<\/p>\n

\"Defining<\/a>

Defining a tag content not to be imported for translation<\/p><\/div>\n

And this is the result of file import:<\/p>\n

\"Imported<\/a>

Imported file with ignored tags content<\/p><\/div>\n

Now we have only 63 segments for translation, and the skipped content is shown in grey on the preview. If there are other tags with the content you don\u2019t want to import, you just have to mark them as Not translated<\/i> in the filter configuration and that\u2019s it. Of course it\u2019s a good idea to save the created filter for future use, especially if there are more than one file to be translated.<\/p>\n

It seems we have the situation under control. Unfortunately, there are even more complex to be found in the world of XML authoring. Take look at this example:<\/p>\n

\"Another<\/a>

Another complex XML file<\/p><\/div>\n

As you can see there\u2019s a <Field><\/i> tag with some content obviously not meant for translation. So we can just axe <Field><\/i> tags, right?\u00a0 Unfortunately, you can\u2019t. When you look closely you will see that the <Field><\/i> contains both text to be ignored and to be translated. They can be separated only by the content of the “Name” attribute. Fortunately XML filters can help you with this problem too. You need to get back to the drawing board, I mean to filter settings.<\/p>\n

When you select a tag in Handled tags<\/b> field you will see it\u2019s available attributes in the Tag attributes<\/b> area.<\/p>\n

\"Tag<\/a>

Tag attributes settings<\/p><\/div>\n

Click the attribute you are interested in to get to its options. There\u2019s an Translatable<\/b> check box \u2013 I\u2019ll come back to it in a minute. For now we are interested in the Non translation<\/b> button. Click it to display Non-translation settings for attribute<\/b> dialog. In this case you need to choose not to import these three labels, all the rest will be imported.<\/p>\n

\"Defining<\/a>

Defining non-translatable tags based on attributes<\/p><\/div>\n

And this is the final result. Nice and clean.<\/p>\n

\"<\/a>

Imported XML with tags filtered based on attributes<\/p><\/div>\n

 <\/p>\n

Now, there are two more special cases when it comes to translation of tags and attributes.<\/p>\n

Sometimes we need some more flexibility with regard to tags and their content. See the screenshot below:<\/p>\n

\"Content<\/a>

Content of tag is a placeholder<\/p><\/div>\n

This is a result of default import of an XML file, just drag and drop. Obviously the <var> tags should be treated as inline. There\u2019s an easy fix to that – just mark them as inline. However, the content of var<\/i> tag is a placeholder for a product name and it definitely should not be translated. We can easily prevent the translation by checking both Inline<\/b> and Not translated<\/b> options:<\/p>\n

\"Marking<\/a>

Marking a tag as inline with content not to be translated<\/p><\/div>\n

The code will be rendered like this:<\/p>\n

\"Inline<\/a>

Inline tags with tagged content<\/p><\/div>\n

The other special case is when we need to translate an attribute. While usually you don\u2019t want to do this, sometimes it\u2019s necessary. Take a look at this example \u2013 this is a valid XML in which title and author of a book are stored as attributes of the <book><\/i> element. It\u2019s a bad practice, but this happens.<\/p>\n

\"XML<\/a>

XML with translatable attributes<\/p><\/div>\n

In such case you just need to select the <book><\/i> tag on the Handled tags<\/b> list, then select “title” in the Tag attributes<\/b> field and check Translatable<\/b> option for this attribute. The text will be imported for translation.<\/p>\n

* * *<\/p>\n

As you can see, the process of defining XML filter is not particularly complicated, however it can be time consuming, especially for more complex files, requiring a lot of importing, fiddling and reimporting to check the results. And please remember that this short introduction is not meant to cover all XML import options for memoQ, only the basic options required to create a working filter for simple and somewhat more complex XML files. If you need more information on settings like encoding, XSLT, white space normalization and entities, consult the software help.<\/p>\n

Third part of the series will cover defining XML filters for Trados Studio.<\/p>\n","protected":false},"excerpt":{"rendered":"

In my previous post I\u2019ve described what is XML, what is it for and what are the particular components. This time I\u2019m going to show you how to properly import almost any XML file into memoQ for translation. I\u2019m going to reference the files described in previous part, so you might want to look there for comparison and file structure description.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[6],"tags":[9,41,20,43],"_links":{"self":[{"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/posts\/794"}],"collection":[{"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/comments?post=794"}],"version-history":[{"count":4,"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/posts\/794\/revisions"}],"predecessor-version":[{"id":814,"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/posts\/794\/revisions\/814"}],"wp:attachment":[{"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/media?parent=794"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/categories?post=794"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/wasaty.pl\/blog\/wp-json\/wp\/v2\/tags?post=794"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}