Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Visibility function glyph not rendered in PDF #2401

Closed
emackey opened this issue May 20, 2024 · 3 comments · Fixed by #2403
Closed

Visibility function glyph not rendered in PDF #2401

emackey opened this issue May 20, 2024 · 3 comments · Fixed by #2403
Milestone

Comments

@emackey
Copy link
Member

emackey commented May 20, 2024

In section B.3.2, following #2386 and #2400, there is a glyph that renders in HTML but not in PDF.

Here's a screenshot of Specification.html:

good screenshot

And here's Specification.pdf:

image

@lexaknyazev lexaknyazev added this to the 2.0.x milestone May 20, 2024
@emackey
Copy link
Member Author

emackey commented May 20, 2024

@oddhack Do you happen to know any quick fix for the missing glyph here? Asciidoc source is:

Introducing the visibility function latexmath:[\mathcal{V}]

@oddhack
Copy link
Contributor

oddhack commented May 21, 2024

It is not trivial. The font used by asciidoctor-pdf when rendering math is (intentionally) incomplete - see asciidoctor/asciidoctor-pdf#1832 and related PR asciidoctor/asciidoctor-pdf#1864, wherein I got them to add the special characters needed by Vulkan to the distributed font. That took several months (some of it taken up by a long digression into licensing issues, which are resolved now), and in the meantime I was building my own fallback font with the additional characters included for use in the Vulkan build.

You could open an issue about this on their repo - it is a very small change to the build script once you know the needed Unicode value - but TBH you are probably better off just using a different character that's already in the PDF font. Maybe Greek nu (ν)? I infer the problem arose when noticing that 'V' was being used for two different things in that equation so the actual LHS is probably pretty arbitrary.

@emackey
Copy link
Member Author

emackey commented May 22, 2024

@oddhack Thanks as always for the insights into the documentation mechanics here, it's much appreciated!

@emackey emackey linked a pull request May 22, 2024 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants