[gettext] Добавлен gettext/README.md

gettext/README.md

+## Пример использования
+TODO
+
+## Формат *.po.yml
+
+Альтернативный формат, для *.po файлов предназначен предназначен для
+более простой манипуляции с gettext-данными, и для обеспечения
+возможности хранения переводов вместе с UI-компонентами модуль
+
+
+```yml
+- "":
+    locale: "ru-RU"
+  "Accommodations": "Проживания"
+  "Select guests": "Выберите гостя"
+  "%podata":
+    - msgid: "%d sec"
+      msgid_plural: "%d sec"
+      msgstr: ["%d секунда", "%d секунды", "%d секунд"]
+      
+    - msgid: "<b>%d</b>&ndash;<b>%d</b> of <b>%d</b>"
+      msgid_plural: "<b>%d</b>&ndash;<b>%d</b> of <b>%d</b>"
+      msgstr: ["<b>%d</b>&ndash;<b>%d</b> из <b>%d</b>", "<b>%d</b>&ndash;<b>%d</b> из <b>%d</b>", "<b>%d</b>&ndash;<b>%d</b> из <b>%d</b>" ]
+```
+
+В корне *.po.yml должен быть массив, каждый элемент которого
+соответствует целому *.po файлу. 
+
+```
+- "":
+    locale: "ru-RU"
+```
+в поле с пустым именем содержатся метаданные файла (как в секции msgid
+"" в оригинальном *.po)
+
+
+```
+  "%podata":
+    - msgid: "%d sec"
+      msgid_plural: "%d sec"
+      msgstr: ["%d секунда", "%d секунды", "%d секунд"]
+```
+
+Еще одно специальное поле в объекте внутри массива — `%podata` внутри
+содержатся поля соответствующие записям из оригинального формата po
+`msgid`, `msgid_plural`, `msgctx`, `msgstr`
+
+```
+- ""
+    # ...
+  "Accommodations": "Проживания"
+  "Select guests": "Выберите гостя"
+  
+
+# Тоже самое в *.po
+msgid "Accommodations"
+msgstr "Проживания"
+
+msgid "Select guests"
+msgstr "Выберите гостя"
+```
+
+Остальные ключи внутри эелемента в корне массива соответствуют краткой
+форме для записи в po в которой присутствуют только две строки `msgid` и `msgstr`

gettext/index.ts

@@ -11,13 +11,13 @@ const CONTEXT_DELIMITER = String.fromCharCode(4);
 export type Translations = Record<string, Record<string, string[]|string>>;
 export type GettextData = {
   '': Record<string, unknown>;
-  '%explicit': GettextExplicitKey[],
+  '%podata': GettextExplicitKey[],
 } & {
   [K in string]: string|string[];
 };
 
 
-// Содержимое поля `%explicit`
+// Содержимое поля `%podata`
 export type GettextExplicitKey = {
   msgid: string;
   msgid_plural?: string;
@@ -121,9 +121,9 @@ export function requireTranslations(webpackContext /*: WebpackContext*/): Transl
 function assignData(dst: Translations, ...srcs: GettextData[]): Translations {
   srcs.forEach(data => {
     const locale = data[''].locale; if (!locale || typeof(locale) !== 'string') return;
-    const explicitKeys = data['%explicit'];
+    const explicitKeys = data['%podata'];
     for (const k of Object.keys(data)) {
-      if (k === '' || k === '%explicit') continue;
+      if (k === '' || k === '%podata') continue;
       dst[locale] = dst[locale] || {};
       dst[locale][k] = data[k];
     }