javascript-tutorial · javascript-translate-bot · May 11, 2020 · May 15, 2020 · May 16, 2020 · May 16, 2020
diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md
@@ -4,16 +4,25 @@
 
 ## Что такое JavaScript?
 
+<<<<<<< HEAD
 Изначально *JavaScript* был создан, чтобы *"сделать веб-страницы живыми"*.
+=======
+*JavaScript* was initially created to "make web pages alive".
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 Программы на этом языке называются *скриптами*. Они могут встраиваться в HTML и выполняться автоматически при загрузке веб-страницы.
 
 Скрипты распространяются и выполняются, как простой текст. Им не нужна специальная подготовка или компиляция для запуска.
 
 Это отличает JavaScript от другого языка - [Java](https://ru.wikipedia.org/wiki/Java).
 
+<<<<<<< HEAD
 ```smart header="Почему <u>Java</u>Script?"
 Когда JavaScript создавался, у него было другое имя - "LiveScript". Однако, язык Java был очень популярен в то время, и было решено, что позиционирование JavaScript как "младшего брата" Java будет полезно.
+=======
+```smart header="Why is it called <u>Java</u>Script?"
+When JavaScript was created, it initially had another name: "LiveScript". But Java was very popular at that time, so it was decided that positioning a new language as a "younger brother" of Java would help.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 Со временем JavaScript стал полностью независимым языком со своей собственной спецификацией, называющейся [ECMAScript](http://ru.wikipedia.org/wiki/ECMAScript), и сейчас не имеет никакого отношения к Java.
 ```
@@ -38,7 +47,11 @@
 2. Затем он преобразует ("компилирует") скрипт в машинный язык.
 3. После этого машинный код запускается и работает достаточно быстро.
 
+<<<<<<< HEAD
 Движок применяет оптимизации на каждом этапе. Он даже просматривает скомпилированный скрипт во время его работы, анализируя проходящие через него данные, и применяет оптимизации к машинному коду, полагаясь на полученные знания. В результате скрипты работают очень быстро.
+=======
+The engine applies optimizations at each step of the process. It even watches the compiled script as it runs, analyzes the data that flows through it, and further optimizes the machine code based on that knowledge.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 ```
 
 ## Что может JavaScript в браузере?
@@ -63,7 +76,11 @@
 
 Примеры таких ограничений включают в себя:
 
+<<<<<<< HEAD
 - JavaScript на веб-странице не может читать/записывать произвольные файлы на жёстком диске, копировать их или запускать программы. Он не имеет прямого доступа к системным функциям ОС.
+=======
+- JavaScript on a webpage may not read/write arbitrary files on the hard disk, copy them or execute programs. It has no direct access to OS functions.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
     Современные браузеры позволяют ему работать с файлами, но с ограниченным доступом, и предоставляют его, только если пользователь выполняет определённые действия, такие как "перетаскивание" файла в окно браузера или его выбор с помощью тега `<input>`.
 
@@ -106,10 +123,18 @@ JavaScript - это единственная браузерная техноло
 
 Примеры таких языков:
 
+<<<<<<< HEAD
 - [CoffeeScript](http://coffeescript.org/) добавляет "синтаксический сахар" для JavaScript. Он вводит более короткий синтаксис, который позволяет писать чистый и лаконичный код. Обычно такое нравится Ruby-программистам.
 - [TypeScript](http://www.typescriptlang.org/) концентрируется на добавлении "строгой типизации" для упрощения разработки и поддержки больших и сложных систем. Разработан Microsoft.
 - [Flow](http://flow.org/) тоже добавляет типизацию, но иначе. Разработан Facebook.
 - [Dart](https://www.dartlang.org/) стоит особняком, потому что имеет собственный движок, работающий вне браузера (например, в мобильных приложениях). Первоначально был предложен Google, как замена JavaScript, но на данный момент необходима его транспиляция для запуска так же, как для вышеперечисленных языков.
+=======
+- [CoffeeScript](http://coffeescript.org/) is a "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
+- [TypeScript](http://www.typescriptlang.org/) is concentrated on adding "strict data typing" to simplify the development and support of complex systems. It is developed by Microsoft.
+- [Flow](http://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
+- [Dart](https://www.dartlang.org/) is a standalone language that has its own engine that runs in non-browser environments (like mobile apps), but also can be transpiled to JavaScript. Developed by Google.
+- [Brython](https://brython.info/) is a Python transpiler to JavaScript that allow to write application in pure Python without JavaScript.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 Есть и другие. Но даже если мы используем один из этих языков, мы должны знать JavaScript, чтобы действительно понимать, что мы делаем.
 

diff --git a/1-js/01-getting-started/4-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md
@@ -29,12 +29,23 @@ Chrome и Firefox снискали любовь подавляющего бол
 - В консоли мы можем увидеть сообщение об ошибке, отрисованное красным цветом. В нашем случае скрипт содержит неизвестную команду "lalala".
 - Справа присутствует ссылка на исходный код `bug.html:12` с номером строки кода, в которой эта ошибка и произошла.
 
+<<<<<<< HEAD
 Под сообщением об ошибке находится синий символ `>`. Он обозначает командную строку, в ней мы можем редактировать и запускать JavaScript-команды. Для их запуска нажмите `key:Enter`.
+=======
+Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 ```smart header="Многострочный ввод"
 Обычно при нажатии `key:Enter` введённая строка кода сразу выполняется.
 
+<<<<<<< HEAD
 Чтобы перенести строку, нажмите `key:Shift+Enter`. Так можно вводить более длинный JS-код.
+=======
+```smart header="Multi-line input"
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+
+To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 ```
 
 Теперь мы явно видим ошибки, для начала этого вполне достаточно. Мы ещё вернёмся к инструментам разработчика позже и более подробно рассмотрим отладку кода в главе <info:debugging-chrome>.
@@ -52,11 +63,15 @@ Safari (браузер для Mac, не поддерживается в сист
 
 Откройте Настройки (Preferences) и перейдите к панели "Продвинутые" (Advanced). В самом низу вы найдёте чекбокс:
 
+<<<<<<< HEAD
 ![safari](safari.png)
 
 Теперь консоль можно активировать нажатием клавиш `key:Cmd+Opt+C`. Также обратите внимание на новый элемент меню "Разработка" ("Develop"). В нем содержится большое количество команд и настроек.
 
 ## Итого
+=======
+## Summary
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 - Инструменты разработчика позволяют нам смотреть ошибки, выполнять команды, проверять значение переменных и ещё много всего полезного.
 - В большинстве браузеров, работающих под Windows, инструменты разработчика можно открыть, нажав `key:F12`. В Chrome для Mac используйте комбинацию `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (необходимо предварительное включение "Меню разработчика").

diff --git a/1-js/02-first-steps/01-hello-world/1-hello-alert/index.html b/1-js/02-first-steps/01-hello-world/1-hello-alert/index.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+
+<body>
+
+  <script>
+    alert( "I'm JavaScript!" );
+  </script>
+
+</body>
+
+</html>
diff --git a/1-js/02-first-steps/01-hello-world/1-hello-alert/solution.md b/1-js/02-first-steps/01-hello-world/1-hello-alert/solution.md
@@ -0,0 +1,2 @@
+
+[html src="index.html"]
diff --git a/1-js/02-first-steps/01-hello-world/article.md b/1-js/02-first-steps/01-hello-world/article.md
@@ -43,8 +43,13 @@
 
 Тег `<script>` имеет несколько атрибутов, которые редко используются, но всё ещё могут встретиться в старом коде:
 
+<<<<<<< HEAD
 Атрибут `type`: <code>&lt;script <u>type</u>=...&gt;</code>
 : Старый стандарт HTML, HTML4, требовал наличия этого атрибута в теге `<script>`. Обычно он имел значение `type="text/javascript"`. На текущий момент этого больше не требуется. Более того, в современном стандарте HTML смысл этого атрибута полностью изменился. Теперь он может использоваться для JavaScript-модулей. Но это тема не для начального уровня, и о ней мы поговорим в другой части учебника.
+=======
+The `type` attribute: <code>&lt;script <u>type</u>=...&gt;</code>
+: The old HTML standard, HTML4, required a script to have a `type`. Usually it was `type="text/javascript"`. It's not required anymore. Also, the modern HTML standard totally changed the meaning of this attribute. Now, it can be used for JavaScript modules. But that's an advanced topic, we'll talk about modules in another part of the tutorial.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 Атрибут `language`: <code>&lt;script <u>language</u>=...&gt;</code>
 : Этот атрибут должен был задавать язык, на котором написан скрипт. Но так как JavaScript является языком по умолчанию, в этом атрибуте уже нет необходимости.
@@ -75,7 +80,7 @@
 Можно указать и полный URL-адрес. Например:
 
 ```html
-<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/3.2.0/lodash.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.11/lodash.js"></script>
 ```
 
 Для подключения нескольких скриптов используйте несколько тегов:

diff --git a/1-js/02-first-steps/02-structure/article.md b/1-js/02-first-steps/02-structure/article.md
@@ -94,7 +94,11 @@ alert("Сейчас будет ошибка")[1, 2].forEach(alert)
 
 ## Комментарии
 
+<<<<<<< HEAD
 Со временем программы становятся всё сложнее и сложнее. Возникает необходимость добавлять *комментарии*, которые бы описывали, что делает код и почему.
+=======
+## Comments [#code-comments]
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 Комментарии могут находиться в любом месте скрипта. Они не влияют на его выполнение, поскольку движок просто игнорирует их.
 
@@ -134,8 +138,13 @@ alert('Привет');
 alert('Мир');
 ```
 
+<<<<<<< HEAD
 ```smart header="Используйте горячие клавиши!"
 В большинстве редакторов строку кода можно закомментировать, нажав комбинацию клавиш `key:Ctrl+/` для однострочного комментария и что-то, вроде `key:Ctrl+Shift+/` -- для многострочных комментариев (выделите кусок кода и нажмите комбинацию клавиш). В системе Mac попробуйте `key:Cmd` вместо `key:Ctrl`.
+=======
+```smart header="Use hotkeys!"
+In most editors, a line of code can be commented out by pressing the `key:Ctrl+/` hotkey for a single-line comment and something like `key:Ctrl+Shift+/` -- for multiline comments (select a piece of code and press the hotkey). For Mac, try `key:Cmd` instead of `key:Ctrl` and `key:Option` instead of `key:Shift`.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 ```
 
 ````warn header="Вложенные комментарии не поддерживаются!"

diff --git a/1-js/02-first-steps/03-strict-mode/article.md b/1-js/02-first-steps/03-strict-mode/article.md
@@ -19,8 +19,12 @@
 ...
 ```
 
+<<<<<<< HEAD
 Позже мы изучим функции (способ группировки команд). Забегая вперёд, заметим, что вместо всего скрипта `"use strict"` можно поставить в начале большинства видов функций. Это позволяет включить строгий режим только в конкретной функции. Но обычно люди используют его для всего файла.
 
+=======
+Quite soon we're going to learn functions (a way to group commands), so let's note in advance that `"use strict"` can be put at the beginning of a function. Doing that enables strict mode in that function only. But usually people use it for the whole script.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 ````warn header="Убедитесь, что \"use strict\" находится в начале"
 Проверьте, что `"use strict"` находится в первой исполняемой строке скрипта, иначе строгий режим может не включиться.
@@ -42,16 +46,30 @@ alert("some code");
 ```warn header="Нет никакого способа отменить `use strict`"
 Нет директивы типа `"no use strict"`, которая возвращала бы движок к старому поведению.
 
+<<<<<<< HEAD
 Как только мы входим в строгий режим, отменить это невозможно.
+=======
+Once we enter strict mode, there's no going back.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 ```
 
 ## Консоль браузера
 
+<<<<<<< HEAD
 В будущем, когда вы будете использовать консоль браузера для тестирования функций, обратите внимание, что `use strict` по умолчанию в ней выключен.
+=======
+When you use a [developer console](info:devtools) to run code, please note that it doesn't `use strict` by default.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 Иногда, когда `use strict` имеет значение, вы можете получить неправильные результаты.
 
+<<<<<<< HEAD
 Можно использовать `key:Shift+Enter` для ввода нескольких строк и написать в верхней строке `use strict`:
+=======
+So, how to actually `use strict` in the console?
+
+First, you can try to press `key:Shift+Enter` to input multiple lines, and put `use strict` on top, like this:
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 ```js
 'use strict'; <Shift+Enter для перехода на новую строку>
@@ -61,12 +79,17 @@ alert("some code");
 
 В большинстве браузеров, включая Chrome и Firefox, это работает.
 
+<<<<<<< HEAD
 В старых браузерах консоль не учитывает такой `use strict`, там можно "оборачивать" код в функцию, вот так:
+=======
+If it doesn't, e.g. in an old browser, there's an ugly, but reliable way to ensure `use strict`. Put it inside this kind of wrapper:
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a
 
 ```js
 (function() {
   'use strict';
 
+<<<<<<< HEAD
   // ...ваш код...
 })()
 ```
@@ -83,3 +106,24 @@ alert("some code");
 2. Строгий режим включается путём размещения `"use strict"` в начале скрипта или функции. Некоторые функции языка, такие как "классы" и "модули", автоматически включают строгий режим.
 3. Строгий режим поддерживается всеми современными браузерами.
 4. Мы рекомендуем всегда начинать скрипты с `"use strict"`. Все примеры в этом руководстве предполагают строгий режим, если (очень редко) не указано иное.
+=======
+  // ...your code here...
+})()
+```
+
+## Should we "use strict"?
+
+The question may sound obvious, but it's not so.
+
+One could recommend to start scripts with `"use strict"`... But you know what's cool?
+
+Modern JavaScript supports "classes" and "modules" - advanced language structures (we'll surely get to them), that enable `use strict` automatically. So we don't need to add the `"use strict"` directive, if we use them.
+
+**So, for now `"use strict";` is a welcome guest at the top of your scripts. Later, when your code is all in classes and modules, you may omit it.**
+
+As of now, we've got to know about `use strict` in general.
+
+In the next chapters, as we learn language features, we'll see the differences between the strict and old modes. Luckily, there aren't many and they actually make our lives better.
+
+All examples in this tutorial assume strict mode unless (very rarely) specified otherwise.
+>>>>>>> f830bc5d9454d85829e011d914f215eb5896579a