Skip to content

Reformat the list of math and trigo functions - #107

Open
gmantele wants to merge 4 commits into
ivoa-std:mainfrom
gmantele:issue-93-reformat-list-of-math-functions
Open

Reformat the list of math and trigo functions#107
gmantele wants to merge 4 commits into
ivoa-std:mainfrom
gmantele:issue-93-reformat-list-of-math-functions

Conversation

@gmantele

Copy link
Copy Markdown
Collaborator

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

@gmantele gmantele self-assigned this Aug 18, 2026
@gmantele gmantele added the enhancement New feature or request label Aug 18, 2026
following what was recommended during the RFC for 2.1 by msdemlei

Fixes ivoa-std#93
@gmantele
gmantele force-pushed the issue-93-reformat-list-of-math-functions branch from 4af0b73 to e7fe6c3 Compare August 19, 2026 08:40
gmantele and others added 2 commits August 19, 2026 10:41
I replaced \item[Arguments]: -> \item[Arguments:] throughout
the changes; the existing formulation put the colons in a
funny place in the HTML output.
mbtaylor
mbtaylor previously approved these changes Aug 25, 2026

@mbtaylor mbtaylor left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure that this is more readable than the previous table-based formatting, but it doesn't look wrong.

@gmantele

Copy link
Copy Markdown
Collaborator Author

I do not know either if it is more readable. The table version was OK according to me because more compact and still readable.

@gmantele

Copy link
Copy Markdown
Collaborator Author

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 \item[...] because of this. When it is outside, it looks great in the PDF.

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)?

@gmantele

Copy link
Copy Markdown
Collaborator Author

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.

@mbtaylor

Copy link
Copy Markdown
Member

Sorry about that, I added some \mbox{}s to fix up the PDF rendering again, I'd say it's now better than a couple of commits ago in both PDF and HTML. However if you want to either back out of either/both of my commits or back out of this PR altogether and go back to tables or do some other formatting, that's fine by me.

@msdemlei

msdemlei commented Aug 25, 2026 via email

Copy link
Copy Markdown
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Reformat list of math functions

3 participants