Event

Event
15:00
-
15:25
Day 1
Why our HTML Docs don't just `Print` and what to do about it
Assembly-Event
<p>You've perfected your Docs-as-Code pipeline. Your HTML documentation is beautiful, version-controlled, and deploys instantly. Then someone asks for a printing version. Printing? What is it? Ah, a primitive pre-HTML way of publishing, no problem... until you try it.</p> <p>This talk addresses the fundamental mismatch between the web's fluid layout and the paged, fixed-layout world of print. After creating Asciidoctor to Open Document converter (https://github.com/CourseOrchestra/asciidoctor-open-document) I was so stuck in this mismatch that I nearly concluded print output from simple markup was just a toy, and that achieving quality was impossible.</p> <p>Luckily, I found inspiration in Pandoc's architecture, which acts as a "metaconverter" -- a factory for building converters. Based on its ideas I completely rewritten Asciidoctor to Open Document converter into Unidoc Publisher (https://github.com/fiddlededee/unidoc-publisher). This worked excellently and now I can share my experience in this field.</p> <p>I will then map the landscape of rendering solutions. We will compare the core options, which are limited to:</p> <ul> <li>native convertors relying on PDF libraries,</li> <li>Paged Media CSS,</li> <li>TeX (and all around), </li> <li>Text Processors Formats (OpenXML in MS Office, Open Document in LibreOffice). </li> </ul> <p>There's no silver bullet, there is just a sensible path. Hope this talk will help to choose the right solution for your needs.</p>