Seismicdesignofstructuresproject 1339890883713 Phpapp02 120616185749 Phpapp02
ditaquickstart1-090808224938-phpapp02
-
Upload
francisco-castillo -
Category
Documents
-
view
219 -
download
0
Transcript of ditaquickstart1-090808224938-phpapp02
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 1/60
DITA Quick StartSelvakumar T.S
August 9, 2009 Cadence Confidential: Cadence Internal Use Only1
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 2/60
Agenda
• A quick look at XML
• Understand DITA’s overall approach
• Understand DITA’s core content structures and how youcan customize them
• n ers an e scope or reuse n
• See DITA at work!!
August 9, 2009 Cadence Confidential: Cadence Internal Use Only2
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 3/60
A Quick Look at XML
August 9, 2009 Cadence Confidential: Cadence Internal Use Only3
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 4/60
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 5/60
Extend tagging through elements and
• XML tagging can be extended as data access requirements change:
– For example, you can add a “surname” element to identify the lastname for sorting purposes
• Attributes provide information about your data: – Adding an attribute called “gender” to the “child” element allows you to
– Examples of possible attribute applications for content:
• Product Name, Product Version, etc.
“ ”.
<family>
<father><name>Joseph<surname>Clark</surname></name></father>
<mother><name>Mary <surname>Clark</surname</name></mother>
<offspring>
<child gender=“girl”><name>Jennifer <surname>Clark</surname></name></child><child gender=“boy”><name.Joseph <surname>Clark</surname></name></child>
<child gender=“girl”><name>Taylor <surname>Clark</surname></name></child>
</offspring>
August 9, 2009 Cadence Confidential: Cadence Internal Use Only5
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 6/60
Does extensibil ity lead to chaos?
• If XML allows custom elements and attributes, how do we ensure
consistency of information and formatting across many authoring
• We define a Document Type Definition (DTD) that allows us to setrules:
–
– Required or not?
– Number of elements allowed and whether ordering rules apply –
• Other elements
• Text
• Attributes
• Predefined attribute values
August 9, 2009 Cadence Confidential: Cadence Internal Use Only6
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 7/60
The benefits of XML
• XML is a text format that follows an open standard – Is not bound to proprietary authoring tools or formats
– - ,
• Enables information reuse at the sub-document level
– Hierarchical nesting of markup tags creates containers of content within
– Referencing an element includes the information contained within that
element, allowing reuse of information at multiple levels of granularity:an entire topic, a set of steps or individual step; a glossary entry (term +definition)
• Separates content from formatting
– Different groups/formats can point to the same piece of content without
reformatting or retagging the information
– Enables dynamic transformation of data
If XML can do all this, wh do we need XML standards for technical documentation?
August 9, 2009 Cadence Confidential: Cadence Internal Use Only7
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 8/60
Need for XML standards for technical documentation
• Document-centric XML didn’t grow nearly as fast as
data-centric XML. XML standards bodies focused more
on data-centric standards.
• Home-built DTDs a challenge“Com anies often s end tens if not hundreds of thousands of dollars develo in
custom DTDs, yet they often turn out to be inflexible and costly to maintain”
- JoAnn Hackos, Comtech Services
• Need for more collaborative authoring within and acrossorganizations
August 9, 2009 Cadence Confidential: Cadence Internal Use Only8
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 9/60
XML standards for technical documentation
• Two “popular” open source standards – DocBook
–
• Each standard takes fundamentally different approaches
• DocBook – Best suited for linear content: books and articles.
– DTD covers all possible authoring requirements.
– Does not su ort trul modular content.
– Incomplete reuse and cross-referencing mechanisms
– Difficult to customize the DocBook DTD. Customization isthrough hiding of elements that are not required.
Does DITA solve core documentation challenges?
August 9, 2009 Cadence Confidential: Cadence Internal Use Only9
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 10/60
What is DITA?
• DITA = Darwin Information Typing Architecture
• Developed by IBM
• Now an OASIS (Organization for the Advancement ofStructured Information Standards) standard
– urren vers on: .
“We propose the XML-based Darwin Information Typing Architecture (DITA) as an
end-to-end architecture for creating and delivering modular technical information.”
— Michael Priestley, IBM
August 9, 2009 Cadence Confidential: Cadence Internal Use Only10
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 11/60
High-Level DITA Architecture
• DITA XML architecture is based on a Topic DTD and a
Map DTD
• DITA information architecture is based on topics ─
unitsof information that serve as building blocks for all
• DITA maps assemble topics for specific documentation
deliverables
August 9, 2009 Cadence Confidential: Cadence Internal Use Only11
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 12/60
Core design principles of DITA
• Topic orientation
– Discrete units of information covering a specific subject with a specificintent
• Topic granularity
– Topics combine with other topics into information sets
• Consistency
– DITA DTDs guarantee that DITA information types follow identicalinformation structures
• Separation of content (specific topics) from context (links to otherop cs, es, nav ga on
– Not just separation of content from formatting!!
• Inheritance
“ ” – -their structures
• Specialization
– Abilit to extend basic information t es for s ecial uses
August 9, 2009 Cadence Confidential: Cadence Internal Use Only12
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 13/60
Topic: a unit of information that is meaningful when it.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only13
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 14/60
About DITA topics
• A chunk of information specific to a single subject.
• Short enough to be specific to a single subject or answer
a single question.
• Long enough to make sense on its own and be authored
.
• Each topic must follow the rules for a specific
information type.
• DITA prescribes three information types:
– Concept
– as – Reference
• To ic files can have the .dita or .xml extension
August 9, 2009 Cadence Confidential: Cadence Internal Use Only14
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 15/60
Information types in DITADITA’s base
information type
overview
information Referenceinformation
Procedural, step-
by-step
information
Can I have a topic that has a
mix of information types?
August 9, 2009 Cadence Confidential: Cadence Internal Use Only15
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 16/60
Why only 3 information types?
• Standards like Information Mapping have six information types: – Procedure
– Process
– Structure
– Concept
– Principle – Fact
• IBM itself had 12 information types before DITA: – oncep ua
– Error
– General Reference
– Glossary – Language Reference
– Mapping
– Orientation
– Sample
– Task
–
– UI Reference – Walkthrough/Tutorial
August 9, 2009 Cadence Confidential: Cadence Internal Use Only16
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 17/60
Why only 3 information types in DITA?
• DITA considers that other information types are basically
derivatives of the three core information types: Concept,
Task and Reference.
• If required, you can customize the core information types
specialization.
• Bottomline: DITA does not claim to cover allrequirements. It covers a base set or requirements and
allow other requirements to be covered by extensions.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only17
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 18/60
Concept topics
• Concept topics introduce the background or overview
information for task or reference topics.
• Concept topics should not describe task or reference
information.
section or example, only other sections or examples are
permitted as content. This ensures that readers are notconfused about the content between sections or
examples.
• ,
concept.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only18
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 19/60
Concept topic structure
<concept>
<title>
<titlealts>
<navtitle><searchtitle>
<shortdesc>
<prolog>
<conbody>
< > < >
<related-links>
August 9, 2009 Cadence Confidential: Cadence Internal Use Only19
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 20/60
Concept topic example
August 9, 2009 Cadence Confidential: Cadence Internal Use Only20
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 21/60
Task topics
• Task topics describe the steps of a particular task, or
provide an overview of a higher-level task.
• Task topics should not describe conceptual or reference
information.
,
one task.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only21
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 22/60
Task topic structure
<task>
<title>
<titlealts>
<shortdesc>
< rolo >
<taskbody>
<prereq>
< >
<steps>
<result>
< >
<postreq>
<related-links>
August 9, 2009 Cadence Confidential: Cadence Internal Use Only22
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 23/60
Task topic example
August 9, 2009 Cadence Confidential: Cadence Internal Use Only23
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 24/60
Reference topics
• Reference topics provide quick access to facts. They
describe product features, commands, and so on.
• Information needed for deeper understanding of a
reference topic or to perform related procedures should
.
• Reference topics should be designed for quick scanning
of information using lists, tables, and such.• Reference topics should not describe conceptual or task
information.
,subject ─ for example, explain only one command.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only24
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 25/60
Reference topic structure
<reference>
<title>
<titlealts>
<shortdesc>
< rolo >
<refbody>
<example> | <section> | <refsyn> | <table> | <simpletable> |
< ro erties>
<related-links>
August 9, 2009 Cadence Confidential: Cadence Internal Use Only25
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 26/60
Reference topic example
August 9, 2009 Cadence Confidential: Cadence Internal Use Only26
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 27/60
Why structure topics by information type?
• Benefits for Writers – Standard, consistent structures for authoring content
– Writers can use topic types to more effectively outline informationnee s
– Helps to analyze information according to the purpose or function itserves for the reader
– Organizing common types of information with topics help writers spendmore t me ocuse on aut or ng content
– Choice for selecting the best and most consistent way to presentinformation, based on information type
– Identify missing information – Breaking down information into chunks helps in better planning and
work distribution among writers
• Benefits for Users/Readers – ’
purpose – Readers learn and retain different types of information better when they
are written in a consistent, predictable way
August 9, 2009 Cadence Confidential: Cadence Internal Use Only27
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 28/60
DITA Maps
DITA maps assemble topics into a coherent set.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only28
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 29/60
About DITA maps
• Ability to reuse and repurpose the same content for
different deliverable types and for deliverables for
different audiences and products.
• Maps can include DITA topic (.dita) files, XML (.xml),
, , , .
• Same topic can be referred to more than once in a map
or in different maps.• Maps can be nested into other maps to build
documentation deliverables.
scripts during the production process.
• DITA ma files have the .ditama extension.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only29
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 30/60
Different deliverables using DITA maps
Topic 1
Quick
StartGuide
Topic 2User
Guide
Topic 3
Reference
Topic 4
August 9, 2009 Cadence Confidential: Cadence Internal Use Only30
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 31/60
Different formats using DITA maps
August 9, 2009 Cadence Confidential: Cadence Internal Use Only31
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 32/60
Map structure
<map>
<topichead>
<topicref>
<reltable>
<anchor>
<navref>
<topicgroup>
August 9, 2009 Cadence Confidential: Cadence Internal Use Only32
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 33/60
DITA Map example
• Example of DITA map in XMetaL
August 9, 2009 Cadence Confidential: Cadence Internal Use Only33
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 34/60
DITA maps do more!!
• Separate of content (specific topics) from context (links to other topics, files,navigation) – Links are s ecified in the DITA ma and not in the to ic file itself. Hel s to ics remain
“stand alone”.
– Links are automatically generated for the topics from the DITA maps. Helps automaticallyupdate links if topic title or topic file location changes.
• Build a relationship table to generate “related topics” links –
– Similar to creating cross references, but moves linking mechanism from content into themap
– Links are generated only in the output version of the topics
– Increases reusability—no broken links when taking a piece of content out of context•
– Properties include the title and metadata
– Can change the topic title relative to the parent topic
– Metadata can identify a topic as advanced for one deliverable and basic for another
• Can rovide multi le views on the same to ics: b roduct b task b to ic t e
audience and so on.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only34
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 35/60
Metadata Support in DITA
August 9, 2009 Cadence Confidential: Cadence Internal Use Only35
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 36/60
Metadata support in DITA
• DITA supports a variety of standard and custom
metadata:
– Author information
– Copyright information
– Product information
– Resource IDs for help systems
– Document tracking information
–
– Keywords
– Custom metadata (otherprops)
• Metadata is supported using the <prolog> element intopics and <topicmeta> in maps.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only36
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 37/60
Metadata elements within <prolog> element
<prolog><author> (name of topic’s author)
<copyright>
<critdates> (document tracking information)
<permissions><publisher>
<metadata><audience> (intended audience)
type=“user | purchaser | administrator | … | other”
job=“installing | customizing | administering | … | other”
otherjob=
experiencelevel=“novice | general | expert”
<keywords> (keywords for search engines)<prodinfo>
<othermeta>
August 9, 2009 Cadence Confidential: Cadence Internal Use Only37
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 38/60
Reuse in DITA
August 9, 2009 Cadence Confidential: Cadence Internal Use Only38
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 39/60
Reuse in DITA
• Reuse flows from the topic-based paradigm
– Topics can be reused in different contexts
– Topics from multiple components can be integrated as a solution
• Reuse methods
– -
– Topic-level reuse with <topicref>
– Map-level reuse with <navref> and <anchorref> – on t ona reuse
August 9, 2009 Cadence Confidential: Cadence Internal Use Only39
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 40/60
Element level reuse with <conref>
• Conrefs are a way to reference content from the same or
another DITA file
Example
– Code in source file source.dita:
<ste id="commonste "><cmd>This ste exists in a common file and is added
with a conref.</cmd></step>
– Code in target file B:<step conref=“source.dita#task/commonstep"><cmd></cmd></step>
Note that the <cmd> tags are included even through they will be
replaced by the conreffed information.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only40
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 41/60
Conditional reuse
• DITA gives you four ways of tagging conditionally using AND/OR
logic:
–
– Platform – Product
–
Example:
The king and queen of Olympus are <phau ence= gree eus p p au ence= roman up er p
and <ph audience="greek">Hera</ph><ph
audience="roman">Juno</ph>.
“ ” – ,
The king and queen of Olympus are Zeus and Hera.
– When audience=“roman” is set to include, this reads
The kin and ueen of Ol m us are Ju iter and Juno.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only41
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 42/60
Specialization in DITA
August 9, 2009 Cadence Confidential: Cadence Internal Use Only42
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 43/60
Topics inherit from DITA’s base “ Topic” …
…making it possible to extend through specialization.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only43
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 44/60
Specialization
• ’
publishing toolchains
• Specialization can occur in topics, maps, or domains
August 9, 2009 Cadence Confidential: Cadence Internal Use Only44
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 45/60
Specialization: Specializing Topics
• Topic is the core.
• Each specialization is a delta in design, and if it needs
special processing that's a delta too.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only45
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 46/60
Specialization: Specializing Maps
• While DITA maps are flexible by default, you can use
map specialization to define or enforce a particular type
.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only46
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 47/60
Specialization: Specializing Domains
• DITA domains extend DITA with a set of elements whose namesand content models are unique to an organization or field ofknowledge. For example, you may have elements specific to
ocumen ng so ware.
• Specialization lets domain-specific elements inherit from existingelements.
August 9, 2009 Cadence Confidential: Cadence Internal Use Only47
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 48/60
DITA Tools
August 9, 2009 Cadence Confidential: Cadence Internal Use Only48
DITA t l
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 49/60
DITA tools
• Modeling tools
– IBM Task Modeler-for creating DITA maps(http://www.alphaworks.ibm.com/tech/taskmodeler )
• Authoring tools
– Arbortext Epic Editor (http://www.ptc.com/) – XMetal (http://www.justsystems.com/)
– Syntext Serna (http://www.syntext.com)
– FrameMaker 8 with Adobe FrameMaker 8 Plug-in for DITA OpenToolkit
. . _ .
– DITA Storm (browser-based DITA editor)(http://www.ditastorm.com/onlineDitaEditor.html)
• Production tools
– DITA Open Toolkit (http://dita-ot.sourceforge.net/)• Content management systems
– Astoria CMS, EMC Documentum, PTC Windchill, SiberLogic Sibersafe,
August 9, 2009 Cadence Confidential: Cadence Internal Use Only49
ason ….
IBM T k M d l f DITA
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 50/60
IBM Task Modeler for DITA maps
• IBM was using Rational Rose XDE Developer for
content modeling
• Need for a customized modeling tool resulted in the IBM
Task Modeler:. . .
• Eclipse-based plugin for modeling tasks and designing
DITA maps
August 9, 2009 Cadence Confidential: Cadence Internal Use Only50
DITA Open Toolkit: the DITA production pipeline
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 51/60
DITA Open Toolkit: the DITA production pipeline
• rov es e au or ng an pro uc on n ras ruc ure or .• Open source: http://dita-ot.sourceforge.net/
• Supported outputs: –
– XHTML
– Eclipse help
– HTML Hel
– Java Help
– PDF using XSL-FO
August 9, 2009 Cadence Confidential: Cadence Internal Use Only51
DITA Open Toolkit
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 52/60
DITA Open Toolkit
• Consists of DTD, XML schema, stylesheets, samples, anddocumentation for DITA.
• Open source infrastructure
• Ant for builds• FOP for XSL-FO to PDF
• Xalan or Saxon for XSL-T
processing to HTML/xHTML
output• Java
August 9, 2009 Cadence Confidential: Cadence Internal Use Only52
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 53/60
DITA Resources
August 9, 2009 Cadence Confidential: Cadence Internal Use Only53
DITA Resources
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 54/60
DITA Resources
• DITA Standard
OASIS DITA Technical Committee http://www.oasis-
open.org/committees/dita
• DITA Articles – . . .
– DITA Users: http://www.ditausers.org/
– http://dita.xml.org
– ttp: www- . m.com eve operwor s xm rary x- ta
– http://www.slideshare.net/search/slideshow?q=DITA
• Books on DITA
– Introduction to DITA: A User Guide to the Darwin InformationTyping Architecture by Jen Linton and Kylene Bruski, Comtech
Services htt ://www.comtech-serv.com/dita.shtml
August 9, 2009 Cadence Confidential: Cadence Internal Use Only54
DITA Resources
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 55/60
DITA Resources
• DITA Demos / Webinars
– FrameMaker 8 Deep Dive: DITA Topic-based authoring
ps: a m n.a o e.acro a .com _a p
– <several>• DITA User Grou s
– http://groups.yahoo.com/group/dita-users/
– http://groups.yahoo.com/group/framemaker-dita/
– . . -
August 9, 2009 Cadence Confidential: Cadence Internal Use Only55
Real li fe DITA examples
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 56/60
Real li fe DITA examples
• WebSphere Application Server Documentationhttp://www-
. .
• Adobe Creative Suite documentation• Adobe Acrobat documentation
• Apache Derby documentation
• Eclipse documentation
August 9, 2009 Cadence Confidential: Cadence Internal Use Only56
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 57/60
DITA Demo
August 9, 2009 Cadence Confidential: Cadence Internal Use Only57
Typical DITA workflowUse DITA maps
for content
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 58/60
Typical DITA workflow modeling !!
1. Identify the task topics.
2. Identify the concept and reference topics needed to
support the task topics.
3. Create the topics.
. se maps o assem e op cs or eac
documentation deliverable.
Eclipse help
JavaHelp
Write Build ArchitectEclipse help
JavaHelp
Write Build Architect Write Build Architect
Web pages
Books & PDFs
Learning
Web pages
Books & PDFs
Learning
August 9, 2009 Cadence Confidential: Cadence Internal Use Only58
Architecture
Map
Maps
Architecture
Map
Maps
Architecture
Map
Maps
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 59/60
August 9, 2009 Cadence Confidential: Cadence Internal Use Only59
8/13/2019 ditaquickstart1-090808224938-phpapp02
http://slidepdf.com/reader/full/ditaquickstart1-090808224938-phpapp02 60/60
Thanks for our artici ation!!Thanks for our artici ation!!