Tool to create nice manuals?

[thinkitsimple]

Hi,

i want to create a nice looking pdf-manual with index and code blocks inside. I know how to create an index of my headlines e.g in Writer or Word, but how to place the code blocks in there, so that they are well formatted?

Are there any special tools for that?

I'm using a Mac.

[HanPBF]

hello Michael,

http://alternativeto.net/software/help-manual/


Lookup "XML Documentation" at search engine.

Oxygen is a JAVA based XML Editor with various output formats:
http://www.oxygenxml.com/doc/versions/1 ... ormat.html

[Little John]

but how to place the code blocks in there, so that they are well formatted?

Use a fixed-width font such as Courier New or Consolas, and indent the lines like the PB IDE does after pressing [Ctrl]+.
Additionally, you can e.g. draw a frame around each code block, and/or give the code blocks a special background color.

[IdeasVacuum]

You could use a desktop publisher that saves to PDF (Free):
http://www.serif.com/desktop-publishing ... tAodnYkOEg

...or maybe make an 'old fashioned' .hlp file:
http://shalom-help-maker-shm.en.softonic.com/

[thinkitsimple]

Thanks for your suggestions.

After a while i found Clarify, the successor of ScreenSteps. I does what i was looking for, for me the ideal solution to write manuals or documentation. Makes it a lot easier to write these stuff than other "solutions" like Word or OpenOffice/LibreOffice. It's available for Windows and Mac.