in

The ORM Foundation

Get the facts!

Source files

Last post Sun, Jun 11 2006 18:03 by Kevin M. Owen. 5 replies.
Page 1 of 1 (6 items)
Sort Posts: Previous Next
  • Sat, May 27 2006 4:54

    Source files

    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?
  • Sat, May 27 2006 10:36 In reply to

    RE: Source files

    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
  • Sat, May 27 2006 11:04 In reply to

    RE: Source files

    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.
  • Sat, May 27 2006 14:17 In reply to

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

    RE: Source files

    The VerbalizationGenerator.xml is not installed by the setup program.
    
    You can view it in the Subversion repository at http://svn.sourceforge.net/viewcvs.cgi/*checkout*/orm/trunk/ORMModel/ObjectModel/VerbalizationGenerator.xml.
    If you would like to check out the full repository, SourceForge provides instructions at https://sourceforge.net/svn/?group_id=158881.
    
    
  • Sun, Jun 11 2006 17:55 In reply to

    RE: Source files

    Is a .sln solution for VS available?
  • Sun, Jun 11 2006 18:03 In reply to

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

    RE: Source files

    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
Page 1 of 1 (6 items)
© 2008-2024 ------- Terms of Service