Skip to content

ua_UA translation added #112

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

Open
wants to merge 7 commits into
base: master
Choose a base branch
from
Open
Changes from 1 commit
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
Prev Previous commit
Next Next commit
translated up to 2.C
  • Loading branch information
husa committed Apr 17, 2013
commit 2a636caf0a56606915080f9e05b660752c929028
108 changes: 54 additions & 54 deletions translations/ua_UA/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,34 +122,33 @@ UA

## Передмова

Следующие секции обрисовывают приемлемое руководство по стилю для современной разработки на языке JavaScript и не являются предписанием. Самое важное - это **закон написания консистентного кода**. Какой бы стиль вы ни выбрали для вашего проекта, он должен считаться законом. Сошлитесь на этот документ как заявление о приверженности вашего проекта к консистентности кода, читабельности и удобству сопровождения.
Наступні секції описують прийнятну інструкцію по стилю для сучасної розробки на JavaScript і не являються обов’язковими.Найважливіше - це **закон написання консистентного коду**. Який стиль ви б не вибрали для вашого проекту, він повинен вважатись законом. Ссилайтесь на даний документ як на заяву про відношення вашого проекту до консистентності коду, читабельності і зручності супроводу.



## Маніфест Ідіоматичного Стилю

## Манифест Идиоматического Стиля
1. <a name="whitespace">Пробіли, табуляція і порожні рядки</a>
- Ніколи не змішуйте пробіли і знаки табуляції.
- Перед тим як почати проект, перед тим, як писати код, виберіть між "м’якими" відступами(пробіли) або знаками табуляції і вважайте це **законом**.
- Для кращої читабельності коду, я завжди рекомендую виставити розмір відступу в вашому редакторі на 2 символи &mdash - це або два пробіли, або два пробіли які являються знаком табуляції.
- Завжди працюйте з увімкнутою опцією "показати приховане", якщо ваш редактор підтримує її. Переваги:
- вимушена послідовність
- видалення пробілу в кінці рядка
- видалення порожніх рядків
- читабельні коміти та діффи

1. <a name="whitespace">Пробелы, табуляция и пустые строки</a>
- Никогда не мешайте пробел и знак табуляции.
- Перед тем как начать проект, перед тем, как писать код, выберите между "мягкими" отступами (пробелами) или настоящими знаками табуляции и считайте это **законом**.
- Для лучшей читабельности кода, я всегда рекомендую выставлять размер отступа в вашем редакторе на 2 символа &mdash это либо два пробела, либо два пробела, которые представляют собой знак табуляции.
- Всегда работайте со включенной опцией "показать скрытое", если ваш редактор поддерживает ее. Преимущества:
- принужденная последовательность
- удаление пробела в конце строки
- удаление пустых строк
- читабельные коммиты и диффы
2. <a name="spacing">Гарний Синтаксис</a>

2. <a name="spacing">Красивый Синтаксис</a>

A. Скобки, Фигурные Скобки, Переносы Строк
A. Дужки, Фігурні Дужки, Перенос Рядка

```javascript

// if/else/for/while/try всегда разделяются пробелом,
// это улучшает читабельность
// if/else/for/while/try завжди розділяються пробілом,
// це покращує читабельність

// 2.A.1.1
// Пример неразборчивого синтаксиса
// // Приклад нерозбірливого синтаксису

if(condition) doSomething();

Expand All @@ -158,71 +157,72 @@ UA
for(var i=0;i<100;i++) someInterativeFn();

// 2.A.1.1
// Используйте пробелы для того, чтобы улучшить читабельность
// Використовуйте пробіли для того, щоб покращити читабельність

if ( condition ) {
// выражения
// вирази
}

while ( condition ) {
// выражения
// вирази
}

for ( var i = 0; i < 100; i++ ) {
// выражения
// вирази
}

// Еще лучше:
// Ще краще:

var i,
length = 100;

for ( i = 0; i < length; i++ ) {
// выражения
// вирази
}

// Или...
// Або...

var i = 0,
length = 100;

for ( ; i < length; i++ ) {
// выражения
// вирази
}

var prop;

for ( prop in object ) {
// выражения
// вирази
}


if ( true ) {
// выражения
// вирази
} else {
// выражения
// вирази
}
```


B. Присваивание, Объявление, Функции (Именованные, Функции-Выражения, Функции-Конструкторы)
B. Присвоєння, Оголошення, Функції(Іменовані, Функції-Вирази, Функціх-Конструктори)

```javascript

// 2.B.1.1
// Переменные
// Змінні
var foo = "bar",
num = 1,
undef;

// Объявление литералов:
// Оголошення літералів:
var array = [],
object = {};


// 2.B.1.2
// Использование только одного `var` на одну область видимости улучшает читабельность
// и упорядочивает блок объявления переменных (также сохраняет вам несколько нажатий клавиш)
// Використання тільки одного `var` на одну область видимості покращує читабельність

// і впорядковує блок оголошення змінних(також зберігає вам декілька символів)

// Неправильно
var foo = "";
Expand All @@ -234,20 +234,20 @@ UA
bar = "",
quux;

// или...
var // комментарий для переменных
// або...
var // коментар для змінних
foo = "",
bar = "",
quux;

// 2.B.1.3
// Оператор var всегда должен быть в начале области видимости (функции).
// То же самое верно для констант и оператора let из ECMAScript 6.
// Оператор var завжди повинен бути на початку області видимості(функції)
// Те саме вірно для констант і оператора let із ECMAScript 6.

// Неправильно
function foo() {

// выражения
// вирази

var bar = "",
qux;
Expand All @@ -258,50 +258,50 @@ UA
var bar = "",
qux;

// все выражения после объявления переменных.
// всі вирази після оголошеня змінних.
}
```

```javascript

// 2.B.2.1
// Объявление Именованных Функций
// Оголошення Іменованих Функцій
function foo( arg1, argN ) {

}

// Использование
// Використання
foo( arg1, argN );


// 2.B.2.2
// Объявление Именованных Функций
// Оголошення Іменованих Функцій
function square( number ) {
return number * number;
}

// Использование
// Використання
square( 10 );

// Очень надуманный стиль передачи параметров
// Дуже надуманий стиль передачі параметрів
function square( number, callback ) {
callback( number * number );
}

square( 10, function( square ) {
// обратный вызов
// зворотній виклик
});

// 2.B.2.3
// Функция-Выражение
// Функція-Вираз
var square = function( number ) {
// вернуть что-то ценное и важное
// повернути щось важливе і цінне
return number * number;
};

// Функция-Выражение с Идентификатором
// Такое объявление хорошо тем, что функция может вызвать сама себя
// и ее имя будет видно в стеке вызова функций:
// Функція-Вираз з Ідентифікатором
// Таке оголошення гарне тим, що функція може викликати сама себе
// і її ім’я буде видно в стеку викликів функцій:
var factorial = function factorial( number ) {
if ( number < 2 ) {
return 1;
Expand All @@ -311,13 +311,13 @@ UA
};

// 2.B.2.4
// Объявление Конструктора
// Оголошення Конструктора
function FooBar( options ) {

this.options = options;
}

// Использование
// Використання
var fooBar = new FooBar({ a: "alpha" });

fooBar.options;
Expand All @@ -326,7 +326,7 @@ UA
```


C. Исключения, Незначительные Отклонения от правил
C. Виключення, Незначні відхилення від правил

```javascript

Expand Down Expand Up @@ -1221,4 +1221,4 @@ UA

### Первая Запятая.

Любой проект, который ссылается на этот документ в качестве руководства по стилю, не примет форматирование кода "первой запятой", только если автор специально не укажется этого.
Любой проект, который ссылается на этот документ в качестве руководства по стилю, не примет форматирование кода "первой запятой", только если автор специально не укажется этого.