tyler.durden/powerline
1
0
Fork 0
mirror of https://github.com/powerline/powerline.git synced 2025-07-29 16:55:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update font installation instructions

Browse Source 
Refs #60.
This commit is contained in:
Kim Silkebækken 2013-01-18 10:58:23 +01:00
parent 2cfd01ec73
commit 56f06f8871
2 changed files with 63 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/source/fontpatching.rst
View File

@ -7,6 +7,9 @@ Powerline provides a font patcher for custom glyphs like the segment
dividers (arrows), branch symbol, padlock symbol, etc. The font patcher dividers (arrows), branch symbol, padlock symbol, etc. The font patcher
requires FontForge with Python bindings to work. requires FontForge with Python bindings to work.
You may be able to avoid patching your coding font to use the custom glyphs!
See :ref:`font-installation` for instructions.
Check out the `powerline-fonts Check out the `powerline-fonts
<https://github.com/Lokaltog/powerline-fonts>`_ repository on GitHub for <https://github.com/Lokaltog/powerline-fonts>`_ repository on GitHub for
patched versions of some popular programming fonts. patched versions of some popular programming fonts.

60
docs/source/overview.rst
View File

@ -6,6 +6,11 @@ Requirements
Powerline requires Python 2.7 to work. Powerline requires Python 2.7 to work.
Powerline uses several special glyphs to get the arrow effect and some
custom symbols for developers. This requires that you either have the symbol
font or a patched font on your system. See `Font installation`_ for more
details.
Vim plugin requirements Vim plugin requirements
^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^
@ -48,6 +53,61 @@ they provide an easy way of installing and upgrading Powerline:
* `Arch Linux (AUR) <https://aur.archlinux.org/packages/powerline-git/>`_ * `Arch Linux (AUR) <https://aur.archlinux.org/packages/powerline-git/>`_
.. _font-installation:
Font installation
^^^^^^^^^^^^^^^^^
Linux
*****
If you're running Linux, you may be able to avoid patching your coding font
to get the special glyphs required by Powerline. This works by utilizing
fontconfig's fallback font feature, which replaces missing glyphs in a font
with another font on your system.
This has been tested and works very well with many different coding fonts,
but some fonts may look terrible, in which case you'll have to use a patched
font (see :ref:`font-patching` for details).
1. Download the `latest version of PowerlineSymbols
<https://github.com/Lokaltog/powerline/raw/develop/powerline/fontpatcher/PowerlineSymbols.otf>`_.
2. Move :file:`PowerlineSymbols.otf` to :file:`~/.fonts`.
3. Run ``fc-cache -vf ~/.fonts`` to update your font cache.
4. Edit your fontconfig file, located in either :file:`~/.fonts.conf` or
:file:`~/.config/fontconfig/fonts.conf`, depending on your fontconfig
version. If your fontconfig file is empty, add the entire code block
below. If you already have a custom font configuration, only add the
``<alias>`` block to your font configuration:
.. code-block:: xml
<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<alias>
<family>monospace</family>
<prefer>
<family>PowerlineSymbols</family>
<family>YOUR MONOSPACE FONT HERE</family>
</prefer>
</alias>
</fontconfig>
Remember to replace ``YOUR MONOSPACE FONT HERE`` with your preferred
coding font.
5. Configure your terminal emulator or gvim to use the ``monospace`` font.
6. If you still don't see the arrow symbols, please close all instances of
your terminal emulator or gvim. You may also have to restart X for the
changes to take effect.
OS X and Windows
****************
You'll have to use a patched font to use the Powerline symbols. See
:ref:`font-patching` for details on font patching and pre-patched fonts.
Usage Usage
----- -----