From 1bfe117c5d91c7312d9dee12bc83e4aca34c995e Mon Sep 17 00:00:00 2001 From: patrick96 Date: Sat, 30 Sep 2023 19:20:14 +0200 Subject: [PATCH] Document recommendations for nerd fonts --- doc/_static/nerd-fonts/bad.png | Bin 0 -> 9388 bytes doc/_static/nerd-fonts/good.png | Bin 0 -> 9323 bytes doc/index.rst | 1 + doc/user/fonts/index.rst | 8 +++++ doc/user/fonts/nerd-fonts.rst | 54 ++++++++++++++++++++++++++++++++ 5 files changed, 63 insertions(+) create mode 100644 doc/_static/nerd-fonts/bad.png create mode 100644 doc/_static/nerd-fonts/good.png create mode 100644 doc/user/fonts/index.rst create mode 100644 doc/user/fonts/nerd-fonts.rst diff --git a/doc/_static/nerd-fonts/bad.png b/doc/_static/nerd-fonts/bad.png new file mode 100644 index 0000000000000000000000000000000000000000..5e4330308406fb15660eaa5e23c48236fce64575 GIT binary patch literal 9388 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 literal 0 HcmV?d00001 diff --git a/doc/_static/nerd-fonts/good.png b/doc/_static/nerd-fonts/good.png new file mode 100644 index 0000000000000000000000000000000000000000..d70f1a326e79bffa80769a7f688aa652d4c8b9cf GIT binary patch literal 9323 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 B1FZl6 literal 0 HcmV?d00001 diff --git a/doc/index.rst b/doc/index.rst index 2ccbb077..60f5d32a 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -15,6 +15,7 @@ Welcome to the official polybar documentation. user/actions user/ipc user/modules/index + user/fonts/index user/default-config migration/index diff --git a/doc/user/fonts/index.rst b/doc/user/fonts/index.rst new file mode 100644 index 00000000..c9773f88 --- /dev/null +++ b/doc/user/fonts/index.rst @@ -0,0 +1,8 @@ +Fonts +===== + +.. toctree:: + :maxdepth: 1 + + Wiki + Nerd Fonts diff --git a/doc/user/fonts/nerd-fonts.rst b/doc/user/fonts/nerd-fonts.rst new file mode 100644 index 00000000..c8c0dd12 --- /dev/null +++ b/doc/user/fonts/nerd-fonts.rst @@ -0,0 +1,54 @@ +Nerd Fonts +========== + +`Nerd Fonts `_ (`GitHub +`_) is a project that patches +together a textual font with font icons (or glyphs) from other projects (e.g. +`Font Awesome `_, `Material Design +Icons `_, etc.) into a single +font. + +In polybar, just using nerd fonts can lead to some issues: + +* Cut-off Characters +* Overlapping +* No Spacing + +These look something like this: + +.. image:: /_static/nerd-fonts/bad.png + :alt: Showcase of the three issues listed above. + +This behavior is intrinsic to Nerd Fonts and is described in more detail `here +`_. +Also see :issue:`991` for more information. + +**To resolve these issues, we recommend using Nerd Fonts like this:** + +The monospaced variants of the different Nerd Fonts (all characters have the +same width) don't have this issue. +However, then you often have the problem that the icons are too small and that +their size cannot be set independently of the text. + +Due to that, we recommend using ``Symbols Nerd Font Mono`` (available for +`download `_ as +``NerdFontsSymbolsOnly.zip``). +This font only contains the nerd font icons and no text. +For the text, simply use any non-Nerd Font: + +.. code-block:: ini + + font-0 = "Liberation Mono:size=20" + font-1 = "Symbols Nerd Font Mono:size=26" + +Now the icon sizes can be adjusted separately to get the best experience. +This solves all three problems shown above: + +.. image:: /_static/nerd-fonts/good.png + :alt: The same config as in the previous screenshot but using ``Symbols Nerd + Font Mono`` for the font icons + +.. note:: + + In the overlap example, there is no space between the icon and text, that's + why they're so close together.