Re: [HACKERS] pdf versus single-html

2017-01-25 Thread Peter Eisentraut 
On 1/21/17 6:29 AM, Erik Rijkers wrote:
> It might even be good to include such a single-file html in the Makefile 
> as an option.
> 
> I'll give it a try but has anyone done this work already, perhaps?

Already exists:

doc/src/sgml$ make postgres.html

-- 
Peter Eisentraut  http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


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

Re: [HACKERS] pdf versus single-html

2017-01-21 Thread Erik Rijkers 

On 2017-01-21 17:12, Tom Lane wrote:

Erik Rijkers  writes:

With the pdf increasingly in readability-decline (more and more text
parts fall off the (right) side of the page and quite a few tables
contain unreable bits) I would like to have a single page html.


Given the size of our manual, I find it hard to believe that most
readers would perform acceptably with that ... have you tried just
concatenating all the parts manually and testing performance?



Yes, id did a straightforward concatenation; and it's really not a 
problem: it comes to a 15 MB file (12 MB when skipping the release 
pages).  Either size (in standard firefox) takes some time (seconds) but 
scrolling and searching is no problem.


Maybe I wasn't clear: I wouldn't argue to make single-file the default 
output, of course; just an option to choose if it's at all possible.


And even if such an option isn't deemed feasible I was hoping that 
someone more xslt-knowledgeable than I am has some hints on how to 
produce a single html file in the correct order and with link correctly 
(self-)referencing.


I might figure it out myself - in that case will post here.

thanks,

Erik Rijkers





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

Re: [HACKERS] pdf versus single-html

2017-01-21 Thread Tom Lane 
Erik Rijkers  writes:
> With the pdf increasingly in readability-decline (more and more text 
> parts fall off the (right) side of the page and quite a few tables 
> contain unreable bits) I would like to have a single page html.

Given the size of our manual, I find it hard to believe that most
readers would perform acceptably with that ... have you tried just
concatenating all the parts manually and testing performance?

regards, tom lane


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

[HACKERS] pdf versus single-html

2017-01-21 Thread Erik Rijkers 

Hi,

With the pdf increasingly in readability-decline (more and more text 
parts fall off the (right) side of the page and quite a few tables 
contain unreable bits) I would like to have a single page html. (cf the 
bash scipting guide at http://tldp.org/guides.html  even if that is 
smaller than our html (2.3 MB vs 12 MB))


Simple concatenation is trivial but to keep the texts in the correct 
order, and to keep the links working is a bit more complicated.


Ideally I'd like a single file with chapter-headings either at the top 
or even (gulp) in a left-hand frame.


The goal is to make the text directly searchable, like one can do in the 
pdf.


It might even be good to include such a single-file html in the Makefile 
as an option.


I'll give it a try but has anyone done this work already, perhaps?

Thanks,

Erik Rijkers




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