CODEWITHSUNDEEP
c++mfclocalization
titanae
titanae

Reputation: 2289

Localization testing, formatting all strings with XXXXX

We are trying to look at optimizing our localization testing.

Our QA group had a suggestion of a special mode to force all strings from the resources to be entirely contained of X. We already API hijack LoadString, and the MFC implementation of it, so doing it should not be a major hurdle.

My question is how would you solve the formatting issues?

Examples -

CString str ;
str . LoadString ( IDS_MYSTRING ) ;

where IDS_MYSTRING is "Hello World", should return "XXXXX XXXXX"
where IDS_MYSTRING is "Hello\nWorld", should return "XXXXX\nXXXXX"
where IDS_MYSTRING is "Hello%dWorld", should return "XXXXX%dXXXXX"
where IDS_MYSTRING is "Hello%.2fWorld", should return "XXXXX%.2fXXXXX"
where IDS_MYSTRING is "Hello%%World", should return "XXXXX%%XXXXX"

So in summary the string should work if used in a printf or Format statement, it should honor escape characters.

So this is a pure code question, C++/MFC, 

CString ConvertStringToXXXX ( const CString& aSource ) 
{
   CString lResult = aSource ;

   // Insert your code here

   return lResult ;
}

I know this could be done using tools on the .RC files, but we want to build English, then run like so -

application -L10NTEST

Upvotes: 3

Views: 1428

Answers (6)

Serge Wautier
Serge Wautier

Reputation: 21878

The pseudo-localisation feature of appTranslator can help you there: It modifies untranslated strings to use diacritics, text widening or shortening and such. So far, you're not interested. Where it becomes interesting is that it optionally encloses such strings in brackets. The idea was to make it more obvious that a string is pseudo localized. You could use this to detect that the string actually comes from the string table rather than code.

And of course, since the pseudo-localized program must run properly, appTranslator preserves all formatters (including printf-like and FormatMessage-like formatters) and special chars such as % or \n. Which is what you're looking for.

You wouldn't even have to modify your code: Simply create a 'dummy' translation. By 'dummy', I mean a language into which you don't plan to translate your app. Set the language preference of your app to that language. Wait, it's even better: The guys at QA can do it entirely on their own. They dont even have to bother you! :-)

Disclaimer: I'm the author of appTranslator.

Edit: answer to your comment: Glad to read you already use appTranslator. To avoid problems due to dialogs or strings not in the L10N DLL, you can simply re-build the DLLs (e.g. using a post-link step in your VS project). The process automatically re-scans the source exe and merges new and modified texts in the built resource dlls (doesn't affect the appTranslator project file, as opposed to 'Update Source'). This helps make sure your resource DLLs are always in sync with your exe.

Upvotes: 1

JasonTrue
JasonTrue

Reputation: 19609

I prefer a mechanism that we used when I was at Microsoft for pseudo-localization, which involved putting braces around each localized resource. Resource => [-Resource-], for example. Then you can always tell you have a composed string, and formatting doesn't usually change, barring line breaking rules.

We also usually did some string expansion (add various characters around the original string), and some dictionary- or randomization-based character substition (convert "o" to "ö").

Some teams also put the literal resource identifier (the name) as the value of the localized resource, which was more useful for localizers than for testers, because they could see where the resource was actually used in the UI.

Upvotes: 0

titanae
titanae

Reputation: 2289

My final solution was prefixing the string like so "*[resource instance name]original string". It works really well, it shows likely strings that will not fit in say German.

Example:

Original string from appres.dll, "My Application"

New string from appres.dll, "*[appres]My Application".

Thanks for all the suggestions.

Upvotes: 0

Osama Al-Maadeed
Osama Al-Maadeed

Reputation: 5695

I think what you need is an XXXX locale, if your software supports locales.

You develop it in English, then switch to the XXXX locale to make sure everything is translatable.

Upvotes: 0

RobS
RobS

Reputation: 9422

If this approach is to highlight formatted strings (or format sequences) in the application (i.e. all text appearing other than XXXX), you could locate the escape sequence (using regex perhaps) and insert block quotes around the formatted (substituted) values,
e.g. Some\ntext -> Some[\n]text

You get readability (all strings as XXX might be hard to use the application) and also get to detect non-resource (hardcoded) strings.

Having said that, if you're looking to detect non resource loaded strings (hardcoded strings), instead of substituting Xs, why not just prefix the string? You'll easily be able to tell resource loaded strings from hardcoded strings easily,
e.g. Some\ntext -> [EN]Some\ntext

Hope it helps?

Upvotes: 3

Eugene Yokota
Eugene Yokota

Reputation: 95624

You can apply compiler theory here and generate your scanner and parser using flex/bison (lex/yacc, or whatever tools). You can define \w+ as word, which can match both "Hello" and "World" etc..

Upvotes: 0

Related Questions