Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.python > #16917

Re: [OT] Book authoring

From Grant Edwards <invalid@invalid.invalid>
Newsgroups comp.lang.python
Subject Re: [OT] Book authoring
Date 2011-12-09 15:13 +0000
Organization PANIX Public Access Internet and UNIX, NYC
Message-ID <jbt8ja$qp7$1@reader1.panix.com> (permalink)
References <14110199.662.1323401134730.JavaMail.geo-discussion-forums@vbbeq1>

Show all headers | View raw


On 2011-12-09, Miki Tebeka <miki.tebeka@gmail.com> wrote:
> Greetings,
>
> Any recommendations for a book authoring system that supports the following:
> 1. Code examples (with syntax highlighting and line numbers)
> 2. Output HTML, PDF, ePub ...
> 3. Automatic TOC and index
> 4. Search (in HTML) - this is a "nice to have"

http://en.wikipedia.org/wiki/Lightweight_markup_language

I've used asciidoc extensively and reStructuredText a little. Asciidoc
will produce all the formats you mentioned (though I've only refularly
used HTML and PDF). reStructuredText is what's used for Python docs
isn't it?

> Can I somehow use Sphinx?

Don't know what Sphinx is.

And there's always the old stand-by LaTeX, but it's a bit more
heavyweight with more of a learning curve.  OTOH, it does produce
text-book quality output.

-- 
Grant Edwards               grant.b.edwards        Yow! BELA LUGOSI is my
                                  at               co-pilot ...
                              gmail.com            

Back to comp.lang.python | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

[OT] Book authoring Miki Tebeka <miki.tebeka@gmail.com> - 2011-12-08 19:25 -0800
  Re: [OT] Book authoring Grant Edwards <invalid@invalid.invalid> - 2011-12-09 15:13 +0000
    Re: [OT] Book authoring Nick Dokos <nicholas.dokos@hp.com> - 2011-12-09 10:43 -0500
    Re: [OT] Book authoring Nick Dokos <nicholas.dokos@hp.com> - 2011-12-09 11:18 -0500
  Re: [OT] Book authoring Andrea Crotti <andrea.crotti.0@gmail.com> - 2011-12-09 16:25 +0000

csiph-web