Re: The beauty of LATEX
"Robert Ramey" <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
Joel de Guzman wrote: > Thoughts? Please, I don't need another "just use XXX or YYY > instead of Quickbook" answer. As its original author, I too > love Quickbook. For a project I'm currently working on I was very much interested in getting a good system for making documents. The list of things I wanted was a) a system which which separated the content from the formating. b) could be used to generate a variety of output formats including pdf, epub, html, and maybe windows help files. c) include some more or less easy way to edit the files and get an idea how the content would look when formatted. d) some sort of scripting so I could make a "form filling" setup like - function call, name, arg1, ... and have it generate the appropriate text. I considered different options 1) In the long ago passed I used nroff to do this by implementing a bunch of macros. This gave me a) and d) 2) I took a look at Latex - but it seemed to me that it failed to give me a), b), c). I don't remember about d) 3) MS Word - this program drives me absolutely crazy. That was more than enough reason to stay away from it. It would have given me c) 4) Quickbook gave me a), some of b) (pdf). I liked the tersness of it - but running the tool chain was very fragil for me. When it worked - great - but when it failed I had to delve into bjam script files - a place where I've never felt at home. Also it seemed too focused on boost documentation and what I really wanted was to try my hand at my new book whose working title is "Boost Brew" 5) I looked at DocBook (4/5). This gave me a), b). It is well supported by publishers. Editing xml that doc book uses is toture so I didn't have c). BUT, I came up XMLMind which is an XML editor with configuration files for DocBook. This means I can edit in a WSIWYG way and it generates/maintains the xml tree in another pane. Actually, you never have to even look at the other pane. So This addressed c) I should note that becomming accustomed to using XML mind did take some effort - but after you get over the hump you're in a pretty good place. Coupled with some good links like XML the definitive reference you're in business. I still don't get d) - oh well. Robert Ramey