Skip to content

Latest commit

 

History

History
91 lines (50 loc) · 3.32 KB

6.CSSandStylus.md

File metadata and controls

91 lines (50 loc) · 3.32 KB

6. CSS + Stylus

Обязательно использование двоеточий после названия свойства

====

Обязательно использование точки с запятой после значения свойства

====

Обязательно использование фигурных скобок для выделения блока

====

Каждое свойство должно размещаться на отдельной строке

====

Индентация обязательна

====

Запрещено вешать стили на что-либо кроме классов

====

Запрещено вешать стили на классы с префиксом js-

====

Не рекомендуется использование float там, где можно обойтись display: inline-block; либо display: table-cell;


Структура файлов

Все цвета, размеры и т. п. должны быть вынесены в отдельный файл _vars.styl.

====

Стили, относящиеся к модулям и их крупным частям должны быть разнесены по файлам с человекопонятными названиями

ПРИМЕР:

news_newslist.styl
news_article.styl

====

Все подключаемые файлы должны лежать в папке css/blocks

====

Основной .styl-файл, который будет компилироваться должен иметь имя style.styl, содержать исключительно подключения других .styl-файлов с комментариями и располагаться в папке css/. В этой же папке разрешается держать служебные css-файлы (ie-8.css, admin.css, прочее)

====

Запрещено одновременно хранить стили и подключать другие файлы в рамках одного styl-файла. Либо файл является "сборщиком", либо - хранилищем стилей

====

Запрещено подключать файлы с расширением .css

====

Запрещено вешать стили на один и тот-же класс в двух разных местах

====

Не рекомендуется использовать @extend от не-служебных классов

====

В начале и конце файла обязательно указание специальных маркерных комментариев, говорящих о том, к какому компоненту относится файл, к какой теме оформления принадлежит и где находится

ПРИМЕР:

/* BEGIN c:ComponentName t:ThemeName /some/path/to/file.styl */

/* snip */

/* END c:ComponentName t:ThemeName /some/path/to/file.styl */

Компиляция stylus

Компиляцию stylus-а необходимо проводить с указанием ключей -c и --include-css