From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Noboru Saito <noborusai@gmail.com>
Cc: Peter Geoghegan <pg@bowt.ie>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Michael Paquier <michael@paquier.xyz>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: proposal: convert comments in documents to html comments
Date: Mon, 27 Jun 2022 10:48:39 +0200
Message-ID: <20220627084839.5fuankjxgt6m62vv@alvherre.pgsql> (raw)
In-Reply-To: <CAAM3qnJDsT6y6t7KY=0VCtrG=uQtNuBdhiUk3vor530WbpPsFA@mail.gmail.com>
On 2022-Jun-27, Noboru Saito wrote:
> > I don't have much of a clue about our docbook toolchain, beyond the
> > basics (plus I have no front-end experience). Is anybody else aware of
> > a reasonable approach to making git hashes discoverable from the html
> > release notes?
>
> If you simply want to display it with a tooltip, the attached patch
> can do that.
>
> I also attach html and css.
> Please do not expect the quality of the css,
> as it was created for the purpose of checking the operation.
I like the idea of making the commits unobtrusively visible in the
output page. This proposal looks a good step forward, but I'm sure we
can improve a little bit more. For example, can we make the SHA1 hash
for each commit be a link to the gitweb page? (Does this require
pattern matching in the XLST rule?) Also, when there's more than one
commit in one entry, it'd be better to have them on separate lines
rather than run together in a single line.
Thanks!
--
Álvaro Herrera Breisgau, Deutschland — https://www.EnterpriseDB.com/
"Linux transformó mi computadora, de una `máquina para hacer cosas',
en un aparato realmente entretenido, sobre el cual cada día aprendo
algo nuevo" (Jaime Salinas)
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-docs@postgresql.org
Cc: alvherre@alvh.no-ip.org, noborusai@gmail.com, pg@bowt.ie, tgl@sss.pgh.pa.us, michael@paquier.xyz, pgsql-docs@lists.postgresql.org
Subject: Re: proposal: convert comments in documents to html comments
In-Reply-To: <20220627084839.5fuankjxgt6m62vv@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