Skip to content

Latest commit

 

History

History
138 lines (106 loc) · 5.24 KB

readme.md

File metadata and controls

138 lines (106 loc) · 5.24 KB
Raw

NGettext C# Helper Utility

English

This is a NGettext helper tool. It a easy to use for automatic collection form ui text (winform/wpf), and click-to-generating the i18n .pot/.po/.mo file with special language locale.

Requirements

  1. VS2015 express for Desktop with .net 3.5 client profile
  2. NGettext
  3. GNUGettext 0.17
  4. poedit

Features

  1. Load Microsoft C# solution file, and analyze it to get project file
  2. Extract string from XAML(WPF)/Designer(WinForm), code source, and convert it to pot
  3. Create locale .po file from .pot with msgmerge tool
  4. With NGettext.WPF.Dll/NGettext.WinForm.dll, can translating the ui control for auto-translating

Usage

  1. Normally example code. before usage, must add NGettext.dll to project ref, and NGettext.WinForm.dll or NGettext.WPF.dll (WinForm / WPF application)

     public MainForm()
 {
     InitializeComponent();
     I18N i10n = new I18N( null, this);
 }

    or

     public MainForm()
 {
     InitializeComponent();
 	I18N i10n = new I18N( "Your Catalog Name", this);
 }

  2. Now can not totally support tooltip auto translating. You may usage it like following code snippet when not

     private void toolTip_Popup( object sender, PopupEventArgs e )
 {
     toolTip.ToolTipTitle = e.AssociatedControl.Text;
     toolTip.SetToolTip( e.AssociatedControl, I18N._( toolTip.GetToolTip( e.AssociatedControl ) ).Replace( "\\n", "\n" ) );
 }

  3. Now can not support dialog auto translating. You must usage it like following code snippet

     dlgOpen.Filter = I18N._( dlgOpen.Filter );
 dlgOpen.Title = I18N._( dlgOpen.Title );

  4. Can using code snippet like following to init all

     public MainForm()
 {
     InitializeComponent();
     I18N i10n = new I18N( "NGetTextUtils", this, this.toolTip, new object[] { this.dlgOpen } );
 }

Source

  1. https://github.com/netcharm/ngettextutils
  2. https://bitbucket.org/netcharm/ngettextutils

binary

  1. https://bitbucket.org/netcharm/ngettextutils/download

中文

功能:

  1. 支持拖放和命令行传递VC#的解决方案文件(.sln)到程序, 以便IDE传参.
  2. 自行解析载入的解决方案文件, 获取包含的项目以及需要抽取多语化的UI设计文件及代码文件, 对于WPF应用, 就是.xaml文件以及其他.cs文件, 对于WinForm文件, 就是.Designer.cs文件以及其他.cs文件
  3. 使用xgettext抽取其他.cs文件中的需多语化的字符串, UI文件(分类如上所述)中的由程序自行实现. 生成.pot文件
  4. 利用此.pot文件, 按照所选择的目标语言, 生成.po文件, 如果没有, 直接复制, 如果已存在, 使用msgmerge合并处理.
  5. 可以傻瓜方式给用户程序项目文件以及代码文件打补丁添加对本人的NGettext多语化辅助Dll(专业人士不推荐, 因为有可能产生废代码)
  6. 本人编译的NGettext辅助多语化Dll现已支持自动遍历翻译UI的文字(未经详细测试), 支持WPF和WinForm.
  7. 使用I18N._("your string")或I18N.T("your string"), I18N.GetText("your string"), I18N.GetString("your string")四种方式在代码中输出多语化字符串.
  8. 可以自行编辑.config文件设定CSC.EXE路径以选择不同版本

备注:

  1. 开发环境, VS 2015 Express for Desktop, 运行需求 .net 版本 3.5 client profile.

  2. 提供全部源代码下载, 由于本人非专业程序员, 所以代码只能用"可以用"来形容, 地址如下

    1. https://github.com/netcharm/ngettextutils
    2. https://bitbucket.org/netcharm/ngettextutils

  3. 二进制打包文件可以在下列地址下载(已包含所需的gettext文件)

    1. https://bitbucket.org/netcharm/ngettextutils/download

  4. 一般用法范例代码, 使用之前必须在项目文件的引用中添加对NGettext.dll, 以及NGettext.WinForm.dll或NGettext.WPF.dll(根据应用类型而定)

     public MainForm()
 {
     InitializeComponent();
     I18N i10n = new I18N( null, this);
 }

    或者

     public MainForm()
 {
     InitializeComponent();
 	I18N i10n = new I18N( "Your Catalog Name", this);
 }

  5. 暂时无法完整的支持ToolTip的自动翻译, 出现无法翻译的状况时需要使用类似下列的代码片段动态翻译

     private void toolTip_Popup( object sender, PopupEventArgs e )
 {
     toolTip.ToolTipTitle = e.AssociatedControl.Text;
     toolTip.SetToolTip( e.AssociatedControl, I18N._( toolTip.GetToolTip( e.AssociatedControl ) ).Replace( "\\n", "\n" ) );
 }

  6. 暂时无法支持对话框的自动翻译, 需要使用类似下列的代码片段动态翻译

         dlgOpen.Filter = I18N._( dlgOpen.Filter );
     dlgOpen.Title = I18N._( dlgOpen.Title );

  7. 或者使用类似如下代码片段的模式初始化

     public MainForm()
 {
     InitializeComponent();
     I18N i10n = new I18N( "NGetTextUtils", this, this.toolTip, new object[] { this.dlgOpen } );
 }

源代码仓库

  1. https://github.com/netcharm/ngettextutils
  2. https://bitbucket.org/netcharm/ngettextutils

二进制下载

  1. https://bitbucket.org/netcharm/ngettextutils/download

Have fun!