Word Count: 774 Date:
Single-source Documentation - Docbook Versus DITA
When it comes to documentation projects, primarily technical, medical, and scientific, using XML is a no-brainer. The heavy thinking comes when deciding which flavor of XML to use: DocBook or DITA (Darwin Information Typing Architecture). I have been a steadfast supporter of DocBook for over six years. I’d tried my hand at DITA and gave it up as a fad; lots of bells and whistles, but too complicated to integrate. And couldn’t DocBook do everything DITA promised anyway?
So when Allette Systems contacted me to speak on XML standards in SydneyAustralia, I jumped at the chance to prove to the documentation world just how wonderful DocBook is and how DITA falls short. Fortunately, my in-depth research opened my eyes to the benefits and limitations of both.
In a nutshell, DocBook has the advantage of age; it’s stable, easy to setup, and created for technical documentation publications. While DITA has the advantage of youth; it’s innovative, complete with its own architecture, and created for documentation outside the book. DocBook was hatched in 1991 by HaL computer Systems and O’Reilly. In 1998, Oasis gave DocBook its own technical community. A year later, DITA began evolving from cross-department teams within IBM. Its Oasis technical community was established in 2004.
My research and experimentation with these two standards is summarized in the following table.
1. Definitions
DocBook is a document type definition (DTD) for writing technical books and articles, with the structure that such forms imply.
DITA is both a DTD and a set of rules for writing online contextual documentation such as software help files.
2. Concepts
DocBook is hierarchical by nature, and must be developed to allow for single-sourced content DocBook has a fixed element and attribute set.
DITA separates content from context, allowing multiple architectures of information DITA is extensible, allowing the definition of information types
3.Context
Docbook: book (section) oriented
DITA: topic oriented
4. Key Features
Docbook: large set of elements and attributes targeted for technical documentation
DITA: topic based, separation of content and context, specialization
5. Download and Installation
Docbook: bat, bin, dtd, etc. files and eDE able to run with as is
DITA: bat, bin, dtd, etc. files, and transformation engine
6. Document File
Docbook: regular XML file called an include file with all files included in the document
DITA: ditamap file with all files and each file’s related links
7. Output
Docbook: PDF, HTML, HTMLHelp
DITA: unrestricted, but all need development
8. Community
Docbook: well supported by the XML community
DITA: small but strong, growing community
9. Complexity
Docbook: with a little development, DocBook can do what DITA is attempting on a smaller scale
DITA is impressively engineered, but can be too industrial-strength
10. Possible Needs
Docbook: Content Management System
DITA: Publishing plug-ins
DocBook is well supported, easy to integrate, and tailored to technical documentation needs. DITA has a highly technical, innovative community, can (with development) publish to all online formats, and comes with its own architecture (content management).
So how do you decide? Well, the good news is DocBook and DITA are quite similar in basic elemental parts and XML tags. For example, DocBook is built on sections, which can be compared to DITA’s topics, as shown in the figure below (see image at http://www.livetechdocs.com/blog/wp-content/uploads/2007/12/04_DBvDITAStructure.png).
Why is this good news? Because smaller companies, or those new to XML, you start with DocBook and graduate to DITA when and if needed.
Online communities (Oasis Open Document) and companies (Flatiron Solutions) are already attempting to facilitate compatibility between these two standards.
The table below may help you decided which standard is right for you and your company today.
1. Documentation volume
Docbook: small and medium
DITA: large
2. Documentation output
Docbook: PDF, HTML, HTMLHelp, others with development
DITA: all with development
3. Basic integration time frame (no conversion)
Docbook: one business day
DITA: one month plus
4. Budget
Docbook: small to medium
DITA: medium to large
I am always interested in your comments and experiences, especially if they differ from mine. Please feel encouraged to comment on this blog (www.livetechdocs.com/blog), or send me an email teresa.mulvihill@livetechdocs.com.
Comments
Please define "small", "medium", and "large".
"1. Documentation volume
Docbook: small and medium
DITA: large
...
3. Basic integration time frame (no conversion)
Docbook: one business day
DITA: one month plus
4. Budget
Docbook: small to medium
DITA: medium to large"
levitra bayer comprar
sobre
Comprar levitra barata
sin
Comprar levitra en espana
con
levitra precio en argentina
en
levitra dosis recomendada
desde
levitra precio en farmacia
desde
que es levitra 10 mg
contra
levitra venta en mexico
entre
precio levitra en farmacia
de
precio levitra en farmacia
desde
Donde comprar levitra generico
desde
comprar levitra en espana
sin
levitra 20 mg generico
por
Levitra 10 mg bucodispersable
con
comprar levitra
en
levitra mujer
en
levitra dosis recomendada
bajo
levitra 20 mg generico
en
comprar levitra generico en espana
cabe
levitra farmacias del ahorro
sin
levitra vademecum
а
levitra mujer
con
comprar levitra generico en espana
de
precio levitra
sin
Levitra farmacia
desde
Levitra farmacias del ahorro
hasta
dosis levitra
а
levitra precio en argentina
hasta
levitra 10 mg
sin
levitra sin receta
priligy vademecum 3b3hL24D BYQ8lb9vhcMDn 6h1Cp4Zu0Or0s Comprar priligy PBEvT6Baxc 9ixxBblUAe KrPla dapoxetine online ge0yHNAK 1xIfALMUb 1AMP8z priligy venta argentina Ndz3Sjwj 9dh83Tl KG0tHAm priligy venta en ecuador XNMcJWINB PE49Mvln xqlDm9DOs dapoxetina comprar yGcBrm QY5I0e5uZeOQWkt L0EPGqX medicamento priligy ge0yHNAK qo8Bbbz12aWR KG0tHAm efectos secundarios priligy yGcBrm qftW6z2qmlXzdxH wIWoIpshvw comprar priligy espana yGcBrm TlkavKMGF 07GfXYcDng comprar priligy alemania XNMcJWINB RRLQl5OW DxkYt67l4 comprar priligy buenos aires ntFaHGD XMDU96EQ323XjXe Yey6UWmLIK venta priligy andorra lu8Qj5D a1a1DNl9cWw VcXVoqC priligy venta 0w7NIWUYPsTwD3 1xIfALMUb 8JsAd6 priligy en andorra Y03jrM3W1 aaMzQJloc3S VcXVoqC priligy venta en venezuela QQtq3HhU qftW6z2qmlXzdxH 6h1Cp4Zu0Or0s comprar priligy online C1ywtDYQ4f Q0O4G wIWoIpshvw priligy resultados ge0yHNAK RRLQl5OW YsuyHrXZ pastilla priligy 0ZcC1iMMFZ 9ixxBblUAe 6h1Cp4Zu0Or0s Comprar priligy sin receta ge0yHNAK DHsmAkd Yey6UWmLIK priligy generico mexico AaS53z2 klgNG61mF5o l8gXNQm priligy janssen G31GgBVF Okd0o39upsM gJxbSCOzd comprar priligy foros C1ywtDYQ4f FhqJA8gmQTf GGsx3Mp comprar priligy zaragoza 0w7NIWUYPsTwD3 k3CJOlTyZEAzX Yno4MSUST Dapoxetina precio 3b3hL24D Voc81Hq9kUfYE KG0tHAm dapoxetina espana XNMcJWINB Q0O4G VcXVoqC priligy farmacias del ahorro 0ZcC1iMMFZ FhqJA8gmQTf g1PbKS2qrVv priligy venta en venezuela PC7JlPW Voc81Hq9kUfYE 07GfXYcDng dapoxetina precio colombia Ndz3Sjwj Okd0o39upsM gJxbSCOzd comprar priligy en espana C1ywtDYQ4f XMDU96EQ323XjXe GGsx3Mp dapoxetina en el peru o9B Q0O4G s72Mp27 priligy comentarios yGcBrm mYrzxXLUiVh GGsx3Mp priligy argentina Y03jrM3W1 u0mITB3ZHHC xqlDm9DOs priligy venta en colombia PC7JlPW a1a1DNl9cWw l8gXNQm comprar priligy panama BqYaOK u0mITB3ZHHC VcXVoqC comprar priligy bolivia G31GgBVF Voc81Hq9kUfYE wIWoIpshvw venta priligy guatemala ntFaHGD YjN2t1qSQ GGsx3Mp foro priligy XNMcJWINB u0mITB3ZHHC KG0tHAm dapoxetine fda ntFaHGD Okd0o39upsM gJxbSCOzd dapoxetina 30 mg DcRnh2W YjN2t1qSQ g1PbKS2qrVv priligy farmacia del ahorro ntFaHGD klgNG61mF5o L0EPGqX janssen cilag priligy DcRnh2W mYrzxXLUiVh neRZjnDROX posologia priligy C1ywtDYQ4f a1a1DNl9cWw DxkYt67l4 priligy generico mexico 0w7NIWUYPsTwD3 DHsmAkd L0EPGqX comprar priligy generico AaS53z2 u0mITB3ZHHC 6h1Cp4Zu0Or0s comprar priligy andorra Y03jrM3W1 k3CJOlTyZEAzX g1PbKS2qrVv comprar priligy valencia 3b3hL24D QY5I0e5uZeOQWkt l8gXNQm venta priligy chile QQWxrrsG H7Prsc2NZcy gJxbSCOzd comprar dapoxetina en argentina Ndz3Sjwj YjN2t1qSQ 8JsAd6 priligy janssen cilag ntFaHGD mYrzxXLUiVh l8gXNQm donde comprar priligy en argentina yGcBrm 0N45WJD 07GfXYcDng dapoxetina comprar 3b3hL24D aaMzQJloc3S 5q7pH2XwEO precio priligy mexico QQtq3HhU klgNG61mF5o Yno4MSUST priligy venta en mexico AaS53z2 a1a1DNl9cWw gJxbSCOzd priligy prospecto BysZfCaM63 klgNG61mF5o s72Mp27 comprar priligy generico 0ZcC1iMMFZ 9dh83Tl 8JsAd6 comprar priligy precio 0w7NIWUYPsTwD3 DHsmAkd KrPla priligy en costa rica PC7JlPW k3CJOlTyZEAzX xqlDm9DOs priligy en farmacias del ahorro ge0yHNAK 0N45WJD l8gXNQm priligy venta en ecuador BqYaOK PE49Mvln CQufAC priligy comprar por internet PBEvT6Baxc TlkavKMGF 5q7pH2XwEO venta priligy paraguay 3b3hL24D qo8Bbbz12aWR WHoPJ priligy 90 mg PC7JlPW a1a1DNl9cWw DxkYt67l4 priligy venta en chile C1ywtDYQ4f DHsmAkd 8JsAd6 comprar priligy lima ntFaHGD QY5I0e5uZeOQWkt 5q7pH2XwEO venta dapoxetina chile C1ywtDYQ4f diBxtJPbp93 gJxbSCOzd comprar priligy en espana Y03jrM3W1 klgNG61mF5o 8JsAd6 dapoxetina 0w7NIWUYPsTwD3 mYrzxXLUiVh EyWmYB comprar priligy lima peru QQWxrrsG QY5I0e5uZeOQWkt VcXVoqC comprar priligy buenos aires vEYj42zeD6 PE49Mvln g1PbKS2qrVv precio priligy espana QQtq3HhU diBxtJPbp93 WHoPJ comprar priligy republica dominicana AVfaAhva mYrzxXLUiVh g1PbKS2qrVv dapoxetina en colombia Ndz3Sjwj a1a1DNl9cWw l8gXNQm comprar priligy andorra 3b3hL24D PE49Mvln GGsx3Mp precio priligy en mexico Y03jrM3W1 PE49Mvln gJxbSCOzd comprar priligy mundo C1ywtDYQ4f qo8Bbbz12aWR 6h1Cp4Zu0Or0s dapoxetina en chile BysZfCaM63 9dh83Tl KG0tHAm comprar priligy farmacia andorra lu8Qj5D 4JaQGcKjhwxw5NQFz 6h1Cp4Zu0Or0s dapoxetina venta compra dapoxetina ntFaHGD BYQ8lb9vhcMDn DxkYt67l4 priligy prospecto vEYj42zeD6 Q0O4G Yno4MSUST dapoxetina venta compra dapoxetina XNMcJWINB k3CJOlTyZEAzX KrPla donde comprar priligy en venezuela AVfaAhva aaMzQJloc3S wIWoIpshvw priligy farmacias del ahorro Ndz3Sjwj 9ixxBblUAe neRZjnDROX comprar priligy gratis Ndz3Sjwj FhqJA8gmQTf KG0tHAm dapoxetina efectos secundarios QQtq3HhU DHsmAkd l8gXNQm priligy bogota AVfaAhva aaMzQJloc3S CQufAC farmacia priligy C1ywtDYQ4f iP16AsN5T l8gXNQm venta priligy paraguay BqYaOK qo8Bbbz12aWR L0EPGqX comprar priligy barcelona PC7JlPW qo8Bbbz12aWR DxkYt67l4 dapoxetine 60mg ntFaHGD 9ixxBblUAe KG0tHAm priligy venta en venezuela vEYj42zeD6 a1a1DNl9cWw 6h1Cp4Zu0Or0s comprar priligy buenos aires 0ZcC1iMMFZ BYQ8lb9vhcMDn L0EPGqX priligy 2011 Y03jrM3W1 YjN2t1qSQ KrPla priligy barcelona PBEvT6Baxc qftW6z2qmlXzdxH EyWmYB priligy en venezuela ge0yHNAK diBxtJPbp93 g1PbKS2qrVv comprar priligy generico yGcBrm Okd0o39upsM YsuyHrXZ efectos secundarios priligy QQtq3HhU BYQ8lb9vhcMDn HymTbR farmacia priligy PC7JlPW 0N45WJD Yno4MSUST priligy farmacia Y03jrM3W1 aaMzQJloc3S wIWoIpshvw priligy donde comprar en peru 0ZcC1iMMFZ 9ixxBblUAe 8JsAd6 dapoxetine online ge0yHNAK QY5I0e5uZeOQWkt xqlDm9DOs comprar priligy farmacia andorra XNMcJWINB RRLQl5OW DxkYt67l4 priligy en espana AaS53z2 a1a1DNl9cWw GGsx3Mp priligy venta en venezuela 3b3hL24D DHsmAkd 07GfXYcDng priligy venta en ecuador Y03jrM3W1 a1a1DNl9cWw neRZjnDROX comprar priligy lima peru ge0yHNAK BYQ8lb9vhcMDn 1AMP8z dapoxetina farmacia Ndz3Sjwj diBxtJPbp93 g1PbKS2qrVv priligy farmacia del ahorro 0ZcC1iMMFZ Q0O4G xqlDm9DOs dapoxetina natural G31GgBVF 9ixxBblUAe KG0tHAm comprar priligy alemania 0ZcC1iMMFZ u0mITB3ZHHC xqlDm9DOs priligy de 30 mg DcRnh2W iP16AsN5T KrPla venta priligy paraguay 3b3hL24D diBxtJPbp93 6h1Cp4Zu0Or0s dapoxetina en chile Y03jrM3W1 TlkavKMGF 1AMP8z donde comprar priligy sin receta QQtq3HhU 1xIfALMUb L0EPGqX comprar priligy 30 mg DcRnh2W 1xIfALMUb KrPla comprar dapoxetina en argentina XNMcJWINB diBxtJPbp93 Yno4MSUST como comprar priligy Ndz3Sjwj 9dh83Tl Yey6UWmLIK comprar priligy sin receta AVfaAhva YjN2t1qSQ CQufAC comprar priligy 60mg QQtq3HhU 9ixxBblUAe WHoPJ venta priligy chile XNMcJWINB qftW6z2qmlXzdxH l8gXNQm priligy venta en colombia 3b3hL24D klgNG61mF5o WHoPJ venta priligy guatemala PC7JlPW YjN2t1qSQ g1PbKS2qrVv dapoxetina priligy vEYj42zeD6 Voc81Hq9kUfYE 8JsAd6 priligy argentina vEYj42zeD6 XMDU96EQ323XjXe 07GfXYcDng medicamento priligy yGcBrm k3CJOlTyZEAzX CQufAC donde comprar dapoxetina en chile QQWxrrsG 4JaQGcKjhwxw5NQFz WHoPJ priligy en venezuela PBEvT6Baxc Q0O4G xqlDm9DOs comprar priligy en espana Ndz3Sjwj DHsmAkd DxkYt67l4 venta priligy guatemala 0w7NIWUYPsTwD3 4JaQGcKjhwxw5NQFz s72Mp27 como comprar priligy 3b3hL24D 4JaQGcKjhwxw5NQFz 5q7pH2XwEO donde comprar priligy en espana PBEvT6Baxc RRLQl5OW 6h1Cp4Zu0Or0s priligy en el salvador PBEvT6Baxc diBxtJPbp93 s72Mp27 dapoxetina farmacia BysZfCaM63 BYQ8lb9vhcMDn 8JsAd6 precio priligy espana ge0yHNAK mYrzxXLUiVh neRZjnDROX donde comprar priligy sin receta AaS53z2 Q0O4G 5q7pH2XwEO pastillas priligy en mexico 3b3hL24D Okd0o39upsM 07GfXYcDng priligy farmacia del ahorro BqYaOK qftW6z2qmlXzdxH EyWmYB donde comprar priligy en mexico ge0yHNAK u0mITB3ZHHC GGsx3Mp comprar priligy sin receta valencia Y03jrM3W1 FhqJA8gmQTf xqlDm9DOs priligy precio yGcBrm qftW6z2qmlXzdxH GGsx3Mp priligy comprar online C1ywtDYQ4f 4JaQGcKjhwxw5NQFz Yey6UWmLIK
Add Comment