15:00
-
15:25
-
15:25
Day 1
Why our HTML Docs don't just `Print` and what to do about it
<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>