Documenter.jl: Unicode โˆ€, โˆƒ etc. missing in with Roboto Mono in the PDF

Created on 17 Aug 2018  ยท  8Comments  ยท  Source: JuliaDocs/Documenter.jl

I suggest changing the monospace font used by the PDF documentation, so the special Unicode strings displayed in e.g. Manual -> Strings -> Unicode and UTF-8.

LaTeX Enhancement

Most helpful comment

I don't think Fira Code would be a good choice. While the ligatures are pretty neat, I quite strongly feel that they would confuse the average user who is not familiar with the ligature monospaced fonts. And I don't think there's a way to suppress that feature of the font.

Everson Mono is proprietary unfortunately. Source Code Pro showed up on the fileformat.info page though.

All 8 comments

Good catch.. Roboto really doesn't have very good Unicode coverage.. related to #618. Would welcome suggestions for what to replace it with though (that would also be freely available cross-platform).

How about the Fira Code? It does support โˆ€ and โˆƒ, and a bunch of other purely mathematical symbols and it is created specifically for a nice output of the source code. It also comes with interesting ligatures (e.g. converting -> into โ†’) that I understand you might not like in a language manual, but perhaps there is a way to suppress them? Don't bother with Fira Mono, on which Fira Code is based, though. It does not include mathematical symbols.

Another option is Everson Mono. It contains virtually every Unicode character.

To make a more informed decision, you might want to take a look at the list of all the fonts on the fileformat.info server, that support a given character (e.g. โˆ€: http://www.fileformat.info/info/unicode/char/2200/fontsupport.htm), and choose those fonts, that have mono in its name.

I don't think Fira Code would be a good choice. While the ligatures are pretty neat, I quite strongly feel that they would confuse the average user who is not familiar with the ligature monospaced fonts. And I don't think there's a way to suppress that feature of the font.

Everson Mono is proprietary unfortunately. Source Code Pro showed up on the fileformat.info page though.

I'm not sure if it's a good way to check, but I tried pasting the characters โˆ€โœ“โŠปโŠ— into the sample text box on all the Google monospace fonts:

Support all except the โœ“:

Support all except โŠป

If the result is not too jarring, one option might be to layer several monospace fonts to get better coverage of the different symbols?

Actually, the โœ“ doesn't need to be monospace, so we could also pick one without that.

~A small clarifying question here: with the current font setup, are the Unicode characters actually not being displayed for you? @adamryczkowski you linked to Strings / Unicode and UTF-8 page as an example in the OP. If yes, what browser and OS is that on?~

Scratch that -- I just realized that this issue was about the PDF docs, not the HTML front end.

So, my current approach is to switch to the DejaVu fonts (#1066) -- the headings don't look as pretty as they could necessarily, but I would say that not having missing characters is more important.

If someone wants to look into changing the build to XeTeX though, that might allow us to have more control over the fonts.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

asinghvi17 picture asinghvi17  ยท  3Comments

jonathan-laurent picture jonathan-laurent  ยท  3Comments

SimonEnsemble picture SimonEnsemble  ยท  3Comments

Datseris picture Datseris  ยท  4Comments

dkarrasch picture dkarrasch  ยท  5Comments