Is there an solution for writing hybrid documentations and guides?

Question

We need something pretty exactly the same as Apple has got. When we write a documentation or guide for our framework users, we want to write all the text just once, but then drop it out to the web server as HTML version and at the same time also create a PDF out of it for the users who wish to download it as PDF.

Maybe there are good solutions already which are made just perfectly for this sort of thing?

Answer 1

Rdocs! If you are using Ruby! http://rdoc.sourceforge.net/

But another good solution is make a wordpress blog and style it like nicley formatted docs would be, then use PrinceXML to create a beautifully formatted PDF! That's what we do.

Here is a link http://princexml.com/

Answer 2

Writing Technical Documentation with Sphinx, Paver, and Cog by Doug Hellmann describes possible workflow.