Re: [OT] Book authoring

Path	csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!aioe.org!news.stack.nl!newsfeed.xs4all.nl!newsfeed6.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path	<andrea.crotti.0@gmail.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.005
X-Spam-Evidence	'H': 0.99; 'S': 0.00; 'subject:: [': 0.02; 'python-based': 0.09; 'sphinx': 0.09; 'to:addr:comp.lang.python': 0.09; 'output': 0.10; 'am,': 0.12; 'subject:] ': 0.14; 'formats,': 0.16; 'highlighting': 0.16; 'toc': 0.16; 'cc:addr:python-list': 0.16; 'syntax': 0.16; 'examples': 0.16; 'wrote:': 0.18; 'thanks,': 0.18; 'cc:no real name:20': 0.20; 'suggest': 0.20; 'header:In- Reply-To:1': 0.22; 'somehow': 0.23; 'index': 0.24; 'code': 0.25; '(in': 0.26; 'mainly': 0.28; 'cc:addr:gmail.com': 0.28; 'depends': 0.28; 'html,': 0.29; 'problem': 0.29; 'cc:addr:python.org': 0.29; '(maybe': 0.30; 'received:mail-bw0-f46.google.com': 0.30; 'quite': 0.32; 'received:209.85.214': 0.32; 'scientific': 0.32; 'message- id:@gmail.com': 0.33; 'header:User-Agent:1': 0.33; '...': 0.36; 'cc:21': 0.36; 'but': 0.37; 'received:google.com': 0.37; 'think': 0.37; 'received:10.0.0': 0.38; 'received:209.85': 0.38; '(with': 0.39; "it's": 0.40; 'missing': 0.40; 'received:209': 0.40; 'harder': 0.64; 'greetings,': 0.66; 'automatic': 0.72; 'latex': 0.84; 'subject:Book': 0.84; 'tricky': 0.84
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=iS+zgZKdxTvvGoRgSL9Lu6HzC0ac+tCJE9kBt52souY=; b=QguyS+Lyk66hLNw+QFUw7FzYaWM1v5uE/A4J3M9W/Wifyk6z1A64BMlAmKSAiJVrIM B3VMsndEsnAKi/X7r3BU1w1RyCXSS2xxFHxR7TuHEFPGUNCYk/e2vPXOrvJR7bDgNZ0T wqo8nuD4VTykyvcBpB17hRLiVefXVF6ULbzMI=
Date	Fri, 09 Dec 2011 16:25:28 +0000
From	Andrea Crotti <andrea.crotti.0@gmail.com>
User-Agent	Mozilla/5.0 (X11; Linux x86_64; rv:8.0) Gecko/20111108 Thunderbird/8.0
MIME-Version	1.0
To	comp.lang.python@googlegroups.com
Subject	Re: [OT] Book authoring
References	<14110199.662.1323401134730.JavaMail.geo-discussion-forums@vbbeq1>
In-Reply-To	<14110199.662.1323401134730.JavaMail.geo-discussion-forums@vbbeq1>
Content-Type	text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding	7bit
Cc	python-list@python.org, Miki Tebeka <miki.tebeka@gmail.com>
X-BeenThere	python-list@python.org
X-Mailman-Version	2.1.12
Precedence	list
List-Id	General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe	<http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive	<http://mail.python.org/pipermail/python-list>
List-Post	<mailto:python-list@python.org>
List-Help	<mailto:python-list-request@python.org?subject=help>
List-Subscribe	<http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups	comp.lang.python
Message-ID	<mailman.3476.1323447934.27778.python-list@python.org> (permalink)
Lines	26
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1323447934 news.xs4all.nl 6864 [2001:888:2000:d::a6]:52600
X-Complaints-To	abuse@xs4all.nl
Xref	x330-a1.tempe.blueboxinc.net comp.lang.python:16920

Show key headers only | 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 | Next — Previous 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