i18n-rus: add russian

isRuslan · isRuslan · commit f1748e5db547 · 2015-06-17T10:38:08.000+03:00
diff --git a/exercises/catch_error/problem.ru.md b/exercises/catch_error/problem.ru.md
@@ -0,0 +1,60 @@
+Обработка ошибок и генераторы.
+
+## Теория
+Лучшее, что генераторы принесли нам это **синхронность**. Код внутри генераторов
+является синхронным, даже еслимы вызываем генератор в асинхронном режиме.
+
+Это означает, что мы можем использовать конструкцию `try {...} catch () {}` с легкостью.
+
+```js
+function *dummy () {
+  try {
+    null.foo(); // вызываем exception
+  } catch (e) {
+    console.log('Caught exception: %s', e);
+  }
+  yield 'Попали сюда без сбоев';
+}
+dummy().next();
+// Caught exception: TypeError: Cannot read property 'foo' of null
+{ value: 'Попали сюда без сбоев', done: false }
+```
+Также, функция-генератор имеет `throw()` метод, который позволяет отправить
+исключение внутрь функции, позволяя конструкции `try-catch` отловить исключение
+внутри генератора.
+
+Помните: если внутри генератора нет конструкции `try-catch`, то послыаемое
+исключение будет просто возвращено из функции.
+
+```js
+function *foo () { yield 'inside foo'; }
+
+var it = foo();
+try {
+  it.throw('BOOO from outside');
+} catch (errFromIt) {
+  console.log('Error: %s ', errFromIt); // Error: BOOO from outside
+}
+```
+
+## Задание
+Реализуйте функцию-генератор `upper`, которая принимает массив строк
+на вход и вызвращает каждую строк в верхнем регистре.
+
+**Проблема:** кто-то послал число в `upper` и это сломало всю работу.
+Пожалуйста исправьте это. Если `upper` получил число, то он должен вернуть `null`.
+
+**Шаблон решения:**
+
+```js
+function *upper (items) {
+  // ваш код здесь
+}
+
+var bad_items = ['a', 'B', 1, 'c'];
+
+for (var item of upper(bad_items)) {
+  console.log(item);
+}
+// вывод: A, B, null, C
+```
diff --git a/exercises/delegating_generators/problem.ru.md b/exercises/delegating_generators/problem.ru.md
@@ -0,0 +1,43 @@
+Генераторы внутри генераторов.
+
+## Теория
+Мы можем передавать управление процессом итерации от нашего генератора
+к другому. В этом нам поможет выражение `yield * expression`, `*` означает,
+что **expression** является генератором и мы можем передать ему управление.
+
+```js
+function *foo() {
+    yield 2;
+    yield 3;
+}
+
+function *main() {
+    yield 1;
+    yield *foo(); // передаем управление
+}
+
+for (var v of main()) {
+    console.log( v );
+}
+// 1 2 3
+```
+
+## Справка
+ - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/yield*
+
+## Задача
+Реализуйте функцию-генератор `flat` принимает вложенный массив и выравнивает его. 
+
+**Шаблон решения:**
+
+```js
+function *flat (arr) {
+  // ваш код здесь
+}
+
+var A = [1, [2, [3, 4], 5], 6];
+for (var f of flat(A)) {
+    console.log( f );
+}
+// 1 2 3 4 5 6
+```
diff --git a/exercises/generator_iterator/problem.ru.md b/exercises/generator_iterator/problem.ru.md
@@ -0,0 +1,37 @@
+Генераторы и итераторы. В чем разница?
+
+## Теория
+Главное, что необходимо понимать, это то, что __генераторы это итераторы__.
+Генераторы являются простой оберткой объекта итератора (см `iterator protocol` ниже).
+
+Генераторы не исполняются в свой первый вызов, вместо этого они возврщают
+объект итератора с несколькими дополнительными функциями (`send, next, throw, close`).
+
+Итератор - это шаблон проектирования, где мы проходимся по последовательности элементов
+по одному на итерацию с помощью вызова `next()`. На каждый вызов `next()` мы получаем
+следующий элемент из последовательности :)
+Звучит вполне логично и уже знакомо для нас.
+
+## Справка
+ - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/The_Iterator_protocol
+ - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...of
+ - http://wiki.ecmascript.org/doku.php?id=harmony:iterators
+
+## Задание
+
+Реализуйте функцию-генератор `factorial` которая на вход получает число **n**
+и начиная с **1** итеративно выводит факториал каждого числа до **n** включительно.
+
+Не используйте рекурсию. Используйте цикл.
+
+**Шаблон решения:**
+```js
+function *factorial(n){
+  // ваш код здесь
+}
+
+for (var n of factorial(5)) {
+  console.log(n)
+}
+// 1, 2, 6, 24, 120 
+```
diff --git a/exercises/look_sync_do_async/problem.ru.md b/exercises/look_sync_do_async/problem.ru.md
@@ -0,0 +1,76 @@
+Look sync. Do async.
+
+## Теория
+Генераторы позволяют нам скрыть **асинхронность** как деталь реализации
+и писать легкий для чтения, поддерживаемый, синхронно-выглядящий код.
+
+Чего-чего?
+
+Генераторы могут **приостановить их выполнение** до тех пор, пока
+асинхронные вызовы не завершат свое выполенение.
+
+Например, вы хотите прочитать текущий каталог c помощью `fs.readdir(dir, cb)`
+без падения в callback-страну.
+
+```js
+var fs = require('fs');
+
+function run (generator) {
+  var it = generator(go);
+
+  function go (err, result) {
+    it.next(result);
+  }
+
+  go();  
+}
+
+run(function* (done) {
+  // читаем `learn-generators` директорию exercises
+  var exercises = yield fs.readdir('exercises', done);
+  console.log(exercises); // [ 'look_sync_do_async', ..., 'run_stop_run' ]
+});
+
+```
+Здесь мы создали генератор, который остановил свое выполнение, подождал
+пока функция `readdir` завершит свое выполнение и вернет результат.
+
+Ключевым элементом в этом примере является функция `run`. Что она делает:
+
+**1)** создает оновый бъект генератор (`it`);
+**2)** определяем функцию `go`, которая вызывает `it.next`;
+**3)** передаем функцию `go` внутрь объекта-генератора;
+**4)** вызываем `go` для того чтобы стартовать генератор.
+
+Всего функция `go` будет вызвана дважды, один раз без аргументов (это запустит
+исполнение генератора) и второй раз с результатом вызова `fs`, который нам вернет `yield`.
+
+Если сложно уловить мысль, советуем вставить `console.log` внутри функции
+и отследить последовательность вызовов программы.
+
+## Справка
+ - http://nodejs.org/api/fs.html#fs_fs_readdir_path_callback
+ - http://en.wikipedia.org/wiki/Thunk
+ 
+## Задание
+Добавьте обработку ошибку в данный шаблон. Научите `run` выбрасывать исключение
+и отлавливать его в функции-генераторе. `firstFile` должен быть равен `null`, 
+если он не существует.
+
+**Шаблон решения:**
+
+```js
+var fs = require('fs');
+
+function run (generator) {
+  // см `run` выше
+}
+
+run(function* (done) {
+  // исключение
+  var dirFiles = yield fs.readdir('NoNoNoNo', done); // нет такой директории
+  var firstFile = dirFiles[0]; // TypeError: Cannot read property '0' of undefined
+  
+  console.log(firstFile);
+});
+```
diff --git a/exercises/look_sync_make_promise/problem.ru.md b/exercises/look_sync_make_promise/problem.ru.md
@@ -0,0 +1,68 @@
+Look sync. Make a promise.
+
+## Теория
+Есть еще один путь писать `синхронно-выглядящий` код - это **Promises**.
+
+Так же, как и **callbacks** в предыдущем задании, мы можем подождать, пока
+promise вернет результат и вернуть его из генератора.
+
+Давайте попробуем реализовать пример из предыдущего задания - прочитаем 
+директорию **exercise**, но уже с использованием promise.
+
+```js
+var fs = require('fs');
+
+function readDir(dir) {
+  return new Promise(function (resolve, reject) {
+    fs.readdir(dir, function (err, res) {
+      if (err) {
+        reject(err);
+      } else {
+        resolve(res);
+      }
+    });
+  });
+}
+
+run(function* () {
+  // практически та же самая функция-генератор
+  var exercises = yield readDir('exercises');
+  console.log(exercises); // [ 'look_sync_do_async', ..., 'run_stop_run' ]
+});
+
+```
+В этом примере мы определили функцию `readDir` которая возвращает promise с
+содержимым переданной ей директории. Но самая интересная часть происходит в
+функции `run`, где мы подождали исполнение **`readDir` promise**, получили результат
+и продолжили работу.
+
+Каким образом `run` сделала это? Это и есть ваше задание.
+
+## Справка
+ - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
+ - https://www.promisejs.org/
+
+## Задание
+
+Реализуйте функцию `run`, которая принимает функцию-генератор в качестве аргумента, 
+запускает ее и возвращает **результат promise** `foo`. Используйте `run` из 
+предыдущего задания в качестве примера.
+
+**Шаблон решения:**
+```js
+function askFoo () {
+  return new Promise(function (resolve, reject) {
+    resolve('foo');
+  });
+}
+
+function run (generator) {
+  // ваш код здесь
+}
+
+run(function* () {
+  // обработка ошибок?
+  var foo = yield askFoo();
+  console.log(foo);
+});
+```
diff --git a/exercises/run_stop_run/problem.ru.md b/exercises/run_stop_run/problem.ru.md
@@ -0,0 +1,55 @@
+Введение в ES6 генераторы.
+
+## Теория
+Генераторы - это функции, которые могут быть остановленны и запущены
+в процессе выполнения столько раз, сколько необходимо. Например:
+
+```js
+function *foo () {
+  var stop = yield 'woo';
+  console.log(stop, 'inside foo')
+}
+var G = foo();
+
+console.log( G.next() );
+// { value: 'woo', done: false }
+console.log( G.next('bar') );
+// 'bar', 'inside foo'
+// { value: undefined, done: true }
+```
+
+Что здесь произошло? Можно заменить несколько незнакомых вещей, которые важно отметить:
+
+**1)** `*` - знак того, что `foo` является генератором. Вы можете поставить его
+в любое место между `function` и именем функции, не имеет значения куда именно.
+
+**2)** Выражение `yield` - останавливает генератор и отправляет строку `woo`.
+Это приостанавливает состояние генератора, пока мы не вызовем `next` (см **3)** ниже).
+Мы перезапускаем генератор, посылая строку `bar` в `foo`, которая станет возвращаемым
+значением выражения `yield` внутри `foo` (и будет присвоена к `stop`).
+
+**3)** функция `foo` имеет метод `next` который возвращает объект вида:
+`{value: VALUE_FROM_YIELD, done: IS_THIS_FINISHED}`.
+
+## Справка
+ - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*
+ - http://wiki.ecmascript.org/doku.php?id=harmony:generators
+
+## Задание
+
+Реализуйте функцию-генератор `range`, которая принимает аргументы **from** и **to**.
+
+Выведите числа в заданом диапазоне, по одному на каждой итерации.
+
+**Шаблон решения:**
+
+```js
+function *range(from, to) {
+  // ваш код здесь
+}
+
+for (var r of range(5, 10)) {
+    console.log( r );
+}
+// вывод: 5, 6, 7, 8, 9, 10
+```
diff --git a/i18n/credits/ru.footer.txt b/i18n/credits/ru.footer.txt
@@ -0,0 +1,2 @@
+
+{yellow}{bold}Rod Vagg (@rvagg){/yellow}{/bold} автор workshopper фреймворка (⌐■_■)
diff --git a/i18n/credits/ru.header.txt b/i18n/credits/ru.header.txt
@@ -0,0 +1,4 @@
+{yellow}{bold}Воркшоппер создан благодаря усилиям следующих людей:{/bold}{/yellow}
+
+{bold}Name                   GitHub          Twitter{/bold}
+-----------------------------------------------------
diff --git a/i18n/ru.json b/i18n/ru.json
@@ -0,0 +1,20 @@
+{
+  "title": "Изучаем Генераторы",
+  "subtitle": "Серия практических заданий по изучению ES6 генераторов",
+  "menu": {
+    "credits": "БЛАГОДАРНОСТЬ",
+    "completed": "DONE"
+  },
+  "error": {
+    "didnt_use_generators": "Кажется Вы не использовали генераторы в своем решении (ಠ_ಠ)",
+    "has_generators": "{red}Для работы с генераторами Вам необходимо установить nodejs >= 0.11.x or iojs >= {/red}\n\nВозможно, для этого вам понадобится:\n  {bold}nvm{/bold} https://github.com/creationix/nvm\n  {bold}n{/bold} https://github.com/tj/n"
+  },
+  "exercise": {
+    "RUN STOP RUN": "RUN STOP RUN",
+    "GENERATOR ITERATOR": "GENERATOR ITERATOR",
+    "DELEGATING GENERATORS": "DELEGATING GENERATORS",
+    "CATCH ERROR!": "CATCH ERROR!",
+    "LOOK SYNC. DO ASYNC.": "LOOK SYNC. DO ASYNC.",
+    "LOOK SYNC. MAKE PROMISE.": "LOOK SYNC. MAKE PROMISE."
+  }
+}
diff --git a/learn-generators.js b/learn-generators.js
@@ -9,10 +9,10 @@ function fpath (f) {
     return path.join(__dirname, f)
 }
 
-var learnGenerators = workshopper({
+const learnGenerators = workshopper({
     name        : 'learn-generators',
     appDir      : __dirname,
-    languages   : ['en', 'fr', 'ko'],
+    languages   : ['en', 'fr', 'ko', 'ru'],
     menuItems   : [{
         name : 'credits',
         handler : credits

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+`
	`2`	`+{yellow}{bold}Rod Vagg (@rvagg){/yellow}{/bold} автор workshopper фреймворка (⌐■_■)`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +{yellow}{bold}Воркшоппер создан благодаря усилиям следующих людей:{/bold}{/yellow}
++
 +{bold}Name                   GitHub          Twitter{/bold}
 +-----------------------------------------------------