Size: a a a

DocOps-сообщество

2020 June 11

KC

Kseniya Chudakova in DocOps-сообщество
Иван
передо мной вставала такая задача, генерить PDF из dosify-проекта, я за несколько вечеров написал программку поверх puppeteer. работает на ура, но в достаточно узких кейсах

правда, я программист, а не писатель)
🤟🏾
источник

IC

Ivan Cheban in DocOps-сообщество
Из того, что я смотрел, теплее всего было из Antora ковыряться в теме CSS
источник

IC

Ivan Cheban in DocOps-сообщество
Пандок меня не устроил, но если есть вариант подкинуть ему CSS, как Никита советует, то это было бы круто
источник

НН

Нац Нац in DocOps-сообщество
Чего не устроил? Это же ультимативная штука. Но цсс да, можно много чего ему кормить в догонку
источник

НН

Нац Нац in DocOps-сообщество
Я так настроил генерацию резюмешек, md + css = красивая пдф-ка
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Нац Нац
Интересно попробовать умеют ли golang'овые регекспы в русский и попробовать рул написать какой-то. Но я не пишу на русском, предлагаю проверить
@Lananovikova @SuckMyNuts Если говорить о рулах для русского языка, безотносительно технологии, на что бы порекомендовали ссылаться, как на первоисточник?

(кроме Розенталя и Ильяхова :)
источник

L

Lana in DocOps-сообщество
Vadim Smelyanskiy
@Lananovikova @SuckMyNuts Если говорить о рулах для русского языка, безотносительно технологии, на что бы порекомендовали ссылаться, как на первоисточник?

(кроме Розенталя и Ильяхова :)
Мильчин
источник

L

Lana in DocOps-сообщество
Справочник издателя и автора
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Есть вот такой док, тут много хороших рефов о нормах
источник

L

Lana in DocOps-сообщество
А вообще по каждому отдельному правилу могут быть свои источники истины, можно собрать из разных, Мильчин хорошо для оформления, например, даты, списки, наращения числительных
источник

НН

Нац Нац in DocOps-сообщество
Нашлось странное
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Vadim Smelyanskiy
Есть вот такой док, тут много хороших рефов о нормах
Да, действительно нашлось
источник

НН

Нац Нац in DocOps-сообщество
Но тут больше о вкусах, можно взять чей-то готовый и подкручивать под себя, лучший вариант имхо. Надо только вытрясти с этого кого-то стайлгайдец. Писать это всё одному думаю можно опухнуть
источник

НН

Нац Нац in DocOps-сообщество
лол)
источник

L

Lana in DocOps-сообщество
Есть ещё редполитики разных изданий http://rdpk.ru/ тоже берёте наиболее понравившуюся и адаптируете
источник

НН

Нац Нац in DocOps-сообщество
еще есть *шепотом* ГОСТы
источник

L

Lana in DocOps-сообщество
Хороший стайлгайд у Контура
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Нац Нац
Но тут больше о вкусах, можно взять чей-то готовый и подкручивать под себя, лучший вариант имхо. Надо только вытрясти с этого кого-то стайлгайдец. Писать это всё одному думаю можно опухнуть
Вооот, вот это ключевая проблема

Писать гайд употребимости терминов на русском, например, это ад какой-то
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Я не хочу свой словарь издавать, я хочу хорошую документацию :(
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Lana
Хороший стайлгайд у Контура
Присмотрюсь, спасибо за наводку
источник