Size: a a a

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

2020 January 10

NV

Nick Volynkin in DocOps-сообщество
Кажется, нам нужен специалист по accessibility.
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Nick Volynkin
А голосовые читалки не умеют пропускать элементы с display: none?
Они ищут aria-hidden="true"
источник

FM

Fox Mulder in DocOps-сообщество
Кто работает в VS. Рекомендую поставить тему Night Owl, имхо, прикольно и не напрягает глаза.
источник

FM

Fox Mulder in DocOps-сообщество
Ну вот, тоьлко я хотел написать обещанную статью на статью @SuckMyNuts  , как её не стало.
источник

NV

Nick Volynkin in DocOps-сообщество
Fox Mulder
Ну вот, тоьлко я хотел написать обещанную статью на статью @SuckMyNuts  , как её не стало.
Её почти сразу не стало, но можно и так написать )
источник

FM

Fox Mulder in DocOps-сообщество
Nick Volynkin
Её почти сразу не стало, но можно и так написать )
Да если бы я еще помнил, что там точно. А так, только смутные данные.
источник

L

Lex in DocOps-сообщество
Fox Mulder
Кто работает в VS. Рекомендую поставить тему Night Owl, имхо, прикольно и не напрягает глаза.
Пестренькая, но вроде ничего, спасибо
источник

НН

Нац Нац in DocOps-сообщество
Fox Mulder
Кто работает в VS. Рекомендую поставить тему Night Owl, имхо, прикольно и не напрягает глаза.
У меня онли Дракула везде
источник

DB

Dima Boger in DocOps-сообщество
Даркула
источник

KC

Kseniya Chudakova in DocOps-сообщество
Atom One Dark Theme
источник

NV

Nick Volynkin in DocOps-сообщество
я себе в FF поставил плагин https://github.com/darkreader/darkreader, теперь у меня на всех сайтах тёмная тема )
источник

FM

Fox Mulder in DocOps-сообщество
site list перевели как список, что имхо, неправильно
источник

НН

Нац Нац in DocOps-сообщество
Аналогично, в хромом
источник

IA

Ivan Abashkin in DocOps-сообщество
Всем привет!

Ребят, подскажите, кто-нибудь пробовал генерировать pdf через такую связку?:
ASCIIDOC -> HTML+CSS -> PDF

В чем задача:
Мы пробуем использовать asciidoctor-pdf. На выходе хотим получать красивый PDF.
Asciidoctor-pdf может генерировать как pdf, так и html.
Для генерирования PDF можно использовать только шаблоны в yml.
Для генерирования HTML можно использовать шаблоны в css.
У нас сложная вёрстка документа. Дизайнеры нарисовали такой шаблон, который не отрисовать с помощью yml.
Поэтому мы решили использовать css для более тонкой отрисовки стиля.

В чем проблема:
Если передать в asciidoctor-pdf css-шаблон и .adoc файл, то
при генерации html, стиль применяется, всё ок. На выходе получаем, что хотели.
при генерации pdf, стиль, описанный в css, не отрабатывает. Отрабатывает только разметка.
Видимо при генерации pdf напрямую, asciidoctor-pdf не умеет применять css-шаблоны.

Сейчас мы хотим попробовать такую связку ASCIIDOC (+CSS) -> html -> какой-то конвертер -> pdf
Отсюда ещё несколько вопросов:
1. Как бы (с помощью каких инструментов) с использованием css-шаблона сгенерировать дизайнерский PDF из ASCIIDOC ?
2. С какими сложностями (граблями) можно столкнуться, при сохранении html страницы в PDF (используя puppeteer, html2canvas, jsPDF или аналогичные штуки)
3. Возможно ли сложную вёрстку документа описать с помощью docbook или latex? Пример вёрстки на скриншоте ниже. Нам нужно выдерживать вертикальные и горизонтальные интервалы между картинками и текстом, задавать ширину заливки, писать текст в точно заданном месте, и т.п.
источник

IA

Ivan Abashkin in DocOps-сообщество
Скриншот к посту выше
источник

iv

iakov v in DocOps-сообщество
Пусть меня заклюют, но я буду тем человеком, который указал на опечатку "роутреа" на скриншоте
источник

IA

Ivan Abashkin in DocOps-сообщество
iakov v
Пусть меня заклюют, но я буду тем человеком, который указал на опечатку "роутреа" на скриншоте
Да, там много опечаток. Это скриншот из макета в figma. Дизайнер писал как мог.
источник

iv

iakov v in DocOps-сообщество
Если по существу, то docbook работают в связке с XSL-шаблонами, соответственно, теоретически можно запрограммировать сколь угодно сложную трансформацию (хотя напрямую XSL может превращать только в другие XML-based форматы, то есть в условный HTML), а у latex цель немного другая, поэтому сделать точное позиционирование там можно, но для этого надо проделать очень большую работу.
источник

iv

iakov v in DocOps-сообщество
Есть ещё инструмент https://github.com/asciidoctor/asciidoctor-fopub (правда, сам не пользовался, ничего сказать про качество не могу)
источник

NP

Nikolaj Potashnikov in DocOps-сообщество
Ivan Abashkin
Всем привет!

Ребят, подскажите, кто-нибудь пробовал генерировать pdf через такую связку?:
ASCIIDOC -> HTML+CSS -> PDF

В чем задача:
Мы пробуем использовать asciidoctor-pdf. На выходе хотим получать красивый PDF.
Asciidoctor-pdf может генерировать как pdf, так и html.
Для генерирования PDF можно использовать только шаблоны в yml.
Для генерирования HTML можно использовать шаблоны в css.
У нас сложная вёрстка документа. Дизайнеры нарисовали такой шаблон, который не отрисовать с помощью yml.
Поэтому мы решили использовать css для более тонкой отрисовки стиля.

В чем проблема:
Если передать в asciidoctor-pdf css-шаблон и .adoc файл, то
при генерации html, стиль применяется, всё ок. На выходе получаем, что хотели.
при генерации pdf, стиль, описанный в css, не отрабатывает. Отрабатывает только разметка.
Видимо при генерации pdf напрямую, asciidoctor-pdf не умеет применять css-шаблоны.

Сейчас мы хотим попробовать такую связку ASCIIDOC (+CSS) -> html -> какой-то конвертер -> pdf
Отсюда ещё несколько вопросов:
1. Как бы (с помощью каких инструментов) с использованием css-шаблона сгенерировать дизайнерский PDF из ASCIIDOC ?
2. С какими сложностями (граблями) можно столкнуться, при сохранении html страницы в PDF (используя puppeteer, html2canvas, jsPDF или аналогичные штуки)
3. Возможно ли сложную вёрстку документа описать с помощью docbook или latex? Пример вёрстки на скриншоте ниже. Нам нужно выдерживать вертикальные и горизонтальные интервалы между картинками и текстом, задавать ширину заливки, писать текст в точно заданном месте, и т.п.
fopub, мне кажется, это самый прямой путь. Т.е. цепочка через docbook - docbook-xsl
источник