Обязательно использование двоеточий после названия свойства
====
Обязательно использование точки с запятой после значения свойства
====
Обязательно использование фигурных скобок для выделения блока
====
Каждое свойство должно размещаться на отдельной строке
====
Индентация обязательна
====
Запрещено вешать стили на что-либо кроме классов
====
Запрещено вешать стили на классы с префиксом 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-а необходимо проводить с указанием ключей -c
и --include-css