Page 1 of 1

Tool to create nice manuals?

Posted: Fri Jun 26, 2015 4:18 pm
by 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.

Re: Tool to create nice manuals?

Posted: Fri Jun 26, 2015 4:46 pm
by 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

Re: Tool to create nice manuals?

Posted: Fri Jun 26, 2015 10:14 pm
by Little John
thinkitsimple wrote: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.

Re: Tool to create nice manuals?

Posted: Sat Jun 27, 2015 10:15 am
by 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/

Re: Tool to create nice manuals?

Posted: Sun Jun 28, 2015 8:13 am
by 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.