Closs

•

0 j'aime•392 vues

sheila leahy

Technologie

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

How to reduce DTP and translation costs with FrameMakerGlobalization Partners International

Jmp108John Head

[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why'sScott Abel

Markup For Dummies (Russ Ward)STC-Philadelphia Metro Chapter

Implementing Structured FrameMakerDkadilak62263

Bp309John Head

One Dsl4negotiations Presentedpierino23

Composite C1 Presentaionjakobbartholdy

Tasks Your Business Should Automate in 2022 That Just Make SenseSafe Software

Code generationDoug Holland

Save time and your sanity: Increase your efficiency with Microsoft Word (shor...Rhonda Bracey

Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...StartWithXMLLondon

Building An XML Publishing System With DITAScott Abel

Hss Trends May2009cJoe Bachana

DITA support in FrameMaker and XMetaLScriptorium Publishing

ILUG 2007 - Notes and Office IntegrationJohn Head

5 Reasons not to use Dita from a CCMS PerspectiveMarcus Kesseler

Putting DITA Localization into PracticeXMetaL

Bp205John Head

Part iMohamed Ebrahim

Similaire à Closs (20)

How to reduce DTP and translation costs with FrameMaker

Jmp108

[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's

Markup For Dummies (Russ Ward)

Implementing Structured FrameMaker

Bp309

One Dsl4negotiations Presented

Composite C1 Presentaion

Tasks Your Business Should Automate in 2022 That Just Make Sense

Code generation

Save time and your sanity: Increase your efficiency with Microsoft Word (shor...

Marcus Kesseler: Weaving XML Into Your Workflows: Use Cases, Tools, Pitfalls ...

Building An XML Publishing System With DITA

Hss Trends May2009c

DITA support in FrameMaker and XMetaL

ILUG 2007 - Notes and Office Integration

5 Reasons not to use Dita from a CCMS Perspective

Putting DITA Localization into Practice

Bp205

Part i

Dernier

Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoffsammart93

Manulife - Insurer Transformation Award 2024The Digital Insurer

FWD Group - Insurer Innovation Award 2024The Digital Insurer

Apidays New York 2024 - Accelerating FinTech Innovation by Vasa Krishnan, Fin...apidays

DBX First Quarter 2024 Investor PresentationDropbox

EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWERMadyBayot

Apidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbuapidays

Powerful Google developer tools for immediate impact! (2023-24 C)wesley chun

Data Cloud, More than a CDP by Matt RobisonAnna Loughnan Colquhoun

AWS Community Day CPH - Three problems of TerraformAndrey Devyatkin

MS Copilot expands with MS Graph connectorsNanddeep Nachan

Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...apidays

Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...Miguel Araújo

Strategies for Landing an Oracle DBA Job as a FresherRemote DBA Services

Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...apidays

TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc

Artificial Intelligence Chap.5 : UncertaintyKhushali Kathiriya

How to Troubleshoot Apps for the Modern Connected WorkerThousandEyes

Ransomware_Q4_2023. The report. [EN].pdfOverkill Security

"I see eyes in my soup": How Delivery Hero implemented the safety system for ...Zilliz

Dernier (20)

Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff

Manulife - Insurer Transformation Award 2024

FWD Group - Insurer Innovation Award 2024

Apidays New York 2024 - Accelerating FinTech Innovation by Vasa Krishnan, Fin...

DBX First Quarter 2024 Investor Presentation

EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER

Apidays Singapore 2024 - Modernizing Securities Finance by Madhu Subbu

Powerful Google developer tools for immediate impact! (2023-24 C)

Data Cloud, More than a CDP by Matt Robison

AWS Community Day CPH - Three problems of Terraform

MS Copilot expands with MS Graph connectors

Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...

Mastering MySQL Database Architecture: Deep Dive into MySQL Shell and MySQL R...

Strategies for Landing an Oracle DBA Job as a Fresher

Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...

TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments

Artificial Intelligence Chap.5 : Uncertainty

How to Troubleshoot Apps for the Modern Connected Worker

Ransomware_Q4_2023. The report. [EN].pdf

"I see eyes in my soup": How Delivery Hero implemented the safety system for ...

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

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

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

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

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

Closs

Recommandé

Recommandé

Contenu connexe

Similaire à Closs

Similaire à Closs (20)

Dernier

Dernier (20)

Closs