Segoe UI font issue on Mac shows random letter/numbers in many places

[docmattman]

Search terms

Some text looks like gibberish with random letters and number on a Mac

Expected Behavior

Text should show proper values

Actual Behavior

Some output text shows garbled text

Steps to reproduce the bug

View generated docs on a Mac that doesn't have Segoe UI font installed. Lots of text in the docs will end up looking like this screenshot:

If I specifically install the Segoe UI font on my Mac (not super easy to find), then the text is fixed. Perhaps it would be good to use an alternate default font that would work better cross-platform?

Environment

• Typedoc version: latest
• TypeScript version: any
• Node.js version: any
• OS: Mac

[Gerrit0]

What the... why didn't your browser fall back to the sans-serif fallback?

[docmattman]

I was wondering the same thing. I do have multiple colleagues on Macs that see the same behavior. I think it mostly shows up in places with italic style fonts.

This is from Chrome on a Mac.

[docmattman]

I created a PR to change to Open Sans for the default font (which should be a very close visual replacement) in case you're interested/willing to swap it out:

#2520

[Gerrit0]

As someone who primarily works on a system not connected to the internet, I really like that TypeDoc today doesn't depend on any external resources...

I think a better fix is probably to switch to what GitHub is using, does this fix the issue for you?

font-family: -apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji"

[docmattman]

That makes sense. To verify that change, I can plug that in to my local setup and check/confirm on Mac to make sure, but it seems like it should work fine. I can post back later when I have a chance to check it.

[Gerrit0]

That'd be great! I'd like to include that fix in the next release (tomorrow/Sunday) with the next TypeScript version support

[docmattman]

Ok, I plugged in that font-family value and it all looks good on a Mac. I made the change in the PR as well in case you want to merge it from there. Thanks!

[Gerrit0]

Awesome, thanks!