powerline/docs/source/troubleshooting/linux.rst

41 lines
1.9 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

************************
Troubleshooting on Linux
************************
I cant see any fancy symbols, whats wrong?
--------------------------------------------
* Make sure that youve configured gvim or your terminal emulator to use
a patched font.
* You need to set your ``LANG`` and ``LC_*`` environment variables to
a UTF-8 locale (e.g. ``LANG=en_US.utf8``). Consult your Linux distros
documentation for information about setting these variables correctly.
* Make sure that vim is compiled with the ``--with-features=big`` flag.
* If youre using rxvt-unicode make sure that its compiled with the
``--enable-unicode3`` flag.
* If youre using xterm make sure you have told it to work with unicode. You may
need ``-u8`` command-line argument, ``uxterm`` shell wrapper that is usually
shipped with xterm for this or ``xterm*utf8`` property set to ``1`` or ``2``
in ``~/.Xresources`` (applied with ``xrdb``). Note that in case ``uxterm`` is
used configuration is done via ``uxterm*…`` properties and not ``xterm*…``.
In any case the only absolute requirement is launching xterm with UTF-8
locale.
* If you are using bitmap font make sure that
:file:`/etc/fonts/conf.d/70-no-bitmaps.conf` does not exist. If it does check
out your distribution documentation to find a proper way to remove it (so that
it wont reappear after update). E.g. in Gentoo this is::
eselect fontconfig disable 70-no-bitmaps.conf
(currently this only removes the symlink from :file:`/etc/fonts/conf.d`). Also
check out that no other fontconfig file does not have ``rejectfont`` tag that
tells fontconfig to disable bitmap fonts (they are referenced as not
scalable).
The fancy symbols look a bit blurry or “off”!
---------------------------------------------
* Make sure that you have patched all variants of your font (i.e. both the
regular and the bold font files).