Skip to content

Use GitLab Mono over JetBrains Mono

Lukas 'ai-pi' Eipert requested to merge leipert-gitlab-mono into main

What does this MR do and why?

GitLab Mono is a font based on JetBrains Mono, however:

  • it only needs two font files rather than four, because it is based on the variable font
  • ligatures are already removed
  • the backtick bug, e.g. A is fixed

See also: gitlab!123056 (merged)

Screenshots, screen recordings, or links to review app

Before After
https://docs.gitlab.com/ee/integration/glab/ https://leipert-gitlab-mono.docs.gitlab-review.app/ee/integration/glab/
Screenshot_2023-06-22_at_14.35.35 Screenshot_2023-06-22_at_14.35.42

The font rendering is the same and the following things look correct:

  1. Proper italics (e.g. in list of issues, the f looks a little different than f)
  2. Proper font weight (e.g. in --stdin)
  3. No ligatures (e.g. in -- in --stdin)
Before After
https://docs.gitlab.com/ee/user/markdown.html#code-spans-and-blocks https://leipert-gitlab-mono.docs.gitlab-review.app/ee/user/markdown.html#code-spans-and-blocks
Screenshot_2023-06-22_at_14.41.44 Screenshot_2023-06-22_at_14.41.52
  1. The triple backticks (```) render subtly different

How to set up and validate locally

  1. Configure a local GitLab Docs environment: https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/doc/setup.md.

Merge request acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

Edited by Lukas 'ai-pi' Eipert

Merge request reports