Size: a a a

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

2020 August 24

VS

Vadim Smelyanskiy in DocOps-сообщество
Maksim Lapshin
Оу.

Полиграфия прожила 400 лет и буквально 10 лет не дожила до prepress-as-a-code
Дожила, в CorelDRAW скрипты были
источник

СФ

Семён Факторович... in DocOps-сообщество
Sergey Khitrin
Ребята, а есть у кого-то на примете инструменты, которые бы позволяли "тестировать" сгенерированные PDF (md -> latex -> pdf)?
В рамках отладки шаблонов мы меняем сотни документов и где-то может починиться , а где-то - сломаться.

Как вы с этим работаете? Как проводите регрессионное тестирование большого объёма документов?
подозреваю, что это не ваш случай (т.к. у вас наверняка многостраничные PDF-ки с колонтитулами и нумерованными страницами), но вдруг:

интересный вариант генерации PDF — через HTML, а не через latex. У chromium отличный движок рендеринга PDF, для его дерганья есть удобные интерфейсы Puppeteer, итоговый PDF получается pixel-perfect с HTML.

соответственно, на этапе md → html можно провести всю валидацию, и потом уже делать html → pdf

но, повторюсь, этот путь плохо работает с колонтитульными страницами
источник

DB

Dima Boger in DocOps-сообщество
да, генерить пдфки через puppeteer приятно, получаешь ожидаемый результат, можешь проверить как он выглядит в своём браузере)
источник

iv

iakov v in DocOps-сообщество
Семён Факторович
подозреваю, что это не ваш случай (т.к. у вас наверняка многостраничные PDF-ки с колонтитулами и нумерованными страницами), но вдруг:

интересный вариант генерации PDF — через HTML, а не через latex. У chromium отличный движок рендеринга PDF, для его дерганья есть удобные интерфейсы Puppeteer, итоговый PDF получается pixel-perfect с HTML.

соответственно, на этапе md → html можно провести всю валидацию, и потом уже делать html → pdf

но, повторюсь, этот путь плохо работает с колонтитульными страницами
это происходит из фундаментальной разницы: html не подразумевает разбивку на страницы (и соответственно постраничные элементы типа колонтитулов), а PDF, наоборот, состоит только из страниц. Можно, наверное, очень сильно сгладить эту разницу, но совсем преодолеть ее не получится
источник

СФ

Семён Факторович... in DocOps-сообщество
iakov v
это происходит из фундаментальной разницы: html не подразумевает разбивку на страницы (и соответственно постраничные элементы типа колонтитулов), а PDF, наоборот, состоит только из страниц. Можно, наверное, очень сильно сгладить эту разницу, но совсем преодолеть ее не получится
всё так, и у нас всё не доходят руки поиграться с воркараундами для колонтитулов в таком подходе
источник

СФ

Семён Факторович... in DocOps-сообщество
но вот генерить через puppeteer этикетки размера A5 и A6 было очень круто, редко когда рендеринг документации работал настолько бесшовно
источник

SK

Sergey Khitrin in DocOps-сообщество
Не, у нас задача пакетной генерации сотен многостраничных документов - с заглавными страницами, колонтитулами, оглавленем, ... Все что LaTex предлагает
источник

NV

Nick Volynkin in DocOps-сообщество
Семён Факторович
но вот генерить через puppeteer этикетки размера A5 и A6 было очень круто, редко когда рендеринг документации работал настолько бесшовно
Это на конференцию бейджи были?
источник

NV

Nick Volynkin in DocOps-сообщество
Sergey Khitrin
Да. Верстка, перекрытие текста.
Можно сделать тестовый документ со всеми типичными вариантами и сочетаниями элементов текста. Зафиксировать нужное состояние и сверять картинки.
источник

iv

iakov v in DocOps-сообщество
Nick Volynkin
Можно сделать тестовый документ со всеми типичными вариантами и сочетаниями элементов текста. Зафиксировать нужное состояние и сверять картинки.
с помощью компьютерного зрения? ;)
источник

NV

Nick Volynkin in DocOps-сообщество
iakov v
с помощью компьютерного зрения? ;)
Диффануть две картинки можно алгоритмами попроще
источник

СФ

Семён Факторович... in DocOps-сообщество
Nick Volynkin
Это на конференцию бейджи были?
не, этикетки на оборудование
источник

NV

Nick Volynkin in DocOps-сообщество
У меня в бэклоге тоже есть документационная задача на puppeteer. Вот сделаю — поделюсь опытом.
источник

NV

Nick Volynkin in DocOps-сообщество
Кстати, я рассказал про SEO документации у нас на фронтенд-гильдии, вроде вышло неплохо. Могу теперь повторить для всех.
источник

L

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

NV

Nick Volynkin in DocOps-сообщество
Но в идеале я бы ещё пособирал результаты )
источник

OK

Olya Kirillova in DocOps-сообщество
Nick Volynkin
Кстати, я рассказал про SEO документации у нас на фронтенд-гильдии, вроде вышло неплохо. Могу теперь повторить для всех.
Дааа!
источник

NV

Nick Volynkin in DocOps-сообщество
Простите, что не про документацию )
источник

DB

Dima Boger in DocOps-сообщество
Разве он работает с сквошенными ветками?
источник

NV

Nick Volynkin in DocOps-сообщество
Вот мне как раз автор ITGram ответил, что со сквошенными не работает
источник