Re: proposal: convert comments in documents to html comments - Mailing list pgsql-docs

From Noboru Saito
Subject Re: proposal: convert comments in documents to html comments
Date
Msg-id CAAM3qn+QtUWDZWbiM895b70YSttm+_UkUK=WjxAsh4ou-QMDhQ@mail.gmail.com
Whole thread Raw
In response to Re: proposal: convert comments in documents to html comments  (Alvaro Herrera <alvherre@alvh.no-ip.org>)
Responses Re: proposal: convert comments in documents to html comments  (Michael Paquier <michael@paquier.xyz>)
List pgsql-docs
If you want to separate hashes or add links,
I think it would be better to stop the current comment and make it a paragraph
(I think it is possible to keep them folded
 when converted to html even if they are paragraphs).
I agree with doing it that way, but it may not be possible right away.

Html comments can be a little more convenient with little effort.

2022年6月27日(月) 17:48 Alvaro Herrera <alvherre@alvh.no-ip.org>:
>
> 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)



pgsql-docs by date:

Previous
From: Laurenz Albe
Date:
Subject: Re: Remove recommendation for nightly VACUUM
Next
From: Michael Paquier
Date:
Subject: Re: proposal: convert comments in documents to html comments