From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Joshua D. Drake <jd@commandprompt.com>
Cc: Chapman Flack <chap@anastigmatix.net>
Cc: Pavel Stehule <pavel.stehule@gmail.com>
Cc: Markus Winand <markus.winand@winand.at>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: House style for DocBook documentation?
Date: Mon, 21 Jan 2019 15:18:49 -0300
Message-ID: <201901211818.24ej5vi2szvv@alvherre.pgsql> (raw)
In-Reply-To: <4ad8c028-5bd8-8837-9662-98cfa9568e15@commandprompt.com>
On 2019-Jan-21, Joshua D. Drake wrote:
> On 1/21/19 10:01 AM, Alvaro Herrera wrote:
> > 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.
>
> Yeah I could see that. I thought about that but was wondering if it was
> possible to auto cite?
Sorry, what do you mean with auto cite? Put all links at the end of the
section/chapter/book? That seems less usable to me (you have to find
out the page where the links appear, and make sure to print the right
pages)
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
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-hackers@postgresql.org
Cc: alvherre@2ndquadrant.com, jd@commandprompt.com, chap@anastigmatix.net, pavel.stehule@gmail.com, markus.winand@winand.at, tgl@sss.pgh.pa.us
Subject: Re: House style for DocBook documentation?
In-Reply-To: <201901211818.24ej5vi2szvv@alvherre.pgsql>
* 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