SlideShare une entreprise Scribd logo
1  sur  14
Télécharger pour lire hors ligne
Don’t be afraid of DITA
your people will love it 

Professor Sissi Closs
Hochschule Karlsruhe
Comet Computer GmbH, Comet Communication GmbH

© Comet Computer GmbH, Comet Communication GmbH
Your people will love it 

© Comet Computer GmbH, Comet Communication GmbH
Benefits of using DITA


Dita supports topic-oriented structuring including
typing and is a standard.



DITA expertise grows.



Knowledge of how to use DITA grows.



The tool landscape continues to grow.

© Comet Computer GmbH, Comet Communication GmbH
Challenges


How to start?



How to structure?



How to organize everything?

© Comet Computer GmbH, Comet Communication GmbH
How to start?
start?
Tech Doc Experts

Others

 Analyze Content
 Categorize
 Create topic type

 Use predefined



templates / forms

 Fill-in topics / templates

templates
Define information
architectures

© Comet Computer GmbH, Comet Communication GmbH
How to start: Tech Doc Experts
start:

© Comet Computer GmbH, Comet Communication GmbH
How to start: Others
start:

© Comet Computer GmbH, Comet Communication GmbH
How to structure?
structure?
Tech Doc Experts

Others











Explicitely tag content
Create separate topics
Use XML tools
Make us of complete
feature set

Use only preselected tag subset
Write content in context
Use Wysiwyg tool (no tags)
Use simple predefined
constructs

© Comet Computer GmbH, Comet Communication GmbH
How to structure: Tech Doc Experts
structure:

© Comet Computer GmbH, Comet Communication GmbH
How to structure: Others
structure:
Solution 1






Authors write in a well prepared Word template.
VBA macro generates more complex structures.
VBA macro generates XML (“simplified DITA”).
XSLT generates DITA topics.
FrameMaker plug-ins, e.g. for CMS connection,
metadata retrieval and update

© Comet Computer GmbH, Comet Communication GmbH
How to structure: Others
structure:
Solution 2
1.
2.
3.
4.

Authors write with basic “normal.dot” Word template
VBA macro generates formatted Word document.
Editors finalize this Word document.
Tool chain as in solution 1:





VBA macro generates more complex structures
VBA macro generates XML (“simplified DITA”)
XSLT generates DITA topics
FrameMaker plug-ins, e.g. for CMS connection,
metadata retrieval and update

© Comet Computer GmbH, Comet Communication GmbH
Complete Tool Solutions
Input

DITA environment

Publications

© Comet Computer GmbH, Comet Communication GmbH
Why people love it







Multiple output (epub format, word, pdf) in good output
quality
Easy content exchange, combination, and integration
Fast results
Documentation that looks more professional
Less maintainance
Not working isolated

© Comet Computer GmbH, Comet Communication GmbH
Questions?



Thank you for your attention
www.comet.de

© Comet Computer GmbH, Comet Communication GmbH

Contenu connexe

Similaire à Closs

Similaire à Closs (20)

How to reduce DTP and translation costs with FrameMaker
How to reduce DTP and translation costs with FrameMakerHow to reduce DTP and translation costs with FrameMaker
How to reduce DTP and translation costs with FrameMaker
 
Jmp108
Jmp108Jmp108
Jmp108
 
[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's
[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's
[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's
 
Markup For Dummies (Russ Ward)
Markup For Dummies (Russ Ward)Markup For Dummies (Russ Ward)
Markup For Dummies (Russ Ward)
 
Implementing Structured FrameMaker
Implementing Structured FrameMakerImplementing Structured FrameMaker
Implementing Structured FrameMaker
 
Bp309
Bp309Bp309
Bp309
 
One Dsl4negotiations Presented
One Dsl4negotiations PresentedOne Dsl4negotiations Presented
One Dsl4negotiations Presented
 
Composite C1 Presentaion
Composite C1  PresentaionComposite C1  Presentaion
Composite C1 Presentaion
 
Tasks Your Business Should Automate in 2022 That Just Make Sense
Tasks Your Business Should Automate in 2022 That Just Make SenseTasks Your Business Should Automate in 2022 That Just Make Sense
Tasks Your Business Should Automate in 2022 That Just Make Sense
 
Code generation
Code generationCode generation
Code generation
 
Save time and your sanity: Increase your efficiency with Microsoft Word (shor...
Save time and your sanity: Increase your efficiency with Microsoft Word (shor...Save time and your sanity: Increase your efficiency with Microsoft Word (shor...
Save time and your sanity: Increase your efficiency with Microsoft Word (shor...
 
Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...
Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...
Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...
 
Building An XML Publishing System With DITA
Building An XML Publishing System With DITABuilding An XML Publishing System With DITA
Building An XML Publishing System With DITA
 
Hss Trends May2009c
Hss Trends May2009cHss Trends May2009c
Hss Trends May2009c
 
DITA support in FrameMaker and XMetaL
DITA support in FrameMaker and XMetaLDITA support in FrameMaker and XMetaL
DITA support in FrameMaker and XMetaL
 
ILUG 2007 - Notes and Office Integration
ILUG 2007 - Notes and Office IntegrationILUG 2007 - Notes and Office Integration
ILUG 2007 - Notes and Office Integration
 
5 Reasons not to use Dita from a CCMS Perspective
5 Reasons not to use Dita from a CCMS Perspective5 Reasons not to use Dita from a CCMS Perspective
5 Reasons not to use Dita from a CCMS Perspective
 
Putting DITA Localization into Practice
Putting DITA Localization into PracticePutting DITA Localization into Practice
Putting DITA Localization into Practice
 
Bp205
Bp205Bp205
Bp205
 
Part i
Part iPart i
Part i
 

Dernier

Breaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdfBreaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdf
UK Journal
 

Dernier (20)

Portal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russePortal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russe
 
Your enemies use GenAI too - staying ahead of fraud with Neo4j
Your enemies use GenAI too - staying ahead of fraud with Neo4jYour enemies use GenAI too - staying ahead of fraud with Neo4j
Your enemies use GenAI too - staying ahead of fraud with Neo4j
 
BT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptx
BT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptxBT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptx
BT & Neo4j _ How Knowledge Graphs help BT deliver Digital Transformation.pptx
 
Syngulon - Selection technology May 2024.pdf
Syngulon - Selection technology May 2024.pdfSyngulon - Selection technology May 2024.pdf
Syngulon - Selection technology May 2024.pdf
 
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdfSimplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
Simplified FDO Manufacturing Flow with TPMs _ Liam at Infineon.pdf
 
WebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM PerformanceWebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM Performance
 
Microsoft CSP Briefing Pre-Engagement - Questionnaire
Microsoft CSP Briefing Pre-Engagement - QuestionnaireMicrosoft CSP Briefing Pre-Engagement - Questionnaire
Microsoft CSP Briefing Pre-Engagement - Questionnaire
 
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdfWhere to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
 
Designing for Hardware Accessibility at Comcast
Designing for Hardware Accessibility at ComcastDesigning for Hardware Accessibility at Comcast
Designing for Hardware Accessibility at Comcast
 
Breaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdfBreaking Down the Flutterwave Scandal What You Need to Know.pdf
Breaking Down the Flutterwave Scandal What You Need to Know.pdf
 
1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT
1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT
1111 ChatGPT Prompts PDF Free Download - Prompts for ChatGPT
 
State of the Smart Building Startup Landscape 2024!
State of the Smart Building Startup Landscape 2024!State of the Smart Building Startup Landscape 2024!
State of the Smart Building Startup Landscape 2024!
 
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
 
Continuing Bonds Through AI: A Hermeneutic Reflection on Thanabots
Continuing Bonds Through AI: A Hermeneutic Reflection on ThanabotsContinuing Bonds Through AI: A Hermeneutic Reflection on Thanabots
Continuing Bonds Through AI: A Hermeneutic Reflection on Thanabots
 
Intro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджераIntro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджера
 
AI presentation and introduction - Retrieval Augmented Generation RAG 101
AI presentation and introduction - Retrieval Augmented Generation RAG 101AI presentation and introduction - Retrieval Augmented Generation RAG 101
AI presentation and introduction - Retrieval Augmented Generation RAG 101
 
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
Secure Zero Touch enabled Edge compute with Dell NativeEdge via FDO _ Brad at...
 
Working together SRE & Platform Engineering
Working together SRE & Platform EngineeringWorking together SRE & Platform Engineering
Working together SRE & Platform Engineering
 
TopCryptoSupers 12thReport OrionX May2024
TopCryptoSupers 12thReport OrionX May2024TopCryptoSupers 12thReport OrionX May2024
TopCryptoSupers 12thReport OrionX May2024
 
Using IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & IrelandUsing IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & Ireland
 

Closs

  • 1. Don’t be afraid of DITA your people will love it  Professor Sissi Closs Hochschule Karlsruhe Comet Computer GmbH, Comet Communication GmbH © Comet Computer GmbH, Comet Communication GmbH
  • 2. Your people will love it  © Comet Computer GmbH, Comet Communication GmbH
  • 3. Benefits of using DITA  Dita supports topic-oriented structuring including typing and is a standard.  DITA expertise grows.  Knowledge of how to use DITA grows.  The tool landscape continues to grow. © Comet Computer GmbH, Comet Communication GmbH
  • 4. Challenges  How to start?  How to structure?  How to organize everything? © Comet Computer GmbH, Comet Communication GmbH
  • 5. How to start? start? Tech Doc Experts Others  Analyze Content  Categorize  Create topic type  Use predefined  templates / forms  Fill-in topics / templates templates Define information architectures © Comet Computer GmbH, Comet Communication GmbH
  • 6. How to start: Tech Doc Experts start: © Comet Computer GmbH, Comet Communication GmbH
  • 7. How to start: Others start: © Comet Computer GmbH, Comet Communication GmbH
  • 8. How to structure? structure? Tech Doc Experts Others         Explicitely tag content Create separate topics Use XML tools Make us of complete feature set Use only preselected tag subset Write content in context Use Wysiwyg tool (no tags) Use simple predefined constructs © Comet Computer GmbH, Comet Communication GmbH
  • 9. How to structure: Tech Doc Experts structure: © Comet Computer GmbH, Comet Communication GmbH
  • 10. How to structure: Others structure: Solution 1      Authors write in a well prepared Word template. VBA macro generates more complex structures. VBA macro generates XML (“simplified DITA”). XSLT generates DITA topics. FrameMaker plug-ins, e.g. for CMS connection, metadata retrieval and update © Comet Computer GmbH, Comet Communication GmbH
  • 11. How to structure: Others structure: Solution 2 1. 2. 3. 4. Authors write with basic “normal.dot” Word template VBA macro generates formatted Word document. Editors finalize this Word document. Tool chain as in solution 1:     VBA macro generates more complex structures VBA macro generates XML (“simplified DITA”) XSLT generates DITA topics FrameMaker plug-ins, e.g. for CMS connection, metadata retrieval and update © Comet Computer GmbH, Comet Communication GmbH
  • 12. Complete Tool Solutions Input DITA environment Publications © Comet Computer GmbH, Comet Communication GmbH
  • 13. Why people love it       Multiple output (epub format, word, pdf) in good output quality Easy content exchange, combination, and integration Fast results Documentation that looks more professional Less maintainance Not working isolated © Comet Computer GmbH, Comet Communication GmbH
  • 14. Questions?  Thank you for your attention www.comet.de © Comet Computer GmbH, Comet Communication GmbH