pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Fabien COELHO <coelho@cri.ensmp.fr>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: PostgreSQL Developers <pgsql-hackers@postgresql.org>
Subject: Re: Documentation epub format
Date: Fri, 3 May 2013 08:05:28 +0200 (CEST)
Message-ID: <alpine.DEB.2.02.1305030757310.9292@localhost6.localdomain6> (raw)
In-Reply-To: <1367550999.25798.4.camel@vanquo.pezone.net>
References: <alpine.DEB.2.02.1305011144590.25330@localhost6.localdomain6>
	<1367550999.25798.4.camel@vanquo.pezone.net>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-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.


-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers



view thread (29+ messages)  latest in thread

Message-ID: <alpine.DEB.2.02.1305030757310.9292@localhost6.localdomain6>
Permalink:  ../alpine.DEB.2.02.1305030757310.9292@localhost6.localdomain6/
Also on:    postgresql.org/message-id/alpine.DEB.2.02.1305030757310.9292@localhost6.localdomain6

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: coelho@cri.ensmp.fr, peter_e@gmx.net, pgsql-hackers@postgresql.org
  Subject: Re: Documentation epub format
  In-Reply-To: <alpine.DEB.2.02.1305030757310.9292@localhost6.localdomain6>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox