I'm a software person who has been tasked with moving a few thousand pages of documentation for a piece of legacy software online. The documentation is all in Adobe Framemaker and yes, there are lots of equations. The Framemaker HTML output is ugly and I'm thinking that moving everything to LaTeX would be painful but worth the effort because a) I and other people know it, b) it looks good, and c) it's flexible.

Please weigh in on:

Is this plan crazy? I'm not a technical writer and I don't want to misjudge the magnitude of this.

Are there any Framemaker conversion tools out there? Right now I'm thinking of saving the .fm docs in HTML and using Pandoc to convert to LaTeX. Does anyone have experience with any part of this?

Any advice about the equations?

  • 4
    I would suggest something like Pandoc, maybe. – Werner Apr 18 '15 at 0:54
  • 2
    The more 'structured' the HTML output is, the easier the task will be. But a few thousand pages? Are you going to read it all? If so, you'll be reading a few thousand pages at least twice. That's a lot of pretty unexciting (I'd guess) reading. – jon Apr 18 '15 at 1:05
  • 4
    Did a bit of web surfing. I have never used FrameMaker but his may have potential.chess.eecs.berkeley.edu/ptexternal/wiki/Main/FramemakerToLaTeX And here is another link cs.stir.ac.uk/~kjt/software/framemaker. And cs.stir.ac.uk/~kjt/software/framemaker/mif_la.html I would recommend you test any solution with a small representative subset of the documentation (10-20 pages) – R. Schumacher Apr 18 '15 at 2:52
  • "The Framemaker HTML output is ugly", Is HTML output from LaTeX code not ugly? Did you test that. I always found HTML conversion tools from LaTeX pretty poor. Maybe because the target format/structure is quite different. Maybe the situation has improved lately. – alfC Apr 18 '15 at 3:37
  • 1
    Are you talking about ugly HTML or about an ugly-looking output? Even the prettiest HTML looks bad without a proper CSS (stylesheet). – Tobias Kienzler Jan 6 '17 at 8:53

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Browse other questions tagged or ask your own question.