Merge pull request #164 from Grawl/gh-pages

fix and update RU

Author: KittyGiraudel

_sass/base/_typography.scss

@@ -61,6 +61,14 @@ h3 {
   text-transform: uppercase;
 }
 
+// Russian do not capitalize every word in a header
+// See https://github.com/HugoGiraudel/sass-guidelines/issues/163
+:lang(ru) {
+  h1, h2, h3 {
+    text-transform: initial;
+  }
+}
+
 /**
  * Images
  */

ru/_architecture.md

@@ -15,8 +15,6 @@
   <p>Я понял, что в основном архитектура зависит от проекта. Используйте или адаптируйте предложенное решение так, чтобы вы имели дело с системой, которая соответствует вашим потребностям.</p>
 </div>
 
-
-
 ### Дальнейшее чтение
 
 * [Architecture for a Sass project](http://www.sitepoint.com/architecture-sass-project/)
@@ -26,11 +24,6 @@
 * [An Introduction to OOCSS](http://www.smashingmagazine.com/2011/12/12/an-introduction-to-object-oriented-css-oocss/)
 * [Atomic Web Design](http://bradfrost.com/blog/post/atomic-web-design/)
 
-
-
-
-
-
 ## Компоненты
 
 Существует главное отличие между тем, чтобы сделать код *работающим*, или сделать его *хорошим*. Опять таки, CSS – вполне несносный язык <sup>[указать источник]</sup>. Чем меньше CSS мы имеем, тем лучше. Мы не хотим иметь дело с мегабайтами кода. Чтобы держать файлы стилей короткими и эффективными – и это не будет для вас сюрпризом – чаще всего будет хорошей идеей подумать об интерфейсе, как о наборе компонентов.
@@ -45,11 +38,6 @@
 
 Большинство интерфейсов можно рассматривать как набор маленьких компонентов, и я настоятельно рекомендую вам придерживаться этой парадигмы. Это позволит не только сократить количество CSS, необходимого для всего проекта, но также упростить его поддержку, и прибрать хаотический беспорядок.
 
-
-
-
-
-
 ## Шаблон 7-1
 
 Возвратимся к архитектуре? Я обычно использую так называемый *Шаблон 7-1*: 7 папок, 1 файл. Обычно у вас есть все ваши куски в 7 разных папках, и один файл в корневом каталоге (обычно с именем `main.scss`), который импортирует их все.
@@ -131,8 +119,6 @@ sass/
   <p>Следующие файлы имеют то же соглашение по именованию, что и выше: они отделены нижним подчеркиванием.</p>
 </div>
 
-
-
 ### Папка Base
 
 Папка `base/` содержит то, что мы можем назвать общим шаблоном проекта. Там вы можете найти файл сброса, некоторые типографские правила, и, вероятно, стили (я привык их называть `_base.scss`), определяющие некоторые стандартные стили для часто используемых элементов HTML.
@@ -141,8 +127,6 @@ sass/
 * `_reset.scss`
 * `_typography.scss`
 
-
-
 ### Папка Layout
 
 Папка `layout/` содержит всё, что принимает участие в постройке раскладки сайта или приложения. Эта папка может содержать стили для основных частей сайта (шапка, подвал, навигация, боковая панель…), сетка или даже CSS-стили для всех форм.
@@ -158,8 +142,6 @@ sass/
   <p>Папка <code>layout/</code> может быть названа <code>partials/</code>, на ваше усмотрение.</p>
 </div>
 
-
-
 ### Папка Components
 
 Для маленьких компонентов есть папка `components/`. В то время, как `layout/` –  *основные* (определяют общий каркас), код внутри `components/` больше сфокусирован на виджетах и содержит все модули, вроде слайдера, загрузчика и тому подобных виджетов. Обычно файлов в `components/` много, если приложение или сайт состоит из множества мелких модулей.
@@ -172,8 +154,6 @@ sass/
   <p>Папка <code>components/</code> может называться <code>modules/</code>, на ваше усмотрение.</p>
 </div>
 
-
-
 ### Папка Pages
 
 Если у вас есть стили, зависящие от страницы, лучше положить их в папку `pages/`, в файл, названный в честь страницы. Например, не редкость – иметь очень конкретные стили для главной страницы, следовательно, существует потребность в `_home.scss` в `pages/`.
@@ -185,8 +165,6 @@ sass/
   <p>В зависимости от способа доставки кода, эти файлы можно было бы назвать самостоятельно, чтобы избежать их объединения с другими стилями. На ваше усмотрение.</p>
 </div>
 
-
-
 ### Папка Themes
 
 В больших сайтах и проложениях не редко есть разные темы оформления. Есть разные способы работы с темами, я лично предпочитаю складывать их в папку `themes/`.
@@ -198,8 +176,6 @@ sass/
   <p>Это очень зависит от проекта и не сильно распространено.</p>
 </div>
 
-
-
 ### Папка Utils
 
 Папка `utils/` собирает все инструменты и помощники Sass в проекте. Каждая глобальная переменная, функция и примесь должна быть помещена сюда.
@@ -215,8 +191,6 @@ sass/
   <p>Папка <code>utils/</code> может также быть названа <code>helpers/</code>, <code>sass-helpers/</code> или <code>sass-utils/</code>, на ваше усмотрение.</p>
 </div>
 
-
-
 ### Папка Vendors
 
 И последнее, но не менее важное, что большинство проектов будут иметь папку `vendors/`, содержащую все CSS-файлы из внешних библиотек и фреймворков – Normalize, Bootstrap, jQueryUI, FancyCarouselSliderjQueryPowered и так далее. Нахождение этих файлов в этой папке – хороший способ сказать: "Эй, это не я писал, не мой код, не моя ответственность".
@@ -230,8 +204,6 @@ sass/
 
 Например, файл `vendors-extensions/_boostrap.scss`, содержащий все CSS-правила на перезапись CSS-правил Bootstrap. Это для того, чтобы не править сами внешние модули, что на самом деле не очень хорошая идея.
 
-
-
 ### Файл Main
 
 Главный файл (обычно названный `main.scss`) должен быть единственным файлом Sass, который не начинается с нижнего подчеркивания. Этот файл не должен содержать ничего, кроме `@import` и комментариев.
@@ -414,11 +386,6 @@ sass/
   <p>Как было сказано, я не рекомендую это, потому что используется упорядочение по алфавиту, что иногда может быть не тем, что вы хотите, особенно, когда вы имеете дело с языком, в котором важно упорядочение.</p>
 </div>
 
-
-
-
-
-
 ## Файл позора
 
 Это интересная идея, которая стала популярна благодаря [Гарри Робертсу](http://csswizardry.com), [Дэйву Руперту](http://daverupert.com) и [Крису Койеру](http://css-tricks.com) и состоит в том, чтобы складывать все хаки и код, которым вы не гордитесь, в *файл позора*. Поэтому этот файл и имеет такое драматическое название – `_shame.scss`, импортируется в самом конце.
@@ -453,8 +420,6 @@ sass/
   </div>
 </div>
 
-
-
 ### Дальнейшее чтение
 
 * [shame.css](http://csswizardry.com/2013/04/shame-css/)

ru/_author.md

@@ -1,7 +1,7 @@
 
 # Об авторе
 
-Меня зовут [Hugo Giraudel](http://hugogiraudel.com), Я frontend-разработчик из Франции, собираюсь переехать в Германию, в Берлин. Я пишу на Sass больше двух лет и теперь являюсь автором таких Sass-проектов, как [SassDoc](http://sassdoc.com) и [Sass-Compatibility](http://sass-compatibility.github.io).
+Меня зовут [Hugo Giraudel](http://hugogiraudel.com), я frontend-разработчик из Франции, собираюсь переехать в Германию, в Берлин. Я пишу на Sass больше двух лет и теперь являюсь автором таких Sass-проектов, как [SassDoc](http://sassdoc.com) и [Sass-Compatibility](http://sass-compatibility.github.io).
 
 Я также написал несколько библиотек, в основном ради интереса: [SassyJSON](https://github.com/HugoGiraudel/SassyJSON), [SassyLists](http://sassylists.com), [SassySort](https://github.com/HugoGiraudel/SassySort), [SassyCast](https://github.com/HugoGiraudel/SassyCast), [SassyMatrix](https://github.com/HugoGiraudel/SassyMatrix), [SassyBitwise](https://github.com/HugoGiraudel/SassyBitwise), [SassyIteratorsGenerators](https://github.com/HugoGiraudel/SassyIteratorsGenerators), [SassyLogger](https://github.com/HugoGiraudel/SassyLogger), [SassyStrings](https://github.com/HugoGiraudel/SassyStrings) и [SassyGradients](https://github.com/HugoGiraudel/SassyGradients).
 

ru/_comments.md

@@ -14,11 +14,6 @@ CSS является сложным языком, полным хаков и к
 
 И я, наверное, забыл много других различных причин. Комментирование занимает очень мало времени, когда делается вместе с написанием кода, так что делайте это в нужное время. Возвращаясь на кусок кода, чтобы комментировать его, не только совершенно невозможно, но и крайне раздражительно.
 
-
-
-
-
-
 ## Написание комментариев
 
 В идеале, *любой* набор CSS правил должен предшествовать комментарию в стиле Си, объясняя цель блока CSS. Этот комментарий также принимает пронумерованные объяснения по поводу конкретных частей набора правил. Например:
@@ -28,9 +23,9 @@ CSS является сложным языком, полным хаков и к
 {% highlight scss %}
 /**
  * Вспомогательный класс для усечения и добавления многоточия в слишком длинную строку
- * на одной линии.
- * 1. Предотвращает сворачивание содержимого, оставляет его на одной линии.
- * 2. Добавляет многоточие на конце линии.
+ * на одной строке.
+ * 1. Предотвращает сворачивание содержимого, оставляет его на одной строке.
+ * 2. Добавляет многоточие на конце строки.
  */
 .ellipsis {
   white-space: nowrap; /* 1 */
@@ -43,9 +38,9 @@ CSS является сложным языком, полным хаков и к
 {% highlight sass %}
 /**
  * Вспомогательный класс для усечения и добавления многоточия в слишком длинную строку
- * на одной линии.
- * 1. Предотвращает сворачивание содержимого, оставляет его на одной линии.
- * 2. Добавляет многоточие на конце линии.
+ * на одной строке.
+ * 1. Предотвращает сворачивание содержимого, оставляет его на одной строке.
+ * 2. Добавляет многоточие на конце строки.
  */
 .ellipsis
   white-space: nowrap /* 1 */
@@ -76,17 +71,10 @@ $imported-modules: append($imported-modules, $module) !global
   </div>
 </div>
 
-
-
 ### Дальнейшее чтение
 
 * [CSS Guidelines’ Commenting section](http://cssguidelin.es/#commenting)
 
-
-
-
-
-
 ## Документирование
 
 Каждая переменная, функция, примесь и placeholder, который предназначен для повторного использования во всём коде, должен быть задокументирован как часть глобального API с использованием [SassDoc](http://sassdoc.com).
@@ -132,7 +120,7 @@ $vertical-rhythm-baseline: 1.5rem
 </div>
 
 <div class="note">
-  <p>Необходим тройная косая (<code>/</code>).</p>
+  <p>Необходимо три косых (<code>/</code>).</p>
 </div>
 
 SassDoc выполняет две основные роли:
@@ -224,8 +212,6 @@ SassDoc выполняет две основные роли:
   </div>
 </div>
 
-
-
 ### Дальнейшее чтение
 
 * [SassDoc](http://sassdoc.com)

ru/_contributing.md

@@ -1,9 +1,9 @@
 
 # Сотрудничество
 
-Руководство Sass – открытый проект, которым я руковожу в свободное время. Излишне говорить, что это довольно большой объем работы, чтобы держать всё задокументированным в последней версии. Знать, что вам понравилось это руководство – уже ценно!
+Руководство Sass – открытый проект, которым я руковожу в свободное время. Излишне говорить, что это довольно большой объем работы – держать всё задокументированным в последней версии. Знать, что вам понравилось это руководство – уже бесценно!
 
-Теперь, если вы чувтствуете, что готовы к сотрудничеству, пожалуйста, знайте, уже будет очень здорово просто твитнуть, рассказать или открыть Pull Request с исправлением ошибок в [репозитории на GitHub](https://github.com/HugoGiraudel/sass-guidelines)!
+Теперь, если вы чувстствуете, что готовы к сотрудничеству – пожалуйста, знайте, будет уже очень здорово просто твитнуть, рассказать или открыть Pull Request с исправлением ошибок в [репозитории на GitHub](https://github.com/HugoGiraudel/sass-guidelines)!
 
 Прежде, чем мы начнём: если вам понравился этот документ, или он оказался полезен вам или вашей команде, пожалуйста, подумайте о его поддержке!
 

ru/_errors.md

@@ -11,19 +11,12 @@
 
 Теперь есть много пространства в вашем проекте на Sass для предупреждений и ошибок. Обычно любая примесь или функция, за исключением специальных типов или аргументов, может выкинуть ошибку, если произойдёт что-то неожиданное, или вывести предупреждение, когда делает предположение.
 
-
-
 ### Дальнейшее чтение
 
 * [An Introduction To Error Handling](http://webdesign.tutsplus.com/tutorials/an-introduction-to-error-handling-in-sass--cms-19996)
 * [Building a Logger Mixin](http://webdesign.tutsplus.com/tutorials/building-a-logger-mixin-in-sass--cms-22070)
 * [SassyLogger](https://github.com/HugoGiraudel/SassyLogger)
 
-
-
-
-
-
 ## Предупреждения
 
 Возьмём функцию из [Sass-MQ](https://github.com/sass-mq/sass-mq), предполагающую конвертирование из `px` в `em`, например:
@@ -59,11 +52,6 @@
 
 Если значение отсутствет, то функция предполагает, что значение подразумевает собой измерение в пикселях. С этой точки зрения, предположение может быть рискованным для пользователя и поэтому он должен быть предупреждён, что программа сделает что-то, что может быть неожиданным поведением.
 
-
-
-
-
-
 ## Ошибки
 
 Ошибки, в отличие от предупреждений, предотвращают компилятор от дальнейшей работы. Обычно они останавливают сборку и выводят сообщение в поток вывода, также как и в stack trace, что весьма удобно для отладки. Из-за этого ошибки должны быть выведены только тогда, когда уже нет возможности для выполнения программы. Когда есть возможность, попробуйте обойти эту проблему и вывести вместо этого предупреждение.