CeCC Docbook Manager

Examples of use by different partner organisations for different outcomes

Presentation overview

• The CeCC single source publishing system (Docbook Manager) is a highly flexible web-based application which revolutionises the traditional publishing process. 

• Docbook Manager can be customised to meet the needs of any organisation that wishes to publish and maintain major reports, strategic plans, books and policies.

Single Source Publishing

• Same content can be published to multiple formats (HTML, PDF, XML, ePub)

• Structured content separates content from style – ensuring consistent presentation

• Ideally suited to technical documents • CeCC Docbook Manager allows for the maintenance of a

Single Source Publishing document without requiring the technical knowledge.

• Docbook Manager is used by different partner organisations for different outcomes

Docbook Manager Benefits

• Collaboratively manage the content of a publication.• Publish to multiple sources:

• Web, PDF, ePub, inDesign (for hardcopy)

• Reduces challenges associated with creating and maintaining publications of a collaborative nature.

• Enforces a publication/review cycle• Published content is both professionally presented and

accessible with semantically rich html• Structured published content inherently provides search

engine optimisation

Victoria Law Handbookwww.lawhandbook.org.au/handbook

• Large publication: 24 chapters, 3460 sections, 682 web pages

• Published once yearly, alongside hard copy version

• Single editor• Repurposed handbook content forms

services directory www.lawhandbook.org.au/services.php

• 1 page fact sheetswww.lawhandbook.org.au/fact_sheets/

South Australia Law Handbookwww.lawhandbook.sa.gov.au

• Large publication:

• 37 chapters

• 710 sections

• 1,791 web pages

• Published regularly - no hard

copy version

• Multiple collaborative editors

Cancer Australia Evidence-based clinical practice guidelineshttp://canceraustralia.nbocc.org.au/health-professionals/clinical-best-practice/cpg-by-topic

• Small guidelines• Approx 13 pages each

• Extensive internal review• Draft versioning• External review process

before guideline is published• Both HTML and PDF version

published• Endnote referencing integration

University of BallaratGeneral Guide for the presentation of academic workhttp://guerin.ballarat.edu.au/aasp/student/learning_support/generalguide/

• Provides general advice on reaching acceptable standardsof academic work

• Large technical document• Annually updated• Published online and in PDF

format

University of BallaratPolicies and Procedureshttp://policy.ballarat.edu.au

• Large collection of small documents • 240 topics• 280 documents• 4,959 sections

• Distributed userbase: contributors, editors and workflow managers

• Document ownership, version control and approval process

• Multiple ways to browse and search for policies

• Transparent and automated document status (schedule, review, draft for comment, recently approved)

• Publishes HTML and PDF versions

Research reports

Docbook Manager: Chapters and Sections

• Documents within Docbook Manager consist of chapters and sections

• Sections are the core element of any publication• All content is either part of, or links to a section• Sections are structured hierarchically• To view demonstration of Docbook chapters and section

management visit: http://www.cecc.com.au/videos/dbv1_manage_sections/dbv1_manage_sections.html

Docbook Manager: Inline Editing

• Inline “What You See Is What You Get ” editing

• Xstandard standards compliance WYSIWYG

• Intuitive and dynamic interface

• To view demonstration ofinline editing visit:www.cecc.com.au/videos/dbv4_inline_edting/dbv4_inline_edting.html

Docbook Manager: Workflow Process

• Documents evolve through collaborative editing.

• After document review, the document is published

• During the publishing lifecycle, documents versions can be created at document milestones

Docbook Manager: Workflow

• Flexible permission system• Document edit review (View changes inline)• Editing reports (eg: Editor activity)• Document versioning (eg: Drafts, External Review, Final,

For Approval) – providing a complete document history• Publish control – Public document cannot be published

while any versions remain active• External review of document version (Collation of public

feedback for a document version)

Docbook Manager: Automation

• Index terms• Automatically replaced with link from index term database

• Glossary terms• Automatically replaced with definition from glossary term

database• Acronyms

• Automatically replaced with acronym tag from glossary term database

• Links• Updating a link in the links database can update any

occurrences of the link within the Docbook content• To view a demonstration video visit:

http://www.cecc.com.au/videos/dbv6_glossary_index/dbv6_glossary_index.html

Other Useful Features

• Docbook extracts all links from content to create a links database which allows links to be listed and searchable - as well as broken links being fixed once instead of every occurrence.eg: http://www.lawhandbook.org.au/links.php

• Any addresses marked up with an <address> tag can be automatically extracted from the content and turned into a searchable database of addresses with google map geolocation.eg: http://www.lsc.sa.gov.au/services.php

• Collations allow the selection of individual chapters or sections for export, review or creation of new documents

For more information

• Single source publishing• www.cecc.com.au/cb_pages/publishing.php

• Demonstration videos• www.cecc.com.au/docbook_manager_videos.php

• Centre for eCommerce and Communications• www.cecc.com.au

• Helen Thompson• Emailh.thompson@ballarat.edu.au• Phone 03 5327 9418