О проекте

Как работает CSScomb?

Алгоритм CSScomb максимально повторяет действия веб-технолога, работающего с CSS-кодом. Для пересортировки обычно перемещают строки относительно друг друга, учитывая комметарии в коде, многострочные записи значений свойств, хаки и всё, что может встретиться в реальном файле. CSScomb воспроизводит такие действия за вас. Это означает, что парсер по своей природе «думает» как человек редактирующий текст, а не как слепой робот, разбирающий CSS по косточкам.

Что умеет CSScomb?

• Сортирует CSS-свойства в рамках селекторов в соответствии с настройками.
• Бережно относится к исходному форматированию таблицы стилей.
• Сортирует закомментированные свойства так, как если бы они не были закомментированы.
• Переносит вниз незнакомые свойства в том порядке, в котором они встречаются в рамках селектора. Например: he\ight: 100% и подобные будут рассмотрены как незнакомые.
• Успешно парсит @media ... {...} и любые другие конструкции с @.
• Успешно парсит expressions и далее переносит их в конец свойств в порядке, в котором они встретились в рамках свойств одного селектора.

Как настраивать порядок сортировки?

В веб интерфейсе настройки можно задать простым списком: каждое свойство с новой строки, в нужном порядке. При желании можно разделить свойства на группы пустой строкой, тогда результат форматирования будет выглядеть так же.

Для настроек плагинов используется одномернный или двумерный JSON-массив. В случае двумерного массива свойства будут разделены на группы пустой строкой. В плагинах нужно расковырять файлик csscomb.php

• В TextMate: /Applications/TextMate.app/Contents/SharedSupport/Bundles/CSS.tmbundle/Support/lib/csscomb.php
• В Coda: /Users/%YOUR_USER_NAME%/Library/Application Support/Coda/Plug-ins/CSScomb.codaplugin/Contents/Resources/csscomb.php

Как помочь проекту?

Сделать плагин (если такового нет) к вашему любимому редактору.

Планы

Совершенствование алгоритма и доработки по тест-кейсам, которые падают.

Внедрение CSScomb в популярные редакторы кода.

Благодарности

Александру Титула-Бойченко, Вадиму Макееву, Игорю Майданову, Олегу Васютинскому, Елизавете Пимошиной и всем, кто помогал тестировать.