Question

I am one of the authors of an in-house software system at Nomura bank in London. My colleagues and I have written documentation for this system using a (commercial) application called RoboHelp. RoboHelp produces a Windows Help file (.hlp) from MS Word documents.

We would like to port our documentation to TWiki, but are slightly daunted by the number of topics to convert: over 2000. I wondered if any other TWiki users have experience in converting large amounts of documentation from Word to TWiki, and if they could offer me any tips?

Here are some more details: I found the MsWordToTWikiMLAddOn and adapted the code slightly so that now I have VBA code which can convert the bold or italicised text and tables to TWiki syntax. Also I downloaded some software from GrindEQ.com to convert the equations from Microsoft Equation Editor to TeX, which we can view using the LatexModePlugin.

Any help gratefully received!

Environment

-- JamesMcEwen - 04 Jan 2007

Answer

If you answer a question - or have a question you asked answered by someone - please remember to edit the page and set the status to answered. The status is in a drop-down list below the edit box.

Your approach above certainly seems reasonable.

Another avenue to try would be the Parse module addition to the LatexModePlugin. You could use grindeq's Word-to-Latex, and then run the tex version of the document through Parse to get a twiki version. This path would potentially be scriptable.

See IncludeExistingLatexDocsInTWiki for more details, including a link to get Parse installed. The module is still in development, has been known to work on a number of tex documents, but isn't yet ready for inclusion in a general release. It will likely work, but I haven't tested it on the output of Word-to-Latex, yet.

Good luck, and welcome to TWiki.

-- ScottHoge - 04 Jan 2007

James, if you have a solution would you be willing to share this with the TWikiCommunity as a RoboHelpToTWikiAddOn? See Plugins.ReadmeFirst and other Tag:import add-ons.

-- PeterThoeny - 04 Jan 2007