Help to transform Word file to DIta
Post here questions and problems related to editing and publishing DITA content.
-
- Posts: 9
- Joined: Tue Jun 29, 2021 2:27 pm
Help to transform Word file to DIta
Post by Pandounours »
Hello,
I have a user manual to transform into dita. The word file is horrible I cant use the transform plugin. The manual is derived into 2 versions for two products but with a lot of topics in common.
So the manual have a TOC that look like this :
Introduction (there is text inside)
Part1 (little text)
Part1-Sub1 (text)
Part1-Sub2(text)
Part2 (little text)
Part2-Sub1 (text)
Part2-Sub2(text)
How you transform this structure in DITA ?
My point of view :
- create a ditamap with the name manual_base.ditamap
- Introduction is a topic
- Part1 is topic head or a topic ?
- Subtopics are topics inside the topic head ?
And for the two products, I create two ditamaps :
- product1.ditamap
- product2.ditamap
Then I do reference to the manual_base ?
Thanks for your answers sorry if I'm not so clear.
I have a user manual to transform into dita. The word file is horrible I cant use the transform plugin. The manual is derived into 2 versions for two products but with a lot of topics in common.
So the manual have a TOC that look like this :
Introduction (there is text inside)
Part1 (little text)
Part1-Sub1 (text)
Part1-Sub2(text)
Part2 (little text)
Part2-Sub1 (text)
Part2-Sub2(text)
How you transform this structure in DITA ?
My point of view :
- create a ditamap with the name manual_base.ditamap
- Introduction is a topic
- Part1 is topic head or a topic ?
- Subtopics are topics inside the topic head ?
And for the two products, I create two ditamaps :
- product1.ditamap
- product2.ditamap
Then I do reference to the manual_base ?
Thanks for your answers sorry if I'm not so clear.
Re: Help to transform Word file to DIta
Hi,
Your plan looks good to me, maybe you can also post and ask around on the DITA Users List (https://dita-users.groups.io/g/main) to see what the tech writers community has to say about it.
For multiple products you can either have one DITA Map with profiling conditions inside it or multiple DITA Maps. It probably depends on how different the products are.
For those parts, indeed you can create small topics for them or if you consider them useless leave topic head elements or remove them completely.
Regards,
Radu
Your plan looks good to me, maybe you can also post and ask around on the DITA Users List (https://dita-users.groups.io/g/main) to see what the tech writers community has to say about it.
For multiple products you can either have one DITA Map with profiling conditions inside it or multiple DITA Maps. It probably depends on how different the products are.
For those parts, indeed you can create small topics for them or if you consider them useless leave topic head elements or remove them completely.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service