80 likes | 210 Vues
This guide explores the powerful capabilities of Docbook v5 Assembly, proven in production environments and supporting both topic-based and traditional authoring. It emphasizes the importance of business rules through Schematron and introduces the robust Docbook Toolkit, which facilitates easy migration paths. Readers will learn about its application in high-profile projects like Jamie Oliver's books and the production of various formats such as PDF, HTML, and EPUB. Additionally, it covers techniques for restructuring content and integrating with existing workflows.
E N D
Docbook v5 + Assembly • proven in production • both topic based and traditional authoring • extra business rules with Schematron • robust Docbook Toolkit • easiest migration path for DK
proven in production • DK interactive iBooks • DK EWTG iPad apps (discuss) • Penguin Books: Jamie Oliver etc • all content sourced from Docbook XML
traditional authoring • Easiest to do right • May be necessary in the transitional period • topic-based will not always offer a ROI for some titles or types of content
Docbook Assembly • Docbook’s method for topic-based authoring • can be chunked at any level (whole chapter or a paragraph) • can be transformed from or to a traditional book structure
RelaxNG+Schematron • RelaxNG - concise, easy to extend, restructure schemas, an ISO standard • Schematron - complements the above with rules like: <s:assert test="descendant::*[@role='assignment']"> (checks if a given Learning Object has any assignments in it)
Docbook Toolkit • Out of the box production of PDF, HTML, EPUB, slides etc (good for proofing) • Excellent tools support (OxygenXML) • Fully customizable - can layer own XSL on top • (optional) Disassemble existing DK-Schema books using standard XSL
How to use • Map Content Object such as POI to Docbook topic • Reassemble using XSL if all you need is a book (and reuse existing tools/workflow) • Use @metaref to link with a Triple store • Example: http://kode1100.com/content-objects/docbook/rg_spain-map.xml