Using DocBook5

To Produce PDF and ePub3 Books

Murray Maloney

Copyright © 2017 Murray Maloney

expand Abstract

Table of Contents

Introduction

expand Murray Maloney

Balisage logo

Preliminary Proceedings

expand How to cite this paper

Using DocBook5

To Produce PDF and ePub3 Books

Balisage: The Markup Conference 2017
August 1 - 4, 2017

Introduction

The Discipline of Organizing is an academic work edited by UC Information School Adjunct Professor, Robert J Glushko, with contributions from a diverse collection of educators and students around the world. Between 2010 and 2012, he assemble and organized material from his course notes and slide decks, along with contributions from other professors and some graduate students. His goal was to produce an academic book in print and epub2 formats for publication by MIT Press. The first edition was published by MIT Press in 2013, in hard-cover print and ePub2 forms. The second through fourth editions were published for O'Reilly Media. PDF format editions of the third and fourth editions were made available for use for accessibility.

Murray Maloney joined the project in Spring of 2012, tasked with content editing. Later in 2012, he assumed responsibility for producing the first edition print and epub editions, using O'Reilly's Atlas system, which was subsequently used to produce an ePub3-only edition in 2014. In 2014 and 2015, Murray produced print and epub3 editions using customized XSLT scripts created by Bob Stayton and further developed by Jirka Kosek.

The associated PDF file [Bal2017MaloneyPRODNOTES.pdf] is an elided version of Murray's Production notes. In its complete form, it was a hidden chapter in the book. He relied upon this chapter to test formatting, copy-fitting, floats, hypertext capabilities, The examples that illustrate DocBook5 input and XHTML5 output were intended primarily for the benefit of the production editor and the XSLT wizards. Many figures and examples have been removed because they would not have worked without the custom production pipeline, CSS, and JavaScript..