OT: ebook, print documentation tools

[Ian Petersen]

On Tue, Sep 29, 2009 at 12:08 AM, Rajinder Yadav <devguy.ca-Re5JQEeQqe8AvxtiuMwx3w at public.gmane.org> wrote:
> Ian Petersen wrote:
>>
>> On Sun, Sep 27, 2009 at 9:32 PM, Christopher Browne <cbbrowne-Re5JQEeQqe8AvxtiuMwx3w at public.gmane.org>
>> wrote:
>>>
>>> The last time I was working on a book (it's gone astray, due to
>>> collaborators being too busy for completion...), we were using Lyx
>>> <http://www.lyx.org/>.
>>>
>>> Lyx is pretty suitable for *not* encouraging bad habits surrounding
>>> engagement in physical layout.
>>>
>>> And it can generate a reasonable variety of output formats...
>>
>> I'll second Lyx.  I've never written anything so ambitious as a book,
>> but I used Lyx to take notes in the second half of university so I've
>> spent a lot of time with it.  The printed output is _very_ pleasing to
>> the eye.  Also, the tool itself is really nice--it lets you focus on
>> the content and structure of the document and takes care of all the
>> messy formatting for you.  I'm not sure what kind of web-friendly
>> output you can generate, but you might be able to convert the LaTeX,
>> PDF, or PostScript output to HTML using some sort of filter.  Also, if
>> your book has even the slightest whiff of math in it, you can't beat
>> the equation editor in Lyx.
>
> By any chance would you know how I could add source code and make it look
> good? My Ruby script snippets doesn't look too hot.

It's been ages so no, I don't remember.  I think I did something like
store the source in an external text file and include it in a verbatim
section, or something, but that's a very fuzzy memory.  When you have
the time to read the manual, do so--it's really good and it's written
as a Lyx document so you can see how they did everything.

Ian
--
The Toronto Linux Users Group.      Meetings: http://gtalug.org/
TLUG requests: Linux topics, No HTML, wrap text below 80 columns
How to UNSUBSCRIBE: http://gtalug.org/wiki/Mailing_lists