Skip to content

Fix after review: Manuals and specifications, Code editors, Developer console #422

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 26, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions 1-js/01-getting-started/2-manuals-specifications/article.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,35 @@

# Довідники й специфікації

Цей сайт *підручник*. Він спрямований на те, щоб допомогти вам поступово вивчити мову. Проте, як тільки ви познайомитеся з основами, вам знадобляться й інші джерела.
Цей сайт -- *підручник*. Він спрямований на те, щоб допомогти вам поступово вивчити мову. Проте, як тільки ви познайомитеся з основами, вам знадобляться й інші джерела.

## Специфікація

[Специфікація ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) містить найглибшу, найдетальнішу й найбільш формалізовану інформацію про JavaScript. Фактично, ця специфікація визначає мову.

Але саме через формалізований стиль її важко зрозуміти з першого разу. Тому, якщо вам потрібне найнадійніше джерело інформації про деталі мови, специфікація правильне місце. Однак, це джерело не для повсякденного використання.
Але саме через формалізований стиль її важко зрозуміти з першого разу. Тому, якщо вам потрібне найнадійніше джерело інформації про деталі мови, специфікація -- правильне місце. Однак, це джерело не для повсякденного використання.

Щороку випускається нова версія специфікації. Між цими випусками, остання «чернетка» доступна на сайті <https://tc39.es/ecma262/>.
Щороку випускається нова версія специфікації. Між цими випусками, остання "чернетка" доступна на сайті <https://tc39.es/ecma262/>.

Щоб прочитати про найновіші функції, включно з тими, які "майже входять в стандарт" (так звана "стадія 3"), перегляньте пропозиції на <https://github.com/tc39/proposals>.

Також, якщо ви розробляєте для браузерів, вам буде цікаво прочитати про інші специфікації, які описано в [другій частині](info:browser-environment) цього посібника.
Також, якщо ви розробляєте для браузерів, вам буде цікаво прочитати про інші специфікації, які описано в [другій частині](info:browser-environment) цього підручника.

## Довідники

- **MDN (Mozilla) JavaScript Reference** це головний довідник з прикладами та іншою інформацією. Він чудово підходить для детального вивчення окремих функцій, методів тощо.
- **MDN (Mozilla) JavaScript Reference** -- це головний довідник з прикладами та іншою інформацією. Він чудово підходить для детального вивчення окремих функцій, методів тощо.

Його можна знайти за цим посиланням <https://developer.mozilla.org/uk/docs/Web/JavaScript/Reference>.
Його можна знайти за цим посиланням <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.

Хоча, замість пошуку на сайті, краще використовувати пошукові системи. Просто напишіть "MDN [термін]" в пошуковому запиті. Наприклад, запит "[MDN parseInt](https://www.google.com.ua/search?q=MDN+parseInt)" знайде інформацію про функцію `parseInt`.

## Таблиці сумісності

Мова JavaScript активно розвивається до неї регулярно додаються нові функції.
Мова JavaScript активно розвивається -- до неї регулярно додаються нові функції.

Щоб дізнатися, чи підтримує браузер або інший рушій певну можливість JavaScript, дивіться на сайтах:

- <https://caniuse.com/> - для кожної технології приведено таблицю сумісності з усіма браузерами; тобто, щоб побачити, які браузери підтримують сучасні криптографічні функції, слід ввести в пошуку "[Cryptography](http://caniuse.com/#feat=cryptography)".
- <https://caniuse.com/> -- для кожної технології приведено таблицю сумісності з усіма браузерами; тобто, щоб побачити, які браузери підтримують сучасні криптографічні функції, слід ввести в пошуку "[Cryptography](http://caniuse.com/#feat=cryptography)".
- <https://kangax.github.io/compat-table> - таблиця з усіма можливостями мови та рушіями, які підтримують або не підтримують відповідні технології.

Всі ці ресурси корисні в повсякденній розробці, тому що вони містять корисну інформацію про деталі мови, їхню підтримку тощо.
14 changes: 7 additions & 7 deletions 1-js/01-getting-started/3-code-editors/article.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Редактори коду

Редактор коду це місце, де програмісти проводять найбільше часу.
Редактор коду -- це місце, де програмісти проводять найбільше часу.

Є два основні види редакторів коду: IDE і легкі редактори. Багато людей використовують декілька інструментів для різних потреб.
Є два основні види редакторів коду: IDE і легкі редактори. Багато людей використовують декілька таких редакторів для різних потреб.

## IDE

@@ -15,9 +15,9 @@ IDE завантажує проект (який може мати багато
- [Visual Studio Code](https://code.visualstudio.com/) (багатоплатформний, безкоштовний).
- [WebStorm](http://www.jetbrains.com/webstorm/) (багатоплатформний, платний).

Для Windows, також може бути "Visual Studio", не плутайте з "Visual Studio Code". "Visual Studio" потужний платний редактор, який працює лише на Windows, добре підходить для програмування на платформі .NET. Також хороший для програмування на JavaScript. Також існує його безкоштовна версія: [Visual Studio Community](https://www.visualstudio.com/vs/community/).
Для Windows, також може бути "Visual Studio", не плутайте з "Visual Studio Code". "Visual Studio" -- потужний платний редактор, який працює лише на Windows, добре підходить для програмування на платформі .NET. Також хороший для програмування на JavaScript. Також існує його безкоштовна версія: [Visual Studio Community](https://www.visualstudio.com/vs/community/).

Багато IDE платні, проте мають пробний період. Їхня вартість зазвичай незначна в порівнянні із зарплатою кваліфікованого розробника. Правильний вибір редактора дозволить зберегти найцінніший ресурс ваш час. Тому просто виберіть найкращий варіант, який задовольнятиме усім вашим потребам.
Багато IDE платні, проте мають пробний період. Їхня вартість зазвичай незначна в порівнянні із зарплатою кваліфікованого розробника. Правильний вибір редактора дозволить зберегти найцінніший ресурс -- ваш час. Тому просто виберіть найкращий варіант, який задовольнятиме усім вашим потребам.

## Легкі редактори

@@ -27,19 +27,19 @@ IDE завантажує проект (який може мати багато

Головна їхня відмінність від IDE в тому, що IDE працює на рівні проекту, тому він завантажує набагато більше даних під час запуску, і якщо потрібно, аналізує його структуру. Легкий редактор набагато швидший, якщо нам необхідно відредагували лише один файл.

На практиці, легкі редактори можуть мати багато плаґінів, включаючи аналізатори синтаксису на рівні проекту, автозаповнення і т. д. Тому немає чіткої межі між легкими редакторами та IDE.
На практиці, легкі редактори можуть мати багато плаґінів, включаючи аналізатори синтаксису на рівні проекту, автозаповнення і т. д. Через те, що це значно розширює їх можливості, немає чіткої межі між легкими редакторами та IDE.

Ось ці варіанти заслуговують вашої уваги:

- [Atom](https://atom.io/) (багатоплатформний, безкоштовний).
- [Sublime Text](http://www.sublimetext.com) (багатоплатформний, випробувальний термін).
- [Sublime Text](http://www.sublimetext.com) (багатоплатформний, безкоштовний на час випробувального терміну).
- [Notepad++](https://notepad-plus-plus.org/) (Windows, безкоштовний).
- [Vim](http://www.vim.org/) та [Emacs](https://www.gnu.org/software/emacs/) також хороші, якщо знати, як ними користуватися.

## Не будемо сперечатися

Я, та мої хороші друзі-розробники, вже давно користуємося цими редакторами, і вони цілком задовольняють усім нашим потребам.

У нашому великому світі є й інші редактори. Будь ласка, потратьте трохи часу на перегляд декількох редакторів, і виберіть той, який вам найбільш до вподоби.
У нашому великому світі є й інші редактори. Будь ласка, приділіть трохи часу на перегляд декількох редакторів, і виберіть той, який вам найбільш до вподоби.

Вибір редактора, як і будь-якого іншого інструменту, індивідуальний, і залежить від ваших проєктів, звичок і персональних вподобань.
14 changes: 7 additions & 7 deletions 1-js/01-getting-started/4-devtools/article.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# Інструменти розробника

Будь-який код так і тяжіє до помилок. Швидше за все, ви будете робити помилки... Хоча, про що я говорю? Ви *точно* будете робити помилки, принаймні, якщо ви людина, а не [робот](https://uk.wikipedia.org/wiki/Бендер_(Футурама)).
Будь-який код схильний до помилок. Швидше за все, ви будете робити помилки... Хоча, про що я говорю? Ви *точно* будете робити помилки, принаймні, якщо ви людина, а не [робот](https://uk.wikipedia.org/wiki/Бендер_(Футурама)).

Зазвичай, користувачі не бачать помилок у браузері. Тому, якщо в скрипті трапиться щось хибне, ми не побачимо помилки і не зможемо її виправити.

Щоб побачити помилки і отримати багато інформації про скрипти, було створено і вбудовано в браузери "інструменти розробника".
Щоб побачити помилки і отримати додаткову інформацію про виконання скриптів, було створено і вбудовано в браузери "інструменти розробника".

Більшість розробників надають перевагу Chrome чи Firefox, тому що ці браузери мають найкращі інструменти розробника. Інші браузери теж мають інструменти розробника, деколи навіть зі спеціальними функціями, проте вони не такі популярні, як Chrome чи Firefox. Тому більшість розробників мають "улюблений" браузер і переключаються на інші, якщо проблема специфічна для браузера.

Інструменти розробника потужні; вони мають багато функцій. Для початку, ми вивчимо, як їх відкрити, як спостерігати за помилками і як виконувати команди JavaScript.
Інструменти розробника потужні; вони мають багато функцій. Для початку, ми вивчимо, як їх відкрити, як переглядати помилки і як виконувати команди JavaScript.

## Google Chrome

@@ -18,7 +18,7 @@

Натисніть клавішу `key:F12` або, якщо у вас Mac, комбінацію клавіш `key:Cmd+Opt+J`.

Інструменти розробника усталено відкриваються на вкладці "Console" (консоль).
Інструменти розробника типово відкриваються на вкладці "Console" (консоль).

Ось так відображається помилка в консолі:

@@ -27,11 +27,11 @@
Точний вигляд інструментів розробника може відрізнятися в залежності від вашої версії Chrome. Вони міняються час від часу, але в основному це вікно повинно бути схожим.

- Тут ми можемо побачити червоне повідомлення про помилку. У нашому випадку, скрипт має невизначену команду "lalala".
- З правого боку є посилання на джерело `bug.html:12` з номером рядка, де ця помилка виникла. При натисканні на це посилання, інструмент перейде на вкладку "Sources" (джерела, початковий код), де відкриє файл і перейде на рядок, в якому трапилася помилка.
- З правого боку є посилання на джерело `bug.html:12` з номером рядка, де ця помилка виникла. При натисканні на це посилання, вас перенаправить на вкладку "Sources" (файли з кодом сторінки), де відкриється файл і перейде на рядок, в якому трапилася помилка.

Нижче повідомлення про помилку є синій символ `>`. Цей символ позначає "командний рядок", де ми можемо вводити команди JavaScript. Натисніть `key:Enter`, щоб їх виконати.

Тепер ми бачимо помилки, цього достатньо, щоб почати. Ми пізніше повернемося до інструментів розробника, щоб розглянути відлагодження у розділі <info:debugging-chrome>.
Тепер ми бачимо помилки, цього достатньо, щоб почати. Ми пізніше повернемося до інструментів розробника, щоб розглянути налагодження коду у розділі <info:debugging-chrome>.

```smart header="Введення декількох рядків"
Зазвичай, коли ми вводимо один рядок коду в консоль і натискаємо `key:Enter`, він виконується.
@@ -43,7 +43,7 @@

Більшість браузерів використовують клавішу `key:F12`, щоб відкрити консоль розробника.

Їх вигляд зазвичай схожий. Якщо ви навчитеся використовувати однин з них (можете почати з Chrome), ви зможете легко переключитися на інший інструмент.
Їх вигляд зазвичай схожий. Якщо ви навчитеся використовувати однин з них (можете почати з Chrome), ви зможете легко переключитися на інший браузер.

## Safari

Original file line number Diff line number Diff line change
@@ -15,7 +15,7 @@ let user = {

**Помилка з'являється, оскільки крапка з комою відсутня після `user = {...}`.**

JavaScript не вставляэ автоматично крапку з комою перед дужками `(user.go)()` тому, що він читає код, як:
JavaScript не вставляє автоматично крапку з комою перед дужками `(user.go)()` тому, що він читає код, як:

```js no-beautify
let user = { go:... }(user.go)()