Re: How to import HTML document output look into a Wordor PDF?

View: New views
2 Messages — Rating Filter:   Alert me  

Re: How to import HTML document output look into a Wordor PDF?

by Selke, Gisbert W. :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

> -----Ursprüngliche Nachricht-----
> Von: Ed Sutton [mailto:ESutton@...]
> Gesendet: Dienstag, 13. Oktober 2009 22:31
> I love the look of the HTML documentation output generated
> from my C++ source code.  I love  the way each member
> function is documented in it's own shaded table with the
> rounded corners.
>
> Unfortunately, importing the RTF output into Word removes all
> the pretty formatting.  Has  anyone tips on how to make a
> Microsoft Word or PDF document that looks more like the HTML?
Personally, I don't use RTF/Word (for a bunch of reasons). However, it seems that the configuration option RTF_STYLESHEET_FILE should be a place to configure the RTF output to your needs.

If you're not interested in a Word-editable document, I would suggest using LaTeX for creating PDF. Out of the box, it has no fancy formatting, but you can tailor that with either the EXTRA_PACKAGES or with the LATEX_HEADER config option. (This assumes some familiarity with LaTeX, but it is probably cleaner than messing around withRTF.)

\Gisbert

------------------------------------------------------------------------------
Come build with us! The BlackBerry(R) Developer Conference in SF, CA
is the only developer event you need to attend this year. Jumpstart your
developing skills, take BlackBerry mobile applications to market and stay
ahead of the curve. Join us from November 9 - 12, 2009. Register now!
http://p.sf.net/sfu/devconference
_______________________________________________
Doxygen-users mailing list
Doxygen-users@...
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Re: How to import HTML document output look into a Wordor PDF?

by Ed of the Mountain :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

On Oct 13, 2009, at 4:25 PM, Selke, Gisbert W. wrote:

>> -----Ursprüngliche Nachricht-----
>> Von: Ed Sutton [mailto:ESutton@...]
>> Gesendet: Dienstag, 13. Oktober 2009 22:31
>> I love the look of the HTML documentation output generated
>> from my C++ source code.  I love  the way each member
>> function is documented in it's own shaded table with the
>> rounded corners.
>>
>> Unfortunately, importing the RTF output into Word removes all
>> the pretty formatting.  Has  anyone tips on how to make a
>> Microsoft Word or PDF document that looks more like the HTML?
> Personally, I don't use RTF/Word (for a bunch of reasons). However,  
> it seems that the configuration option RTF_STYLESHEET_FILE should be  
> a place to configure the RTF output to your needs.
>
> If you're not interested in a Word-editable document, I would  
> suggest using LaTeX for creating PDF. Out of the box, it has no  
> fancy formatting, but you can tailor that with either the  
> EXTRA_PACKAGES or with the LATEX_HEADER config option. (This assumes  
> some familiarity with LaTeX, but it is probably cleaner than messing  
> around withRTF.)
>
> \Gisbert


Thank you for your reply.

Unfortunately I do not feel I have any choice regarding Word. My  
company is obsessed with  creating Word documents for everything.  
Personally, if I was an end user  of the API documentation I create  
for the libraries I develop, I would  much prefer to have the Doxygen  
HTML output.

It sounds like learning LaTex or figuring out how to configure the  
RTF  to look more like the HTML output could be a career in itself and
either approach may may not succeed. I guess I choose to  
procrastinate. :-)

Thank you very much for your advice!

-Ed
------------------------------------------------------------------------------
Come build with us! The BlackBerry(R) Developer Conference in SF, CA
is the only developer event you need to attend this year. Jumpstart your
developing skills, take BlackBerry mobile applications to market and stay
ahead of the curve. Join us from November 9 - 12, 2009. Register now!
http://p.sf.net/sfu/devconference
_______________________________________________
Doxygen-users mailing list
Doxygen-users@...
https://lists.sourceforge.net/lists/listinfo/doxygen-users