: Re: What word processor is recommended for writing a technical (programming) book? I'm looking at writing a book with code samples, hints, and other stuff, and was wondering what type of word processor

You haven't specified any preferences for format (source or output), and that's going to be relevant. If it's up to you, for your source I recommend a text (not binary-format) markup language -- HTML, XML, LaTeX, or similar. A text source works well with source control, works with grep/find/search, and supports meaningful diff. All of these (assuming a reasonable XML DTD or schema like DocBook) support all the basic formatting you'll need for a programming book, including code blocks and cross-references. If you're formatting for the web then your HTML source is also your output (done!); for LaTeX or XML source or if you need to format for print (PDF), you'll need to run some sort of generator to turn your source into output.

Once you've decided on the format you can move on to choosing a tool. While WYSIWYG tools like Word and Open Office allow you to export various formats, choosing a tool that lets you write in your preferred format to begin with will be easier to manage. There are two basic categories of options:

Your favorite text editor, if you are fluent in the format to begin with. It's actually quite reasonable to write HTML directly in emacs, for example. (You probably only need to learn 10-20 tags.) Downside: no syntax-checking; you can write invalid markup and the tool won't care.
I'm not aware of LaTeX-aware editors. For HTML and XML, there are tools that help you with the syntax and make it hard or impossible to use invalid tags. Options range from inexpensive (Notepad++) to lower-cost (Oxygen) to higher-cost (Flare) to expensive (Arbortext anything). This Wikipedia page compares features among a bunch of XML editors.

As noted earlier, for LaTeX or XML source you'll need to run a program to turn your source into an output format before you can inspect the results.

Load Full (0)

: It depends, but probably you want the distributed approach where the chapter on X tells you everything you need to know about X, even if some of that is only relevant if you're using feature

@Speyer920

Load Full 0 Comments

: How to find the balance between research and the obvious I'm embarking on writing my first popular science book on a controversial subject. For sure the writing must be rational, coherent with

@Speyer920

Load Full 3 Comments

: How many names in a book are too many? It seems to me there is a relative limit for commercial fiction regarding the number of named characters. This makes sense, of course. Readers get confused;

@Speyer920

Load Full 1 Comments

: Describing laughter in dialogue? I'm having a problem that is not addressed by The Chicago Manual of Style or the AP Style Guide I have access to: How does a writer express laughter in fiction?

: Re: What word processor is recommended for writing a technical (programming) book? I'm looking at writing a book with code samples, hints, and other stuff, and was wondering what type of word processor

More posts by @Speyer920

: It depends, but probably you want the distributed approach where the chapter on X tells you everything you need to know about X, even if some of that is only relevant if you're using feature

: How to find the balance between research and the obvious I'm embarking on writing my first popular science book on a controversial subject. For sure the writing must be rational, coherent with

: How many names in a book are too many? It seems to me there is a relative limit for commercial fiction regarding the number of named characters. This makes sense, of course. Readers get confused;

: Describing laughter in dialogue? I'm having a problem that is not addressed by The Chicago Manual of Style or the AP Style Guide I have access to: How does a writer express laughter in fiction?

Login to post a comment!

0 Comments

Back to top