Reformat the list of math and trigo functions - #107
Conversation
following what was recommended during the RFC for 2.1 by msdemlei Fixes ivoa-std#93
4af0b73 to
e7fe6c3
Compare
I replaced \item[Arguments]: -> \item[Arguments:] throughout the changes; the existing formulation put the colons in a funny place in the HTML output.
mbtaylor
left a comment
There was a problem hiding this comment.
I'm not sure that this is more readable than the previous table-based formatting, but it doesn't look wrong.
|
I do not know either if it is more readable. The table version was OK according to me because more compact and still readable. |
|
However, about your commit @mbtaylor , it is "quite" OK for the HTML, but not anymore in the PDF. I put the semi-colon outside the And anyway, even with the semi-colon inside, the rendering is not that great in the HTML version. I guess one should fix the CSS for the HTML version so that definition lists look much better than that. @msdemlei , is it OK if I propose few CSS lines to fix the rendering in HTML? Should it be in ivoatex or somewhere else (I see that styles are coming from here: https://www.ivoa.net/misc/ivoa_doc.css)? |
|
An alternative would be to format the list of functions differently. Before this version, I tried with only definition lists but multiple level of such lists is apparently badly converted from tex to pdf. I also tried with only standard lists, but I did not like the rendering. If anyone has a better idea, I can try it. |
|
Sorry about that, I added some |
|
On Tue, Aug 25, 2026 at 09:36:29AM +0000, Grégory Mantelet wrote:
gmantele left a comment (ivoa-std/ADQL#107)
And anyway, even with the semi-colon inside, the rendering is not
that great in the HTML version. I guess one should fix the CSS for
the HTML version so that definition lists look much better than
that. @msdemlei , is it OK if I propose few CSS lines to fix the
rendering in HTML? Should it be in ivoatex or somewhere else (I see
that styles are coming from here:
https://www.ivoa.net/misc/ivoa_doc.css)?
ivoa_doc.css is not under ivoatex's control, but thankfully it's not
at least under version control: https://github.com/ivoa/ivoa-web,
./current-html/misc/ivoa_doc.css.
Better table rendering is certainly a good thing, so +1 from me. I'm
not sure who gets to review this right now. If you do a PR, that'll
be a good excuse for me to pester the exec about quicker ivoa-web
reviews.
|
Following the recommendation by @msdemlei during the RFC for 2.1, the tables for math and trigo functions have been converted into lists. A sub-sub-section has been added to clearly split the two lists.
Fixes #93