Source files

2006-05-27
2013-05-28
  • Jeff Winchell

    Jeff Winchell - 2006-05-27

    I downloaded the zip file in the files directory that I found (NORMA_VS-2006-05CTP.zip) and ran the setup program, but I don't see any C# source code or in particular, the XML file that lets you translate the US English text. From what I can tell, all files installed by the setup program are in
    C:\Program Files\Neumont
    and
    C:\Program Files\Common Files\Neumont

    is there some other location for installed files?

     
    • Matthew Curland

      Matthew Curland - 2006-05-27

      There are several resource files (5, I believe) that would need to be translated to change the full UI into English. There is also a separate mechanism for providing alternate verbalization. Neither of these should require C# code.

      Modifying the verbalizer (either into alternate English forms or a different language) is designed to be an XML exercise, and setting an option.

      Here are the steps for alternate verbalization:
      1) In the C:\Program Files\Neumont\ORM Architect for Visual Studio\XML\Verbalization\Core directory, copy the _default.xml file to another file with the .xml extension.

      2) Near the top of the file, change either Language/@xml:lang or Snippets/@name. If your choosing a language other than en-US (sv-SE for example) you can keep the "_default" name. Otherwise, change it (TestOverride, for example).

      3) Any change you make to the Snippet text in this file will override the default verbalization. Note that you cannot change the default by modifying _default.xml. The defaults are compiled in: _default.xml is provided as the authoritative reference on what we're currently using (the default code is generated from this file).

      4) You can pick and choose the snippet values to override. Any snippet not changed can be deleted and will fallback on the default.

      5) To use your new verbalization in VS, go to the ORM Designer page of the Tools/Options dialog. In the Verbalization section, change the 'Alternate Verbalization Text' to 'Neumont.Tools.ORM.ObjectModel.CoreVerbalizationSnippetType,LANGUAGE,SNIPPETSNAME'. The default is 'Neumont.Tools.ORM.ObjectModel.CoreVerbalizationSnippetType,en-US,_default' (Obviously, we'll have a UI for this in the future).

      6) If you have an ORM designer open, you can force a reload by changing this property, closing the options dialog, forcing something to reverbalize, then reapplying your option.

      The goal of this approach is to enable verbalization modification at the snippet level in XML without reprogramming how the snippets are combined. You can refer to ORMModel\ObjectModel\VerbalizationGenerator.xml to see how these snippets are combined. Obviously, we'll have more verbalization snippets added to the default set as we fill in verbalization for more constraints. Extensions to the ORM tool can also use this same mechanism (each extension gets their own directory corresponding to their own enum type, the options uses a semi-colon to separate options for different snippet sets). We should have UI for this option by our next major drop.

      -Matt

       
    • Jeff Winchell

      Jeff Winchell - 2006-05-27

      Thank you for the info about language changes. One question:

      What subdirectory is

      ORMModel\ObjectModel\VerbalizationGenerator.xml

      in?

      On my computer it is not in C:\Program Files\Neumont or C:\Program Files\Common Files\Neumont.

       
    • ted creedon

      ted creedon - 2006-06-11

      Is a .sln solution for VS available?

       
      • Kevin M. Owen

        Kevin M. Owen - 2006-06-11

        Yes, there are several .sln files for various parts of the application. The main one is "ORMPackage.sln", which can be found in the "trunk" directory in our Subversion repository.
        SourceForge provides information about how to check out our Subversion repository at https://sourceforge.net/svn/?group_id=158881

         

Log in to post a comment.