DITA 101

1. DITA 101 Sarah O’Keefe (@sarahokeefe) Scriptorium Publishing (@Scriptorium)

2. Sarah O’Keefe @sarahokeefe ❖ Founder and president, Scriptorium Publishing, www.scriptorium.com ❖ Based in North Carolina ❖ Content strategy for tech comm ❖ Interested in collision of content, publishing, and technology

3. Before we begin… ❖ Everyone is muted except for the presenter ❖ Please ask your questions through the Questions area in the webcast interface ❖ The presentation is being recorded; attendees do not appear in the recording ❖ #dita101 hashtag for Twitter

4. Agenda ❖ What is DITA? ❖ Key DITA concepts ❖ Typical scenarios for DITA ❖ Is DITA right for you?

5. What is DITA? ❖ Darwin Information Typing Architecture ❖ Darwin – because you can evolve new elements from existing elements ❖ Information Typing – content is categorized as task, reference, concept ❖ Architecture – includes components for reuse, single sourcing, and generating output ❖ Developed by IBM, maintained by OASIS

6. Why is DITA important? Is DITA important? ❖ Structured authoring is creating content with programmatic enforcement of the required structure ❖ DITA is a speciﬁc way to do structured authoring ❖ Many software vendors support DITA

7. What is DITA, really? ❖ XML standard ❖ Built for topic-oriented authoring ❖ A way to work in XML without having to design your own structure? ❖ A major buzzword in tech comm ❖ Cost-effective way to create, publish, reuse, and exchange structured content

8. DITA components ❖ Document type deﬁnitions (DTDs, which deﬁne structure) ❖ Open Toolkit for generating output ❖ HTML, Eclipse help, CHM, and others through XSL ❖ PDF through XSL-FO ❖ Documentation

9. DITA publishing

10. What DITA is not ﬂickr: JoelK75

11. ﬂickr: bandita

12. Perhaps it’s this… ﬂickr: erix!

13. ﬂickr: matthewreid Is DITA better than XML?

14. Which is better? ﬂickr: eliduke, mdpettitt

15. Context matters. ﬂickr: NeilsPhotography

16. ﬂickr: liamq

17. DITA’s ideal habitat ❖ Topic-oriented, modular content ❖ Content reuse ❖ Content exchange ❖ Translation/localization workﬂow

18. Most common business case for DITA? ❖ Localization cost savings ❖ Reuse

19. DITA’s challenges ❖ Automated formatting versus hand-crafted pagination ❖ Narrative content ❖ High level of technical expertise required ❖ New skills for authors

20. DITA topic (simpliﬁed) <topic id=”seuss”> <title>One tag, two tag</title> <body> Red tag, blue tag Black tag, blue tag, old tag, new tag This one has a little car This one has a little star <note>Say, what a lot of tags there are!</note> </body> </topic>

21. <?xml version="1.0"?> <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> <topic id="aardvark" audience="internal"> <title>Aardvark</title> <body> Aardvarks eat mostly termites. Do not accept the aardvarks' offer to help deal with your termite problem. You will not like the results. <note type="danger" id="nofeeding">Do not feed animals snacks, scraps, or people food.</note> </body> </topic>

22. <?xml version="1.0"?> I am XML. <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> <topic id="aardvark" audience="internal"> <title>Aardvark</title> <body> Aardvarks eat mostly termites. Do not accept the aardvarks' offer to help deal with your termite problem. You will not like the results. <note type="danger" id="nofeeding">Do not feed animals snacks, scraps, or people food.</note> </body> </topic>

23. <?xml version="1.0"?> <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> I am a DITA topic. <topic id="aardvark" audience="internal"> <title>Aardvark</title> <body> Aardvarks eat mostly termites. Do not accept the aardvarks' offer to help deal with your termite problem. You will not like the results. <note type="danger" id="nofeeding">Do not feed animals snacks, scraps, or people food.</note> </body> </topic>

28. WYSIOO What You See Is…One Option

32. Key DITA concepts ❖ Topics ❖ Map ﬁles ❖ Content references (conrefs) ❖ Specialization

33. Topics ﬂickr: scientiﬁcquilter

34. Map ﬁles ﬂickr: acnatta

35. <?xml version="1.0"?> <!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map rev="1" title="Zoo Policies" xml:lang="en-us"> <topicmeta> <author>Sarah</author> <critdates> <created date="2006/10/31"/> <revised modified="2012/05/31"/> </critdates> </topicmeta> <topicref href="Animal_nutrition.xml" navtitle="Animal nutrition" type="reference"> <topicref href="Aardvark.xml" navtitle="Aardvark" type="topic"/> <topicref href="Baboon.xml" navtitle="Baboon" type="topic"/> <topicref href="Crane.xml" navtitle="Crane" type="topic"/> <topicref href="Dingo.xml" navtitle="Dingo" type="topic"/> </topicref> <topicref href="Visitor_behavior.xml" navtitle="Visitor behavior" type="topic"> <topicref href="Adults.xml" navtitle="Adults" type="topic"/> <topicref href="Children.xml" navtitle="Children" type="topic"/> </topicref> </map>

36. <?xml version="1.0"?> <!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map rev="1" title="Zoo Policies" xml:lang="en-us"> <topicmeta> <author>Sarah</author> <critdates> <created date="2006/10/31"/> <revised modified="2012/05/31"/> I am a DITA map. </critdates> </topicmeta> <topicref href="Animal_nutrition.xml" navtitle="Animal nutrition" type="reference"> <topicref href="Aardvark.xml" navtitle="Aardvark" type="topic"/> <topicref href="Baboon.xml" navtitle="Baboon" type="topic"/> <topicref href="Crane.xml" navtitle="Crane" type="topic"/> <topicref href="Dingo.xml" navtitle="Dingo" type="topic"/> </topicref> <topicref href="Visitor_behavior.xml" navtitle="Visitor behavior" type="topic"> <topicref href="Adults.xml" navtitle="Adults" type="topic"/> <topicref href="Children.xml" navtitle="Children" type="topic"/> </topicref> </map>

40. <?xml version="1.0"?> <!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map rev="1" title="Zoo Policies" xml:lang="en-us"> <topicmeta> <author>Sarah</author> <critdates> <created date="2006/10/31"/> <revised modified="2012/05/31"/> </critdates> </topicmeta> Level 1 <topicref href="Animal_nutrition.xml" navtitle="Animal nutrition" type="reference"> <topicref href="Aardvark.xml" navtitle="Aardvark" type="topic"/> <topicref href="Baboon.xml" navtitle="Baboon" type="topic"/> <topicref href="Crane.xml" navtitle="Crane" type="topic"/> <topicref href="Dingo.xml" navtitle="Dingo" type="topic"/> </topicref> <topicref href="Visitor_behavior.xml" navtitle="Visitor behavior" type="topic"> <topicref href="Adults.xml" navtitle="Adults" type="topic"/> <topicref href="Children.xml" navtitle="Children" type="topic"/> </topicref> </map>

41. <?xml version="1.0"?> <!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd"> <map rev="1" title="Zoo Policies" xml:lang="en-us"> <topicmeta> <author>Sarah</author> <critdates> <created date="2006/10/31"/> <revised modified="2012/05/31"/> </critdates> </topicmeta> Level 1 <topicref href="Animal_nutrition.xml" navtitle="Animal nutrition" type="reference"> Level 2 <topicref href="Aardvark.xml" navtitle="Aardvark" type="topic"/> <topicref href="Baboon.xml" navtitle="Baboon" type="topic"/> <topicref href="Crane.xml" navtitle="Crane" type="topic"/> <topicref href="Dingo.xml" navtitle="Dingo" type="topic"/> </topicref> <topicref href="Visitor_behavior.xml" navtitle="Visitor behavior" type="topic"> <topicref href="Adults.xml" navtitle="Adults" type="topic"/> <topicref href="Children.xml" navtitle="Children" type="topic"/> </topicref> </map>

42. Named destination in Aardvark.xml conrefs <topic id="aardvark"> ... <note type="danger" id="nofeeding">Do not feed animals snacks, scraps, or people food. … </topic> Link in Baboon.xml <topic id="baboon"> <title>Baboon</title> <body> Baboons eat mostly fruit. <note conref="Aardvark.xml#aardvark/nofeeding"/> </body> </topic>

45. Specialization ❖ Lets you create additional elements without breaking DITA Open Toolkit processing. ❖ New element is a specialization of the base element. ❖ This is what put the D in DITA.

46. Customization options ﬂickr: munksynz

47. Customization

48. Constraints

49. Specialization

50. Business case for XML ❖ Content exchange ❖ Database publishing ❖ Reuse content/reduce duplication ❖ Automated formatting/publishing ❖ Compliance

51. Beyond XML’s business case, DITA may… ❖ Reduce content modeling effort ❖ Make content truly portable ❖ Support content reuse ❖ Take advantage of software support ❖ Provide output options ❖ Reduce overall cost of implementation

52. Reduce content modeling effort

53. Make content truly portable ﬂickr: aloha75

54. Support content reuse ❖ Map ﬁles ❖ conrefs (and variations) ❖ keyrefs (and variations)

55. Software support ❖ DITA support found in many (most?) XML authoring tools ❖ Some tools support only DITA and not general XML

56. Provide output options ❖ XHTML, HTML Help, PDF, Eclipse, DocBook, JavaHelp, troff, Word RTF through DITA Open Toolkit ❖ Starting point for output ❖ Not suitable for production workﬂow ❖ Customization is difﬁcult and time-consuming

57. Is DITA right for you? ﬂickr: nugunslinger

58. Yes ❖ DITA meets all requirements. ❖ A business partner or customer requires DITA content. ❖ Single sourcing is a requirement. ❖ No existing content. ❖ Can be ﬂexible with markup requirements to make implementation faster.

59. No. ❖ Content must conform to a speciﬁc standard, such as S1000D. ❖ Content is and should remain narrative. ❖ Semantic requirements are industry- speciﬁc, complex, and/or strict. ❖ No possibility of internal or external support for technical challenges.

60. Maybe. ❖ DITA is not an exact match. ❖ Customization/specialization would be required.

61. Questions?

DITA 101

Recomendados

Recomendados

Más contenido relacionado

Destacado

Destacado (7)

Similar a DITA 101

Similar a DITA 101 (20)

Más de Scriptorium Publishing

Más de Scriptorium Publishing (20)

Último

Último (20)

DITA 101