Re: Documentation epub format

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>
Cc: PostgreSQL Developers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Documentation epub format
Date: 2013-05-03 03:16:39
Message-ID: 1367550999.25798.4.camel@vanquo.pezone.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Wed, 2013-05-01 at 18:27 +0200, Fabien COELHO wrote:
> The table of contents too much detailed, so it is long and slow to
> scan, and there is no clear shortcut. Flipping pages in the
> documentation takes ages (well, close to one second or more if I flip
> a few pages). Do not try "search".

EPUB is essentially a zip file with per-section simplified HTML files.
So any device that can render simple web pages should be able to handle
that with ease. What I think iBooks is doing is it internally
pre-renders all the pages in order to be able to attach page numbers to
all the table of contents entries. I suspect other readers that don't
do that will be able to handle this better.

That said, I think trimming down the table of contents nesting depth
might be worth checking into for this output format.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Gavin Flower 2013-05-03 04:00:12 Re: Documentation epub format
Previous Message Andrew Dunstan 2013-05-02 07:42:33 Re: Documentation epub format

Browse pgsql-hackers by date

  From Date Subject
Next Message Gavin Flower 2013-05-03 04:00:12 Re: Documentation epub format
Previous Message Tom Lane 2013-05-03 03:02:48 Re: GSOC13 proposal - extend RETURNING syntax