TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
-------------- Original message ----------------------
From: "Andrew Warren" <awarren -at- synaptics -dot- com>
> Siliconwriter [mailto:siliconwriter -at- comcast -dot- net] wrote:
>
> > > You asked if there's any way to get hyperlinks into a
> > > Doxygen-generated RTF file. You should be able to do
> > > that by setting RTF_HYPERLINKS=YES in your Doxygen
> > > configuration file.
> >
> > Thanks, Andrew. I don't remember seeing this setting in
> > the config file, but I'll take another look. This would
> > solve many problems if it worked!
>
> Sarah:
OK, I set the RFT_HYPERLINKS = YES as indicated, and Doxygen generated an RTF file. To verify that the links were preserved, I opened the RTF as a Word document and tested it--all is well. I saved a copy as a Word doc. I opened InDesign, and pulled BOTH the RTF and Word documents into InDesign files (using File > Place). When I pulled the RTF into InDesign, I got 640 pages of garbage such as:
sitor::visitPre(DocRef)BVSP General DefinitionsRTFDocVisitor::visitPost(DocRef) RTFDocVisitor::visit(DocWhiteSpace) RTFDocVisitor::visit(DocWord)inRTFDocVisitor::visit(DocWhiteSpace) RTFDocVisitor::visit(DocLinkedWord)bvsp.hRTFDocVisitor::visit(DocWhiteSpace) RTFDocVisitor::visitPost(DocHtmlDescTitle)
Clearly not something I can readily reformat.
Next I opened the Word version in InDesign, again using File > Place. The document looks great! I took the time to customize the import preset so that my styles mapped to the Word styles coming in with the document. The hyperlinks look great -- blue color, single underline, bolded typface. There's only one problem: all of the actual link information has been stripped. Every single "hyperlink" in stunning blue in my document is a placeholder. I will have to go back and add the destination information for every one of the hundreds of links in this document.
I've gone on here at length so that anyone else using InDesign knows the headache they're in for if they ever have to transfer a document with hyperlinks into the program. I'm looking for a way around having to re-link hundreds of hyperlinks, with all the risk of error that entails. This is, IMO, yet another example of how this software is Not Ready for Primetime.
Andrew, thanks for your advice and tips. I appreciate them.
Sarah
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
