DITA in the Open Source CMS Drupal - Baltimore 2011
4 likes2,539 views
The document discusses combining DITA (Darwin Information Typing Architecture) with Drupal for documentation purposes. DITA is a standard for authoring, publishing, and managing structured content, while Drupal is an open-source content management system. Integrating the two allows leveraging Drupal's community and tools for DITA-based documentation. Features like DITA forms in Drupal and exporting DITA maps could improve documentation processes. The talk invites the audience to join the community effort around using DITA and Drupal together for documentation.
DITA in the Open Source CMS Drupal - Baltimore 2011
- 1. Doing DITA in the Open Source CMS Drupal Kristof Van Tomme, Pronovix CMS/DITA N-America, April 4-6, 2011, Baltimore, Maryland
- 2. Kristof Van Tomme Belgian Bio-engineer Pronovix Drupal architect Entrepreneur PM of the Drupal Association Hungarian connection Techno-optimist Biotech Drupal evangelist Husband and Father Strategist CEO
- 3. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 5. Drupal sites you might know
- 6. Drupal is really good in Breaking vendor lock-in
- 7. Communities
- 12. Drupal is really good in Breaking vendor lock-in
- 13. Communities
- 15. Open innovation
- 17. Empowering self-learning individuals OPEN
- 18. Drupal is a platform Open source (GPL)
- 19. Drupal core
- 20. Modules
- 21. Features (apps)
- 22. Themes
- 23. Distributions Illustration by developmentseed.org when introducing the features module
- 24. One platform to rule them all Drupal has a fast growing number of distributions Intranets (Open Atrium)
- 25. Collaborative market intelligence (Managing News)
- 26. Customer community platform (Drupal Commons)
- 28. Publishing companies (Open Publish)
- 30. Software as a Service (Aegir + any of the above)
- 31. ...
- 32. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 33. Drupal is a grassroots community “ Come for the code, stay for the community
- 34. But Drupal is also A fast maturing software industry
- 35. A vast network of service providers
- 36. A fast expanding library of handbooks
- 37. A network of trainers
- 38. Used in the biggest enterprise deployments
- 39. Venture backed professional support companies
- 40. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 43. A lot of pretty good documentation
- 44. Organic adaptive documentation structure Drupal.org docs
- 45. API.d.o
- 46. help in drupal core
- 47. issue queue
- 49. blogs
- 50. The bad Very few regularly contribute to the official docs
- 51. No reuse between documentation types
- 52. Documentation is split between resources
- 53. Hard to enforce standards
- 54. A given documentation page is written for a single audience type
- 55. Issues with version specific documentation
- 56. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 57. Combining Drupal & DITA
- 58. What Drupal brings to DITA An open source option
- 59. Interoperability
- 60. Extensibility
- 61. Human friendly metadata handling
- 62. Game dynamics (user points)
- 63. social graph (Facebook integration)
- 64. Community tools (those web 2.0 things)
- 65. RDFa (those web 3.0 things)
- 66. What Drupal brings to DITA An open source option
- 67. Interoperability
- 68. Extensibility
- 69. Human friendly metadata handling
- 70. Game dynamics (user points)
- 71. social graph (Facebook integration)
- 72. Community tools (those web 2.0 things)
- 73. RDFa (those web 3.0 things) CUTTING EDGE
- 74. What Drupal needs from DITA Best practices for single source documentation DITA maps
- 75. Conditional text
- 76. Conrefs
- 77. Topic based documentation Ecosystem of documentation tools & services
- 79. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 80. All that for a community of > ½ Million users
- 82. Mere mortals don't write XML
- 83. Drupal had/has a similar problem
- 84. Crossing the chasm http://www.exampler.com/testing-com/writings/reviews/moore-chasm.html DRUPAL
- 85. The long tail of documentation http://blogs.idc.com/ie/?p=53
- 86. The long tail of documentation HOW DO DITA x 5?
- 87. How do DITA x 5 http://www.archive.org/details/drupalconchi_day3_keynote_jared_spool $ Need a cheap step in solution Usability
- 88. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 89. Words are silver, code is gold
- 90. Drupal DITA forms Use friendly flexible UI to create documentation forms
- 91. Store in Drupal, export in DITA
- 92. Currently implemented for tasks and concepts
- 94. Drupal DITA form builder (CCK)
- 95. Import existing documentation Upload individual files
- 96. Import folders Automatic checkout from a version controlled documentation repository
- 97. Drupal checks for updates Other import options can be tailored for specific use cases to plug into existing processes
- 98. Folder importer
- 99. User driven assembly and export Bookmark relevant documentation topics
- 100. Create a new DITA map in the GUI
- 101. Export the map and the topics it contains
- 102. Ditamaps as mindmaps
- 103. Add content with Views queries
- 104. Ditamaps as mindmaps
- 105. Export with Open Toolkit
- 106. You can download this for free at http://drupal.org/project/dita
- 107. Future Vision DITA in Drupal Metadata integration
- 108. DITA form to DITA XML Graphical UI
- 109. Authoring memory
- 110. Conref library
- 111. WYSIWYG or markup
- 112. 1 or more distributions: Documentation distribution
- 113. DITA distribution
- 114. A toolbox with 6000+ free modules CC BY-NC-SA 2.0 by libertyandvigilance http://www.flickr.com/photos/10459273@N05/3935251879/sizes/z/in/photostream/ 8800+
- 115. Our business = help you realize Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?!
- 116. Future Vision for Drupal Docs Documentation becomes a modular patchable unit, that is used to build project documentation
- 117. Everyone contributes to documentation
- 118. A new niche grows in our community for technical writers
- 119. Projects can be documented from a Fingerprint (XML settings dump)
- 120. Invitation to join our community
- 121. Community portal for DITA Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 122. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
- 123. Twitter @kvantomme LinkedIn be.linkedin.com/in/kvantomme [email_address]
- 124. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?