pdf versus single-html
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
Erik Rijkers <er@xs4all.nl> 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
On 2017-01-21 17:12, Tom Lane wrote:
Erik Rijkers <er@xs4all.nl> 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
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