search

enb / enb-bem-docs

BEM docs for ENB
Other
10 stars 5 forks source link

Think about possibility to inline custom JS and CSS for block examples #16

Closed tadatuta closed 9 years ago

tadatuta commented 10 years ago

@veged suggested:

давайте тогда сделаем специальные заголовки типа:

  • Пример

  • BEMJSON

  • JS

  • CSS

под заголовками можно будет писать нормально js для bemjson (вместоbemjson, а при рендеринге в сайт эти служебные заголовки будут удаляться и всё сложится в окно с табами

blond commented 10 years ago

Вставки в markdown были придуманы только для простых случаев, когда BEMJSON кода достаточно.

Для более сложных случаев, когда требуется к примеру добавлять JavaScript и CSS, разбивать код по платформам и т.д. следует создавать примеры в файловой системе.

tadatuta commented 10 years ago

да, но почему бы и нет? ;)

blond commented 10 years ago

да, но почему бы и нет? ;)

Во-первых, это костыли, о которых надо знать, чтобы не было больно. Обязательно найдётся кто-то, кто будет писать просто markdown-файл как он привык, и у него вдруг всё сломается.

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

В-третьих, таких случаев очень мало, и нет никакой сложности пойти и создать пример в файловой системе. А вот ломать удобство и красоту, которая сейчас есть в md, совсем не хочется.

veged commented 10 years ago

это не костыль, а расширение разметки — причём вполне обратносовместимое и нормально рендерящееся даже на гитхабе

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

сейчас получается красота ради красоты — писать то что можно было сделать инлайново в отдельных файлах как ни крути неудобнее (собственно раньше вообще все примеры писались отдельно и мы видим как сейчас лучше стало)

blond commented 9 years ago

Начиная с версии 0.6.4 для инлайновых примеров можно указывать не только язык bemjson, но и js (#25).