Hello FrameMaker users,
I need to get Doxygen output (API docs) into a professional-looking format.
1. Is FrameMaker the right tool for this, or is there something better to use?
2. If FrameMaker is the right tool, should I go with structured or non-structured FM?
3. What Doxygen output format is the best to begin working with? (RTF, XML, PDF?!?, ...)
4. Is there an alternative to Doxygen output? (Maybe that's a better first question since it's higher-level...)
Any recommendations, tips, pointers, etc. would be most welcome, since at the moment Word is my default option (ew). I have some preliminary ideas and guesses, but I'd appreciate advice from someone who has actual experience with Doxygen output.
P.S. I'm a career tech writer and quite familiar (15+ years) with unstructured FrameMaker, and love it for tech docs. I've used most of the other tools, too (25+ years).
So are you authoring in Doxygen already?
So what output do you need to produce? IIRC, most API help ends up running in a docs-like-code experience being output through some static site generator.
I guess you could use RTF to import into FM and then tweak with tags to make it pretty. Most suggestions when I did a google of "create PDFs from Doxygen" talk about going to PDF via Latex.
Hi Laura, I am not familiar with Doxygen, but if it can output XML, I would suggest looking at the XML to Structured FrameMaker route. This should be more reliable and require less clean up than going from RTF to unstructured FrameMaker. I would be glad to look at your files via a web meeting to give you some ideas. There would be no cost for this. Please contact me offlist if you are interested. Thanks. -Rick rick at frameexpert dot com