in

The ORM Foundation

Get the facts!

i18n of verbalization in NORMA and reports

Last post Tue, Feb 26 2008 20:51 by Kevin M. Owen. 3 replies.
Page 1 of 1 (4 items)
Sort Posts: Previous Next
  • Mon, Feb 25 2008 21:26

    • Jos Bol
    • Top 50 Contributor
      Male
    • Joined on Sat, Mar 8 2008
    • Rio de Janeiro
    • Posts 10

    i18n of verbalization in NORMA and reports

    Hi,
    
    I just downloaded and tested the VS 2008 version of NORMA and it works great! I'm especially glad with the realtime visualization of the relation model: a lot better than VEA.
    
    Since my models are either in Dutch or in Portguese (Brazil), the verbalization isn't very pretty due to the mixture of either language and English. Is there a way to translate both the verbalizations used in the verbalization pane and the reports? I found the XML file with the verbalizations and the documentation on it, but it does not mention how to choose the proper language in Visual Studio and it seems to apply only to the html reports.
    
    With kind regards,
    Jos Bol
  • Tue, Feb 26 2008 14:35 In reply to

    RE: i18n of verbalization in NORMA and reports

    To verbalize in a different language (or customize verbalizations for English)
    1) In the NORMAINSTALLDIR\Xml\Verbalization\Core directory, copy the _default.xml file to Brazil.xml (file name doesn't matter)
    2) Edit the file. First change the language to "en-US" value to "pt-br" (in the Language element)
    3) Change the description attribute to "Default Portugese" (in the Snippets attribute). Note that you can leave the name="_default" as long as the language is not en-US
    4) Edit your snippets
    5) Do the same exercise with _default.xml files in other directories under Verbalization
    
    Note that the _default.xml is not loaded, it is there for documentation only. You do not have to redefine all of the snippets, just the changed ones.
    
    Now, inside Visual Studio:
    1) On the Tools/Options dialog, choose 'ORM Designer'. Open the dropdown in the 'Alternate Verbalization Text' field in the Verbalization category.
    2) Choose the snippets you want to verbalize with for each section
    
    Note that the verbalization engine currently assumes a gender-free language, so languages that change qualifiers based on gender are not yet handled. For example, you can say safely use 'each' in English for both man and person, but German uses 'Jeder Mann' and 'Jede Person'. We would require lexicons for each language to enable this level of support. This is something we will consider eventually, but not in the near future.
    
    Note that you do not need to restart VS to reload changes to your snippets, but I don't have a file watch on the current snippets files so you'll need to reload. To make changes and reload:
    1) Switch the chosen verbalization back to default
    2) Make sure something verbalizes
    3) Switch back to your edited file to force a reload
    
    -Matt
    
  • Tue, Feb 26 2008 20:45 In reply to

    • Jos Bol
    • Top 50 Contributor
      Male
    • Joined on Sat, Mar 8 2008
    • Rio de Janeiro
    • Posts 10

    RE: i18n of verbalization in NORMA and reports

    Hi Matt, thanks for the detailed fast response!
    
    Portuguese and Dutch both have genders, but as far as I am concerned its a minor issue since the grammar and spell check of Word will correct most of it I guess. Would you be interessted in the translations btw?
    
    With kind regards,
    Jos Bol
  • Tue, Feb 26 2008 20:51 In reply to

    • Kevin M. Owen
    • Top 500 Contributor
      Male
    • Joined on Sun, Nov 18 2007
    • Neumont University, South Jordan, Utah
    • Posts 0

    RE: i18n of verbalization in NORMA and reports

    We would definitely be interested in any translations, and would be happy to include them in future NORMA releases if you wanted to contribute them.
Page 1 of 1 (4 items)
© 2008-2024 ------- Terms of Service