Re: House style for DocBook documentation?

Поиск
Список
Период
Сортировка
От Alvaro Herrera
Тема Re: House style for DocBook documentation?
Дата
Msg-id 201901211801.sqxe6hoejajg@alvherre.pgsql
обсуждение исходный текст
Ответ на Re: House style for DocBook documentation?  (Chapman Flack <chap@anastigmatix.net>)
Ответы Re: House style for DocBook documentation?  ("Joshua D. Drake" <jd@commandprompt.com>)
Список 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


В списке pgsql-hackers по дате отправления:

Предыдущее
От: Alvaro Herrera
Дата:
Сообщение: Re: Simplify set of flags used by MyXactFlags
Следующее
От: Chapman Flack
Дата:
Сообщение: Re: House style for DocBook documentation?