Документирование и сопровождение верстки. Чем удобнее?
Рано или поздно в любой команде разработчиков приходит понимание того, что нужно что-то улучшить. Вот и у нас это произошло :) Описание проблемы: существует определенное число технологов работающих с фронтендом на долгосрочном проекте. Число технологов увеличивается и возникает проблема коммуникации. Одной из проблем является документирование html и css для лучшей навигации и возможности повторного использования.
Использовать инструментарий бэм и сборку пока не представляется возможным по ряду причин ) Но стиль описания css и html близок к oocss, потому нужен механизм документирования блоков с возможностью текстового описания, размещения превью блока и всего кода, который к нему относится. Код проекта (-ов) на bitbucket.org. Пробовали его wiki — не прижилось.
О сайте, ну или некоторой страничке где были б собраны блоки и их код я думал. Хотелось бы что-то более быстрое, т.к. не хочется тратить много времени на документирование (в случае с сайтом (страничкой) нужно нарезать картинки, написать разметку, залить картинки, перелинковать странички… ) Примерно тоже самое дает и wiki битбакета, только там еще нужно подсматривать в wiki-разметку.
Думаю, может быть есть что-то чем все пользуются, а я дикий и не образованный об этом не знаю…
Ну или более правильный способ — сделать макросы в шаблонизаторе на все случаи жизни, если ваш шаблонизатор это поддерживает.
Макросы это не совсем то что нужно. Тут вопрос немного в другом. Например, приходит очередной макет в нем часть блоков старая, часть новая. И хочется иметь перед глазами набор готовых блоков, что б не по страницам их выискивать. Т.е систематизировать.
Ну, если у вас есть какой-то абсолютно одинаковый блок, который встречается в нескольких разных страницах (вроде блока последних постов на Хабре), я бы его вынес в отдельный шаблон и инклудил. Не знаю, позволяет ли это используемая вами технология, если нет, то это очень плохо, придется и дальше страдать копипастом со всеми вытекающими.
Также, я бы посоветовал как-то системно организовать шаблоны, по папкам и файлам. чтобы не надо было «по страницам их выискивать», а сразу было ясно, где находится тот или иной код.
Что касается сниппетов — это проще, чем вы думаете, достаточно одной страницы и таблицы с 2 колонками: слева — код, справа — как это выглядит (то есть, тот же код, только вставленный как HTML). Но это вариант именно для штук вроде кнопок, окошек, иконок, уголков — таких элементов, которые всюду встречаются.
Ну, если у вас есть какой-то абсолютно одинаковый блок, который встречается в нескольких разных страницах (вроде блока последних постов на Хабре), я бы его вынес в отдельный шаблон и инклудил. Не знаю, позволяет ли это используемая вами технология, если нет, то это очень плохо, придется и дальше страдать копипастом со всеми вытекающими.
Также, я бы посоветовал как-то системно организовать шаблоны, по папкам и файлам. чтобы не надо было «по страницам их выискивать», а сразу было ясно, где находится тот или иной код.
С этим да, тут понятно. Это выносится в отдельный шаблон, подключается где нужно и конечно код не тянется и не копипастится. Вопрос именно в этапе до интеграции.
Про таблицу с двумя колонками нужно подумать. Просто я думал есть что-то более «промышленное».
Простой
