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


Groups > comp.lang.python > #16920

Re: [OT] Book authoring

Date 2011-12-09 16:25 +0000
From Andrea Crotti <andrea.crotti.0@gmail.com>
Subject Re: [OT] Book authoring
References <14110199.662.1323401134730.JavaMail.geo-discussion-forums@vbbeq1>
Newsgroups comp.lang.python
Message-ID <mailman.3476.1323447934.27778.python-list@python.org> (permalink)

Show all headers | View raw


On 12/09/2011 03:25 AM, Miki Tebeka 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"
>
> Can I somehow use Sphinx?
>
> Thanks,
> --
> Miki

I think it depends on what you want exactly.
If it's a nice book with a scientific look and many complicated 
tables/figures
than I think that LaTeX is the way to go (maybe even org-mode but it's 
mainly
for emacs-fans).

The problem with LaTeX is that it's quite tricky to export to other 
formats, harder
to learn and not as flexible as a python-based solution as Sphinx.
I would suggest to try Sphinx and see if you're missing something..

Back to comp.lang.python | Previous | NextPrevious 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