views:

65

answers:

3

I want to write an tutorial which I want to publish as PDF. I love Apple Pages, but unfortunately I don't see how it would support Programming Code Listings. I am sure here are a few book authors who can tell us what tools they used to create their programming books.

Well actually I think it would just be enough to have an box where I could paste in the code fragments, so that it appears in an specific style (ie fixed with font).

I tried with MS Word and it was just absolutely horrible.

+3  A: 

LaTeX is what I've used for technical writing.

My main motivations for using it over other editors is that it is good at technical notation (especially mathematical notation) and that it's free.

Daniel Lew
Why it is down voted?. I would say LaTeX is the best option for all writings.
Vinay
+1  A: 

I usually use Word, because many customers require it anyway and we have appropriate templates. If you copy code from Visual Studio, the syntax highlighting is retained and can be pasted into Word, so no problem there. And at least Microsoft's PDF/XPS plugin for Office 2007 makes for fine PDF documents. So you might not like Word, but horrible is something else :)

I especially like Office 2007's new drawing system, with styles and themes and all those fluffy designs. Makes it easy to create really great diagrams and change their style instantly.

Many technical writers, of course, use LaTeX and friends for such things. I didn't ever experience the benefits of that for my work though. If you just hate Office, you can give OpenOffice a try.

OregonGhost
+1  A: 

I have used Adobe Framemaker for all of my books. It is exceptional for writing technical material. It's template-based, so you can create a template for your code listings and they will all be formatted correctly.

Robert S.
I've heard very good things about Framemaker, but it's a lot of money to spend if you're not writing that much, so I've never tried it.
Daniel Lew
Yeah, a grand is not chump change. I justified the expense because I'm paid to write. That $1000 was easily made up in gained productivity.
Robert S.
Well, that's not an option for hobby writers like me ;)
Thanks
You should edit your question to say "free." :P
Robert S.