enb-bem-i18n: new description #45
Conversation
|
@blond ping? |
| [](https://www.npmjs.org/package/enb-bem-i18n) | ||
| [](https://travis-ci.org/enb-bem/enb-bem-i18n) | ||
| [](https://ci.appveyor.com/project/blond/enb-bh) | ||
| [](https://coveralls.io/r/enb-bem/enb-bem-i18n?branch=master) | ||
| [](https://david-dm.org/enb-bem/enb-bem-i18n) | ||
|
|
||
| Поддержка `BEM.I18N` для ENB. | ||
| Пакет предоставляет набор ENB-технологий для сборки файлов, обеспечивающих мультиязыковую поддержку проектов, созданных на основе [БЭМ-методологии](https://ru.bem.info/method/). Осуществляет сборку BEM.i18n, использующуюся в библиотеке [bem-bl](https://ru.bem.info/libs/bem-bl/dev/). |
There was a problem hiding this comment.
BEM.i18n -> BEM.I18N
Теперь в поддержке не только bem-bl, но и bem-core.
Может быть не «осуществляет сборку i18n», а про то что поддерживатся i18n, который есть в bem-bl?
Или говорить именно про поддержку библиотек? Например, сделать подраздел «Поддержка библиотек», где про каждую библиотеку рассказать с её особенностью.
Сейчас история такая:
— В bem-bl есть i-bem__i18n.
— В bem-core@v2 тоже самое i-bem__i18n.
— В bem-core@v3 совсем другое, блок i18n.
There was a problem hiding this comment.
давайте считать, что в bem-core@v2 сейчас никакой поддержки i18n нет и туда будет портирована история из v3
There was a problem hiding this comment.
@blond есть вопрос — как писать i18n или I18N?
Правильное название i18n - в нижнем регистре. У нас в коде только в BEMHTL пишется капсом (I18N), в остальных случаях, если я не ошибаюсь, i18n.
Как понять, какой вариант писать в документации? Правильно ли, что в коде то так, то так?
There was a problem hiding this comment.
Правильно в нижнем регистре — i18n. Но, если речь о реализации из bem-bl, то правильно капсом — BEM.I18N.
There was a problem hiding this comment.
про bem-core, я так понимаю, пока не пишем, раз в v2 поддержки нет, а самой v3 тоже пока нет?
There was a problem hiding this comment.
Нет, пишем про bem-core, т.к. в 1.x уже есть поддержка нового i18n, и версия выйдет тогда, когда выйдет или bem-core@v3 или будет портировано в v2 (смотря, что раньше).
|
Написал замечаний. Про шаблоны и API технологий, давай писать после того как доделаем это в коде. В целом мне очень нравится 👍 |
|
|
||
| ```js | ||
| BEM.I18N('scope', 'key'); // Ядро `i18n` предоставляется в глобальную видимость в переменную `BEM.I18N`. | ||
| // Ядро `i18n` подключается в модульную систему (YModules или CommonJS) как отдельный модуль с именем `i18n`. |
|
@blond правки внесла |
| [ require('enb-bem-i18n/techs/i18n-merge-keysets'), { lang: 'all' } ], | ||
| [ require('enb-bem-i18n/techs/i18n-merge-keysets'), { lang: '{lang}' } ] | ||
| ]); | ||
| * В `bem-bl` — в файл `all.js`. |
| block1.js | ||
| block1.i18n.js # Исходный файл с переводом, содержащий | ||
| # общие переводы для всех языков. | ||
| # Может содержать ядро `i18n` для библиотеки ` |
innabelaya
force-pushed
the
README-update
branch
from
59fefd7
to
1d8f090
Compare
| **Пример** | ||
|
|
||
| ```javascript | ||
| nodeConfig.addTech([ require('i18n-keysets-xml'), { lang: '{lang}' } ]); |
There was a problem hiding this comment.
var KeysetsTech = require('enb-bem-i18n/techs/keysets'),
KeysetsXMLTech = require('enb-bem-i18n/techs/keysets-xml'),
FileProvideTech = require('enb/techs/file-provider'),
bemTechs = require('enb-bem-techs');
module.exports = function(config) {
config.setLanguages(['en', 'ru']);
config.node('bundle', function(node) {
// Получаем FileList
node.addTechs([
[FileProvideTech, { target: '?.bemdecl.js' }],
[bemTechs.levels, levels: ['blocks']],
bemTechs.deps,
bemTechs.files
]);
// Собираем keyset-файлы для каждого языка
node.addTech([KeysetsTech, { lang: '{lang}' }]);
// Собираем XML-файлы для каждого языка
node.addTech([KeysetsXMLTech, { lang: '{lang}' }]);
node.addTarget('?.keysets.{lang}.js');
});
};
|
Closed in favor of #68 |
Resolved #20