Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Update Russian translation

  • Loading branch information...
commit 2d85bbf40879e5f133496c0d39be8f3613592aac 1 parent 5d9a941
Anton Vasyunin thevasya authored committed
Showing with 46 additions and 44 deletions.
  1. +46 −44 translations/ru-RU/README.md
90 translations/ru-RU/README.md
View
@@ -1,14 +1,16 @@
-# Идиомы CSS
+# Принципы написания однородного CSS-кода
-Этот документ представляет собой общие рекомендации по стилю написания CSS.
-Он не был задуман как набор жёстких правил, и мне бы не хотелось навязывать
+Этот документ представляет собой общие рекомендации по стилю написания CSS. Он
+не был задуман как набор жёстких правил, и мне бы не хотелось навязывать
собственные предпочтения другим людям. Тем не менее, данное руководство
-призывает к использованию общепринятых и устоявшихся подходов к написанию кода.
+призывает к использованию общепринятых и устоявшихся подходов к написанию
+кода.
-Этот документ не закончен, и новые идеи всегда приветствуются. Вы можете
-внести свой вклад.
+Этот документ не закончен, и новые идеи всегда приветствуются. Пожалуйста,
+внесите свой вклад.
-[Idiomatic CSS in English (Original)](https://github.com/necolas/idiomatic-css/blob/master/README.md)
+[«Принципы написания однородного CSS» на английском языке
+(Original)](https://github.com/necolas/idiomatic-css)
## Содержание
@@ -18,7 +20,7 @@
3. [Комментарии](#comments)
4. [Форматирование](#format)
5. [Именование](#naming)
-6. [Практические примеры](#example)
+6. [Практический пример](#example)
7. [Организация кода](#organization)
8. [Сборка и развёртывание](#build-and-deployment)
@@ -29,13 +31,13 @@
## 1. Общие принципы
> «Вы сослужите проекту хорошую службу, если будете осознавать, что написание
-> кода только для себя — Плохая Идея™. Если тысячи людей используют ваш код,
-> то пишите его максимально ясным и не делайте что-то только потому, что
+> кода только для себя — Плохая Идея™. Если тысячи людей используют ваш код, то
+> пишите его максимально ясным и не делайте что-то только потому, что
> спецификация языка допускает это». — Idan Gazit
* Весь код в любом проекте должен выглядеть так, будто его создал один человек,
вне зависимости от того, сколько людей на самом деле принимали участие.
-* Строго соблюдайте договорённости.
+* Строго соблюдайте соглашения.
* В сомнительных случаях используйте общепринятый подход.
@@ -49,21 +51,21 @@
* _Никогда_ не смешивайте пробелы и табуляцию.
* Между табуляцией и мягкими отступами (пробелы вместо табуляции) выберите
что-то одно. Придерживайтесь своего выбора, не делая исключений.
- (Предпочтение: пробелы)
+(Предпочтение: пробелы)
* Если вы используете пробелы, определитесь с количеством символов,
соответствующим одному уровню отступа. (Предпочтение: 4 пробела)
Совет: настройте редактор кода так, чтобы он отображал невидимые символы. Это
-позволит избегать случайных пробелов в конце строк или в пустых строках и
-легче отслеживать изменения в коде.
+позволит избегать случайных пробелов в конце строк или в пустых строках и легче
+отслеживать изменения в коде.
<a name="comments"></a>
## 3. Комментарии
Хорошо откомментированный код очень важен. Потратьте время на то, чтобы описать
-компоненты, особенности их работы, ограничения и то, как они были созданы.
-Не заставляйте других членов команды гадать над назначением неочевидного кода.
+компоненты, особенности их работы, ограничения и то, как они были созданы. Не
+заставляйте других членов команды гадать над назначением неочевидного кода.
Стиль комментариев должен быть простым и однородным для всего проекта.
@@ -117,8 +119,8 @@
<a name="format"></a>
## 4. Форматирование
-Выбранный формат записи кода должен гарантировать, что код легко читается;
-что его легко комментировать; должен минимизировать шанс случайного внесения
+Выбранный формат записи кода должен гарантировать, что код легко читается; что
+его легко комментировать; должен минимизировать шанс случайного внесения
ошибки; и в результате обеспечивать удобство чтения сообщений внутри системы
управления версиями.
@@ -148,10 +150,10 @@
#### Порядок объявлений
-Объявления должны быть упорядочены по единому принципу. Я предпочитаю объединять
-их по смыслу и помещать структурные свойства (т.е. те, что отвечают за
-позиционирование и блочную модель), как более важные, перед свойствами,
-связанными с типографикой, фоном и цветом.
+Объявления должны быть упорядочены по единому принципу. Я предпочитаю
+объединять их по смыслу и помещать структурно важные свойства (например, те,
+что отвечают за позиционирование и блочную модель) перед свойствами, связанными
+с типографикой, фоном и цветом.
```css
.selector {
@@ -167,16 +169,16 @@
}
```
-Упорядочивание по алфавиту тоже популярно, но его минус в том, что связанные по
+Упорядочение по алфавиту тоже популярно, но его минус в том, что связанные по
смыслу свойства оказываются разделены. К примеру, свойства, связанные с
-отступами, могут встречаться как в начале, так и в конце одного и того же блока
-определений.
+отступами, могут встречаться как в начале, так и в конце одного и того же
+блока определений.
#### Исключения и небольшие отклонения
К большим группам правил, состоящих из одного свойства, может применяться
-запись в одну строку. В таком случае следует ставить пробел после открывающей
-и перед закрывающей скобками.
+запись в одну строку. В таком случае следует ставить пробел после открывающей и
+перед закрывающей скобками.
```css
.selector-1 { width: 10%; }
@@ -184,9 +186,9 @@
.selector-3 { width: 30%; }
```
-Длинные значения свойств, разделяемые запятыми — как, например, набор градиентов
-или теней — могут быть помещены на отдельной строке каждое, чтобы повысить
-читабельность кода, а также сообщений в системе управления версиями. Формат
+Длинные значения свойств, разделяемые запятыми — как, например, набор
+градиентов или теней — могут быть помещены на отдельной строке каждое, чтобы
+повысить читабельность кода и сообщений в системе управления версиями. Формат
записи может слегка различаться, один из вариантов приведён ниже.
```css
@@ -217,18 +219,18 @@
использования конкретного препроцессора. Следующий набор правил относится
к Sass.
-* Ограничивайте вложенность одним уровнем. Переписывайте все правила, в которых
+* Ограничивайте вложенность одним уровнем. Пересмотрите все правила, в которых
больше двух уровней вложенности. Это позволит избегать чрезмерной
специфичности правил.
* Избегайте большого числа вложенных правил. Оформляйте их отдельно,
- когда их становится трудно читать. Предпочительно ограничивать длину вложенных
- правил 20 строками.
+ когда их становится трудно читать. Предпочтительно ограничивать длину
+ вложенных правил 20 строками.
* Всегда помещайте оператор `@extend` в первой строке блока объявлений.
* По возможности группируйте операторы `@include` в начале блока объявлений,
сразу после `@extend`.
* Подумайте над добавлением префикса вида `x-` перед своими функциями. Это
- позволит избежать возможной путаницы между вашими функциями и нативными
- функциями в CSS, а также функциями из сторонних библиотек.
+ позволит избежать возможной путаницы между вашими функциями и стандартными
+ функциями CSS, а также функциями из сторонних библиотек.
```scss
.selector-1 {
@@ -236,7 +238,7 @@
@include clearfix();
@include box-sizing(border-box);
width: x-grid-unit(1);
- // остальные объявления
+ // прочие объявления
}
```
@@ -246,9 +248,9 @@
Вы не компилятор и не компрессор кода, поэтому ведите себя соответственно.
-Используйте простые и осмысленные имена для классов в HTML. Выберите понятный и
-последовательный шаблон именования, который будет удобен как для HTML, так и для
-CSS.
+Используйте понятные и осмысленные имена для классов в HTML. Выберите ясный и
+последовательный шаблон именования, который будет удобен как для HTML, так и
+для CSS.
```css
/* Пример кода с плохими именами */
@@ -295,7 +297,7 @@ CSS.
.grid {
overflow: visible;
height: 100%;
- /* Нормализуем поведение ячеек типа inline-block */
+ /* Предотвращаем перенос строчных блоков на новую строку */
white-space: nowrap;
/* Убираем пробелы между ячейками сетки */
font-size: 0;
@@ -311,7 +313,7 @@ CSS.
padding: 0 10px;
border: 2px solid #333;
vertical-align: top;
- /* Восстанавливаем преформатирование по умолчанию */
+ /* Восстанавливаем поведение по умолчанию */
white-space: normal;
/* Восстанавливаем размер шрифта */
font-size: 16px;
@@ -348,7 +350,7 @@ CSS.
Организация кода — важная часть любого проекта на CSS и ключевой элемент в
большом проекте.
-* Логически разделяйте отдельные части кода.
+* Логически отделяйте различные части кода.
* Используйте отдельные файлы (объединяемые на этапе сборки), чтобы разделить
код обособленных компонентов.
* При использовании препроцессора оформляйте часто используемый код в
@@ -360,8 +362,8 @@ CSS.
В любом проекте по возможности должны использоваться средства для проверки,
тестирования, сжатия и управления версиями кода при подготовке к развёртыванию.
-Хорошая утилита для этих задач —
-[grunt](https://github.com/cowboy/grunt), написанная Ben Alman.
+Хороший инструмент для этих задач —
+[grunt](https://github.com/cowboy/grunt), написанный Ben Alman.
<a name="acknowledgements"></a>
Please sign in to comment.
Something went wrong with that request. Please try again.