Поддержка нескольких языков

ColorWanted использует формат JSON для реализации поддержки нескольких языков.

Программа ColorWanted реализует поддержку нескольких языков через файлы в формате JSON.

Внутренний язык:

Встроенные поддерживаемые языки:

— китайский;

— английский.

Структура

Файл описания языка состоит из трёх частей: название языка, информация об авторе и переводы.

{
  "locale": "zh-CN",
  "name": "简体中文",
  "authors": [{
      "name": "hyjiacan",
      "mail": "hyjiacan@163.com",
      "homepage": ""
    }
  ],
  "resource": {
    "窗体1名称/Form1 name": {
      "控件1名称/Control1 name": {
        "控件1的属性名称1/Property1 name": "控件1的属性值1/Property1 value",
        "控件1的属性名称2/Property2 name": "控件1的属性值2/Property2 value",
        "控件1的属性名称n/Propertyn name": "控件1的属性值n/Propertyn value"
      },
      "控件2名称/Control2 name": {
        "控件2的属性名称1/Property name": "控件2的属性值1/Property1 value",
        "控件2的属性名称2/Property name": "控теж2的属性值2/Property2 value",
        "控件2的属性名称n/Property name": "控件2的属性值n/Propertyn value"
      }
    },    
    "窗体2名称/Form2 name": {
      "控件1名称/Control1 name": {
        "控件1的属性名称1/Property1 name": "控件1的属性值1/Property1 value",
        "控件1的属性名称2/Property2 name": "控件1的属性值2/Property2 value",
        "控件1的属性名称n/Control1 propertyn name": "控件1的属性值n/Control1 propertyn value"
      },
      "控件2名称/Control2 name": {
        "控件2的属性名称1/Property1 name": "控件2的属性值1/Property1 value",
        "控件2的属性名称2/Property2 name": "控件2的属性值2/Property2 value",
        "控件2的属性名称n/Propertyn name": "控件2的属性值n/Propertyn value"
      }
    }
  }
}

Название языка

locale — это имя языка i18n, name — понятное человеку название, написанное на местном языке.

Здесь locale обозначает имя языка для i18n (интернационализации), а name представляет собой описание языка, обычно написанное на родном языке.

Информация об авторе

Информация об авторе authors представлена массивом, что позволяет хранить информацию о нескольких авторах.

Авторская информация authors является узлом массива, то есть в одном языковом файле можно указать информацию о нескольких авторах.

Перевод на местный язык

Перевод помещается в узел resource, структура которого выглядит следующим образом: имя формы → имя элемента управления → имя свойства элемента управления → значение свойства элемента управления.

Все переводы хранятся в узле resource. Его структура: имя окна → имя элемента → имя атрибута элемента → значение атрибута.

• $this означает саму форму.

При установке свойств самой формы в качестве имени элемента используется $this.

• При переводе неэлементарных строк именем элемента считается имя ресурса, а свойство должно быть пустой строкой "".

Если вы устанавливаете свойства, не связанные с элементами управления, именем элемента будет имя ресурса, а свойством — пустая строка "".

Полный образец можно найти в en.json.

Настройка

Вы можете настроить язык, просто поместив файл языка в папку C:\Users\YOUR USERNAME\AppData\Roaming\ColorWanted\i18n, подпапки игнорируются.