Re: Documentation epub format

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


>> 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.

Indeed, iBooks computes page numbers, which mean processing the whole
contents.

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

That at least would be a relief. The TOC on iBooks is shown as a very long
scrolling window, without collapsable parts.

--
Fabien.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2013-05-03 13:30:53 Re: Documentation epub format
Previous Message Fabien COELHO 2013-05-03 05:57:07 Re: Documentation epub format

Browse pgsql-hackers by date

  From Date Subject
Next Message Cédric Villemain 2013-05-03 11:02:08 Re: Recovery target 'immediate'
Previous Message Fabien COELHO 2013-05-03 05:57:07 Re: Documentation epub format