Re: [OT] Book authoring

Path	csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!weretis.net!feeder1.news.weretis.net!feeder.erje.net!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path	<wescpy@gmail.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.000
X-Spam-Evidence	'H': 1.00; 'S': 0.00; 'subject:: [': 0.02; 'europython': 0.03; 'url:europython': 0.03; 'hall,': 0.07; 'url:ep2011': 0.07; 'python': 0.08; '(it': 0.09; 'foo': 0.09; 'prentice': 0.09; 'sits': 0.09; 'sphinx': 0.09; 'output': 0.10; 'subject:] ': 0.14; '"python': 0.15; 'entries': 0.15; 'url:org)': 0.15; 'curve.': 0.16; 'highlighting': 0.16; 'imo,': 0.16; 'nick': 0.16; 'sucks': 0.16; 'toc': 0.16; 'url:conference': 0.16; 'url:corepython': 0.16; 'url:pocoo': 0.16; 'url:sphinx': 0.16; 'url:talks': 0.16; 'received:74.125.82.44': 0.16; 'received:mail- ww0-f44.google.com': 0.16; 'syntax': 0.16; 'examples': 0.16; 'wrote:': 0.18; 'cheers,': 0.20; 'dec': 0.22; 'required.': 0.23; '(though': 0.23; 'extensively': 0.23; 'indexing': 0.23; 'silicon': 0.23; 'somehow': 0.23; 'index': 0.24; 'code': 0.25; '(in': 0.26; "i'm": 0.26; 'books': 0.27; 'somebody': 0.28; 'bit': 0.28; 'message-id:@mail.gmail.com': 0.28; 'html,': 0.29; 'url:wiki': 0.29; '(the': 0.30; "i've": 0.31; 'source': 0.31; 'does': 0.32; 'url:eu': 0.32; "isn't": 0.33; 'actually': 0.33; 'there': 0.33; 'it?': 0.33; 'to:addr:python-list': 0.34; 'latter': 0.34; 'skip:@ 10': 0.34; 'received:74.125.82': 0.35; 'regular': 0.35; '...': 0.36; 'thread': 0.37; 'but': 0.37; 'technical': 0.37; 'received:74.125': 0.37; 'received:google.com': 0.37; "there's": 0.37; 'think': 0.37; 'some': 0.38; 'couple': 0.38; 'url:en': 0.39; 'talk': 0.39; 'url:org': 0.39; '(with': 0.39; "it's": 0.40; 'raw': 0.40; 'to:addr:python.org': 0.40; 'more': 0.61; 'training': 0.62; 'greetings,': 0.66; 'details.': 0.72; 'automatic': 0.72; 'quality': 0.75; 'slide': 0.84; 'studies.': 0.84; 'subject:Book': 0.84; '\xa0but': 0.84; 'edwards': 0.91; 'subject,': 0.91
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:from:date:message-id:subject:to:content-type :content-transfer-encoding; bh=2aKdrRZYN8t9Q1sS708lfwaLtomj9iLlcLMjVZCXlrA=; b=aXmmdOaCXvu/5kNPpvwD7i+TR/9OzHi3ogOw3tgrQiA5vTzCZ6F3NPb4KjCjislbwI Dy5aC6pWw45OEJdv1ql55E1d4hH+v1h+/AfqfTdoI9FGNbKauPigyQsbJ9Ix5L7QZdLM qeI3nshVDSzSnXO+EbBoBRBm3vtWWlq0jlcsI=
MIME-Version	1.0
From	wesley chun <wescpy@gmail.com>
Date	Tue, 3 Jan 2012 14:34:16 -0800
Subject	Re: [OT] Book authoring
To	python-list@python.org
Content-Type	text/plain; charset=ISO-8859-1
Content-Transfer-Encoding	quoted-printable
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.4390.1325630079.27778.python-list@python.org> (permalink)
Lines	64
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1325630079 news.xs4all.nl 6938 [2001:888:2000:d::a6]:53997
X-Complaints-To	abuse@xs4all.nl
Xref	x330-a1.tempe.blueboxinc.net comp.lang.python:18461

Show key headers only | View raw

fwiw, i've given a related talk a couple of times on this subject, the
most recent of which was at EuroPython this summer:
http://ep2011.europython.eu/conference/talks/writing-books-using-python-open-source-software

the content includes a couple of the tools mentioned in this thread as
well as some author case studies. slide deck's available there too.

cheers,
--wesley


On Dec 9 2011, 7:43 am, Nick Dokos <nicholas.do...@hp.com> wrote:
> Grant Edwards <inva...@invalid.invalid> wrote:
> > On 2011-12-09, Miki Tebeka <miki.teb...@gmail.com> wrote:
> > > Greetings,
>
> > > Any recommendations for abook authoringsystem 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.
>
> I think Sphinx is used for the python docs: it sits atop rST and does
> all the transformations/processing to produce the desired output
> (http://sphinx.pocoo.org)
>
> > 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.
>
> There is also orgmode, which has been used for a few books
> (http://orgmode.org). I know it does HTML and PDF (the latter through
> latex), but I'm not sure about ePub: ISTR somebody actually did ePub for
> his book but I don't remember details. The indexing is manual:
> add #+index: foo entries as required.  But in general, imo, automatic
> indexing for books sucks raw eggs (it works much better for highly
> regular source code like the python source base).
>
> Nick


-- 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
"Core Python", Prentice Hall, (c)2007,2001
"Python Fundamentals", Prentice Hall, (c)2009
    http://corepython.com

wesley.chun : wescpy-gmail.com : @wescpy/+wescpy
python training and technical consulting
cyberweb.consulting : silicon valley, ca
http://cyberwebconsulting.com

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

Thread

Re: [OT] Book authoring wesley chun <wescpy@gmail.com> - 2012-01-03 14:34 -0800
  Re: Book authoring Peter <peter.milliken@gmail.com> - 2012-01-03 15:34 -0800

csiph-web