Re: Please provide stable target anchors

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Daniele Varrazzo <daniele(dot)varrazzo(at)gmail(dot)com>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Please provide stable target anchors
Date: 2010-07-08 18:09:50
Message-ID: 1278612590.25038.2.camel@vanquo.pezone.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On tor, 2010-07-08 at 15:54 +0100, Daniele Varrazzo wrote:
> In psycopg documentation I've often referenced specific parts of
> PostgreSQL docs, e.g. libpq functions, using the anchors found in the
> html docs (see [1] for example). Unfortunately these anchors are not
> stable and the ones I've linked to have changed, leaving half-broken
> links referring to the correct page but to not existing fragments ([2]
> for the example above).

If you can tell us which places you want to link to, we can make stable
anchors.

> The html anchors seem generated from the <indexterm> tags in the sgml
> documentation. Would it be possible to generate stable anchors for
> these targets, e.g. "slugifying" the content of the <primary> tag
> contained in them?

No, the anchors are made from the id attributes. But if there is no id
attribute, the toolchain generates an identifier for the anchor, which
is some number that is obviously not stable. The fix is then to put
id's into these places.

> Uhm... looking at the currently published html doc, it seems there is
> a problem: the index [3] doesn't use these anchors at all. See for
> example the entries for any libpq function.

I'm not sure I'm seeing what you're seeing. Could you provide examples?

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Erik Rijkers 2010-07-08 18:49:25 plperl.sgml touches
Previous Message Tom Lane 2010-07-08 16:31:03 Re: CREATE OPERATOR and precedence