Skip to main content
R
ramukneevan007
Participant
May 30, 2013
Question

Unstructured Framemaker to DITA

  • May 30, 2013
  • 2 replies
  • 5262 views

 

I need to move my documents from unstructured FrameMaker to DITA docs. Could anyone explain me or point me a link about the step by step instructions to migrate from unstructured to DITA Docs?

PS: I have framemaker 10 license. My preference is not to spend any or more money to do this migration.

Expect Good response.

Thanks,

Naveen

This topic has been closed for replies.

2 replies

A
Anonymous
May 30, 2013

Russ is giving you good advice.  DITA offers many advantages, but it's not a magic solution.  It's probably not going to be completely expense-free either.

  • For topic-based authoring in general, you have to learn to think differently about how to write before you can realize gains. 
  • For DITA in particular, your authors will have to become familiar with XML and DITA in order to create topics. Authoring tools such as FrameMaker, DITA-FMx, or oXygen can help, but for practical puposes, they can't hide the XML completely. You'll also have to train authors on DITA elements and attributes, and techniques for using them.
  • To get output, you'll need to understand XSLT, CSS, and probably the DITA Open Toolkit and Ant. (DITA2Go is a strong alternative, but it's not in the XSL-based mainstream of DITA activity.)
  • To manage your topics, you'll need a decent Content Management System.

As for conversion: I've used both the conversion-table method and Mif2Go to convert unstructured Frame docs to DITA.  In my opinion, Mif2Go is easier to figure out, does a lot of the work for you, and does a better job on the conversion. It is well worth the modest expense. But if you want to use the conversion-table method, I would start by defining a few conversion rules for your major paragraph tags, see what you get, and take it from there. It took me about 35 iterations to get a reasonably decent conversion table for my tag set.

Ether way you will almost certainly have to make some manual touch-ups.

(EDIT) If you're looking for information on how to create a conversion table, you'll need the Structured Application Developer Reference (Chapter 4).

http://help.adobe.com/en_US/FrameMaker/9.0/StructuredDev/Structure_Dev_Reference.pdf

R
Russ Ward
Legend
May 30, 2013

Hi Naveen,

There is no such thing as step-by-step instructions to do this. There are broad concepts, such as:

- Using conversion tables in conjunction with the DITA EDDs/templates to make the conversion

- Using a third-party app such as Mif2Go (http://www.omsys.com/dcl/mif2go_main.htm)... I think that's the right Omni Systems app.

But I am sensing something else... that maybe you need some more knowledge in this area before attempting such a task. This type of migration is a very big deal and a significant effort. To approach it without the proper planning and expertise is a good way to fail in the long run.

Have you done the proper analysis for this? Why the choice of DITA in the first place?

Russ

[The current link to the Mif2go site is: http://mif2go.com/ ]

R
ramukneevan007Author
Participant
May 30, 2013

Hi Russ,

First of all thank you for the resposne.

My company wants to migrate from unstructured to structured DITA authoring so as to reap the benefits of DITA (Topic Based Authoring, easy management of docs, Content Reuse...and many more).

I have done research and analysis of this migration and understood the concepts of EDD and Conversion tables. But what I need is:

1. What are all the action items required for this migration?

2. Where should I start and where should I end ?

Thanks,

Naveen

R
Russ Ward
Legend
May 30, 2013

Hi Naveen,

I don't mean to patronize, but I'm not sure that you have studied EDDs, etc.  enough detail, otherwise you would have the answers to your questions already. In any case, I need to reiterate that there is no single, concise procedure for this. It is a big effort with endless variations that requires agility and savvy throughout.

I want to also note that while DITA can bring rewards, they are not automatic. In fact, unless you have a clear idea of how you will leverage the various options that DITA provides, the entire effort may result in expense rather than reward.

Anyway, I don't mean to lecture. I'm just trying to provide some background as to why I am not able to answer your questions over a forum post. It is such a big undertaking that one could write an entire book about it. Perhaps someone else can summarize better than me, but that's about the best I can do. In any case, I do think that some form of structured authoring is the first step to entering the 21st century of technical publishing, so I do commend you on beginning this venture.

Russ

Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices