Translating Microsoft RESX Files in Wordfast Pro - Revision history

Cheeseus at 09:25, 17 March 2022

2022-03-17T09:25:12Z

Cheeseus at 09:23, 17 March 2022

2022-03-17T09:23:55Z

Cheeseus at 09:22, 17 March 2022

2022-03-17T09:22:07Z

Cheeseus at 09:06, 17 March 2022

2022-03-17T09:06:43Z

Cheeseus at 08:58, 17 March 2022

2022-03-17T08:58:20Z

Cheeseus: Created page with "Microsoft ''.resx'' files are not directly supported by Wordfast Pro. A ''.resx'' file is, however, an XML file with a different extension, which means it is possible to tran..."

2022-03-17T08:56:13Z

Created page with "Microsoft ''.resx'' files are not directly supported by Wordfast Pro. A ''.resx'' file is, however, an XML file with a different extension, which means it is possible to tran..."

New page

Microsoft ''.resx'' files are not directly supported by Wordfast Pro.

A ''.resx'' file is, however, an XML file with a different extension, which means it is possible to translate it in Wordfast Pro by changing the file extension, e.g. from 'translatable-file.resx' to 'translatable-file.resx.xml'.

Since XML files often contain proprietary coding that specifies the human-readable (and translatable) text, it is necessary to create a special rules file to instruct Wordfast Pro how to separate the program code from the human text. In order to do this, we need to first take a look at the ''.resx'' file by opening it in a text editor such as Notepad++.

When we examine a ''.resx'' file, we discover that the human-readable text is wrapped in <value> ... </value> tags.

To create the rules file we need, create a new blank document in Notepad++ and save it as 'miscrosoft_resx.properties'. Make sure you save this file in a secure location on your computer's drive, do not move it and do not rename it.

A Wordfast Pro rules file needs to contain the following instructions. Simply copy and paste them in your 'microsoft_resx.properties' file.

paragraphPrefix.0=<value>
paragraphSuffix.0=</value>
paragraphFormat.0=html-included
internalTag.0=\\{.*?\\}

Explanation:
* The 'paragraphPrefix' instruction tells Wordfast Pro what precedes the translatable text, which is the opening <value> tag.
* The 'paragraphSuffix' instruction tells Wordfast Pro what succeeds the translatable text, which is the closing </value> tag.
* The 'paragraphFormat' instruction tells Wordfast Pro that the translatable text may contain HTML tags; if any, they will be converted to tags that we can easily transfer from the source to the target segment.
* The 'internalTag' instruction tells Wordfast Pro that the translatable text may contain placeholders that look like this: ''{0}'' or ''{1}''. The regular expression used above actually tells Wordfast Pro to look for an opening curly brace, followed by any character, repeated one or more times, followed by a closing curly brace. If we are sure that only single-digit numbers are contained in the curly braces, we can modify this to ''\\{[0-9]}\\}''.

Save the 'miscrosoft_resx.properties' file and add it to Wordfast Pro as a rules file. You can either add it to a specific project if you are sure you will not need it in the future or make it available for all future projects. In the latter case, start Wordfast Pro and ''without opening any project'', repeat the steps below:
* Click 'Preferences'.
* Under 'New Project Preferences', click 'Filters'.
* Click the 'Add' button.
* In the 'Choose file format' drop-down, select ''Text-based filter (*.xml)''.
* Type a name for the filter, e.g. ''Microsoft RESX'' in the 'Filter Name' field.
* Select UTF-8 as 'Target Encoding'.
* Click ''Browse...' to specify the location of the rules file you created above.
* Do not change the ''xml'' extension.
* Click 'OK'.

Now proceed to creating a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the 'Type' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.

NB! ''.resx'' files can contain a lot of data even if their size appears small, e.g. 500 KB or 900 KB. Wordfast Pro might take a few minutes to read this data after you add the source file, so please be patient.

When you complete your translation and save the translated file, you will need to change its extension back to ''.resx'' and remove the target language suffix that Wordfast Pro adds to the translated file.

@@ Line 33: / Line 33: @@
 # In the '''Choose file format''' drop-down, select ''Text-based filter (*.xml)''.
 # Type a name for the filter, e.g. ''Microsoft RESX'' in the '''Filter Name''' field.
-# Select UTF-8 as '''Target Encoding'''.
+# Select ''UTF-8'' as '''Target Encoding'''.
 # Click '''Browse...''' to specify the location of the rules file you created above.
 # Do not change the ''xml'' extension.

@@ Line 28: / Line 28: @@
 Save the '''miscrosoft_resx.properties''' file and add it to Wordfast Pro as a rules file. You can either add it to a specific project if you are sure you will not need it in the future or make it available for all future projects. In the latter case, start Wordfast Pro and ''without opening any project'', repeat the steps below:
-* Click '''Preferences'''.
+# Click '''Preferences'''.
-* Under '''New Project Preferences''', click '''Filters'''.
+# Under '''New Project Preferences''', click '''Filters'''.
-* Click the '''Add''' button.
+# Click the '''Add''' button.
-* In the '''Choose file format''' drop-down, select ''Text-based filter (*.xml)''.
+# In the '''Choose file format''' drop-down, select ''Text-based filter (*.xml)''.
-* Type a name for the filter, e.g. ''Microsoft RESX'' in the '''Filter Name''' field.
+# Type a name for the filter, e.g. ''Microsoft RESX'' in the '''Filter Name''' field.
-* Select UTF-8 as '''Target Encoding'''.
+# Select UTF-8 as '''Target Encoding'''.
-* Click '''Browse...''' to specify the location of the rules file you created above.
+# Click '''Browse...''' to specify the location of the rules file you created above.
-* Do not change the ''xml'' extension.
+# Do not change the ''xml'' extension.
-* Click '''OK'''.
+# Click '''OK'''.
 Now proceed to create a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the '''Type''' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.
@@ Line 47: / Line 47: @@
 When you complete your translation and save the translated file, you will need to change its extension back to ''.resx'' and remove the target language suffix that Wordfast Pro adds to the translated file.

← Older revision		Revision as of 09:22, 17 March 2022
Line 38:		Line 38:
	* Click '''OK'''.		* Click '''OK'''.

−	Now proceed to ~~creating~~ a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the '''Type''' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.	+	Now proceed to create a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the '''Type''' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.

@@ Line 10: / Line 10: @@
 A Wordfast Pro rules file needs to contain the following instructions. Simply copy and paste them in your '''microsoft_resx.properties''' file.
 paragraphPrefix.0=<value>
 paragraphSuffix.0=</value>
 paragraphFormat.0=html-included
 internalTag.0=\\{.*?\\}
 Explanation:
@@ Line 34: / Line 39: @@
 Now proceed to creating a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the '''Type''' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.
 NB! ''.resx'' files can contain a lot of data even if their size appears small, e.g. 500 KB or 900 KB. Wordfast Pro might take a few minutes to read this data after you add the source file, so please be patient.
 When you complete your translation and save the translated file, you will need to change its extension back to ''.resx'' and remove the target language suffix that Wordfast Pro adds to the translated file.

@@ Line 1: / Line 1: @@
 Microsoft ''.resx'' files are not directly supported by Wordfast Pro.
-A ''.resx'' file is, however, an XML file with a different extension, which means it is possible to translate it in Wordfast Pro by changing the file extension, e.g. from 'translatable-file.resx' to 'translatable-file.resx.xml'.
+A ''.resx'' file is, however, an XML file with a different extension, which means it is possible to translate it in Wordfast Pro by changing the file extension, e.g. from '''translatable-file.resx''' to '''translatable-file.resx.xml'''.
 Since XML files often contain proprietary coding that specifies the human-readable (and translatable) text, it is necessary to create a special rules file to instruct Wordfast Pro how to separate the program code from the human text. In order to do this, we need to first take a look at the ''.resx'' file by opening it in a text editor such as Notepad++.
@@ Line 7: / Line 7: @@
 When we examine a ''.resx'' file, we discover that the human-readable text is wrapped in <value> ... </value> tags.
-To create the rules file we need, create a new blank document in Notepad++ and save it as 'miscrosoft_resx.properties'. Make sure you save this file in a secure location on your computer's drive, do not move it and do not rename it.
+To create the rules file we need, create a new blank document in Notepad++ and save it as '''miscrosoft_resx.properties'''. Make sure you save this file in a secure location on your computer's drive, do not move it and do not rename it.
-A Wordfast Pro rules file needs to contain the following instructions. Simply copy and paste them in your 'microsoft_resx.properties' file.
+A Wordfast Pro rules file needs to contain the following instructions. Simply copy and paste them in your '''microsoft_resx.properties''' file.
 paragraphPrefix.0=<value>
@@ Line 17: / Line 17: @@
 Explanation:
-* The 'paragraphPrefix' instruction tells Wordfast Pro what precedes the translatable text, which is the opening <value> tag.
+* The ''paragraphPrefix'' instruction tells Wordfast Pro what precedes the translatable text, which is the opening <value> tag.
-* The 'paragraphSuffix' instruction tells Wordfast Pro what succeeds the translatable text, which is the closing </value> tag.
+* The ''paragraphSuffix'' instruction tells Wordfast Pro what succeeds the translatable text, which is the closing </value> tag.
-* The 'paragraphFormat' instruction tells Wordfast Pro that the translatable text may contain HTML tags; if any, they will be converted to tags that we can easily transfer from the source to the target segment.
+* The ''paragraphFormat'' instruction tells Wordfast Pro that the translatable text may contain HTML tags; if any, they will be converted to tags that we can easily transfer from the source to the target segment.
-* The 'internalTag' instruction tells Wordfast Pro that the translatable text may contain placeholders that look like this: ''{0}'' or ''{1}''. The regular expression used above actually tells Wordfast Pro to look for an opening curly brace, followed by any character, repeated one or more times, followed by a closing curly brace. If we are sure that only single-digit numbers are contained in the curly braces, we can modify this to ''\\{[0-9]}\\}''.
+* The ''internalTag'' instruction tells Wordfast Pro that the translatable text may contain placeholders that look like this: ''{0}'' or ''{1}''. The regular expression used above actually tells Wordfast Pro to look for an opening curly brace, followed by any character, repeated one or more times, followed by a closing curly brace. If we are sure that only single-digit numbers are contained in the curly braces, we can modify this to ''\\{[0-9]}\\}''.
-Save the 'miscrosoft_resx.properties' file and add it to Wordfast Pro as a rules file. You can either add it to a specific project if you are sure you will not need it in the future or make it available for all future projects. In the latter case, start Wordfast Pro and ''without opening any project'', repeat the steps below:
+Save the '''miscrosoft_resx.properties''' file and add it to Wordfast Pro as a rules file. You can either add it to a specific project if you are sure you will not need it in the future or make it available for all future projects. In the latter case, start Wordfast Pro and ''without opening any project'', repeat the steps below:
-* Click 'Preferences'.
+* Click '''Preferences'''.
-* Under 'New Project Preferences', click 'Filters'.
+* Under '''New Project Preferences''', click '''Filters'''.
-* Click the 'Add' button.
+* Click the '''Add''' button.
-* In the 'Choose file format' drop-down, select ''Text-based filter (*.xml)''.
+* In the '''Choose file format''' drop-down, select ''Text-based filter (*.xml)''.
-* Type a name for the filter, e.g. ''Microsoft RESX'' in the 'Filter Name' field.
+* Type a name for the filter, e.g. ''Microsoft RESX'' in the '''Filter Name''' field.
-* Select UTF-8 as 'Target Encoding'.
+* Select UTF-8 as '''Target Encoding'''.
-* Click ''Browse...' to specify the location of the rules file you created above.
+* Click '''Browse...''' to specify the location of the rules file you created above.
 * Do not change the ''xml'' extension.
-* Click 'OK'.
+* Click '''OK'''.
-Now proceed to creating a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the 'Type' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.
+Now proceed to creating a new project in which you want to translate ''.resx'' files (their extensions changed to ''xml'' as explained above). When you add a ''.resx'' file to your project, the '''Type''' column will show ''Microsoft RESX''. If it doesn't, you will need to select it in the drop-down list.
 NB! ''.resx'' files can contain a lot of data even if their size appears small, e.g. 500 KB or 900 KB. Wordfast Pro might take a few minutes to read this data after you add the source file, so please be patient.
 When you complete your translation and save the translated file, you will need to change its extension back to ''.resx'' and remove the target language suffix that Wordfast Pro adds to the translated file.