| From: | Alvaro Herrera <alvherre(at)2ndquadrant(dot)com> |
|---|---|
| To: | Chapman Flack <chap(at)anastigmatix(dot)net> |
| Cc: | Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com>, Markus Winand <markus(dot)winand(at)winand(dot)at>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org> |
| Subject: | Re: House style for DocBook documentation? |
| Date: | 2019-01-21 18:01:36 |
| Message-ID: | 201901211801.sqxe6hoejajg@alvherre.pgsql |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On 2019-Jan-21, Chapman Flack wrote:
> But the point's well taken that in /printed output/, that's of no use.
> Which is, in a sense, an inconsistency: in one format, you can follow the
> links, while in another, you're out of luck.
>
> Maybe a simpler transform for printed output, rather than collecting
> all URLs into one section at the back, would just be to follow any
> <ulink> that has link text with a <footnote> containing the same ulink
> without the link text, so it shows the URL, and that would be right at
> the bottom of the same 'page'.
Of course, the text would also be clickable, right? I think putting the
URL in a footnote is good in that case; it works both on screen and on
paper, which should alleviate JD's concerns.
> I wouldn't think it important to apply the same treatment when making HTML.
Right, only PDF.
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Chapman Flack | 2019-01-21 18:11:11 | Re: House style for DocBook documentation? |
| Previous Message | Alvaro Herrera | 2019-01-21 17:58:39 | Re: Simplify set of flags used by MyXactFlags |