- Telegram: Канал | Чат
- Youtube: Ставьте колокольчик!
- Twitter: Фоловить тут
Это первый выпуск с гостями!
В этом выпуске мы послушаем долгу и интересную историю отношений компании КУРС, а в частности Вани и Коли с документацией. Узнаем почему для документации хорош AscciDoc и чем он лучше Markdown.
С чем он интегрируется и как генерируется, а так же как его можно использовать для подготовки документации, оформленной по ГОСТ.
Guillaume Grossetie, который сейчас пилит AsciiDoctor и много чего сделал для нас, узнав, что мы будем в подкасте, просил следующее:
I think what we need to make asciidoctor-web-pdf even better is more use cases. So if you can convince a few people to give it a try and provide feedback that would be great!
Guillaume Grossetie
- https://github.com/CourseOrchestra/course-doc — шаблоны для вывода PDF по старинке, через XSL-FO, в виде, приемлемом для наших (а значит, скорей всего, и ваших) заказчиков
- https://github.com/Mogztter/asciidoctor-web-pdf — та самая штука, которая работает выводит в PDF через puppeteer через CSS-ки для печати
- Сам полифил Paged.js для спецификаций W3C Paged Media и Generated Content for Paged Media — https://www.pagedjs.org/
- Проект для генерации pdf из asciidoctor на основе полифила — https://github.com/Mogztter/asciidoctor-web-pdf
- Стили docbook-xsl (для старой цепочки генерации pdf через docbook) — https://github.com/CourseOrchestra/course-doc
- https://habr.com/ru/post/416077/ Колина статья про PlantUML
- https://habr.com/ru/post/456032/ Ванина статья про то, как он готовит слайды из AsciiDoctor
- Чатик про AsciiDoctor