Powerlineのソースを表示

[[Category:視覚効果]]
[[Category:開発]]
[[en:Powerline]]
[https://powerline.readthedocs.io/en/master/index.html Powerline] は [[Vim]] のステータスラインプログラムです。[[zsh]], [[bash]], [[tmux]], [[IPython]], [[Awesome]], [[i3]], [[Qtile]] など他のアプリケーションのステータスラインやプロンプトも提供します。

== インストール ==

[https://powerline.readthedocs.io/en/master/index.html Powerline] は様々な方法でインストールすることができます。

=== 公式リポジトリ ===

{{Pkg|powerline}} と {{Pkg|powerline-fonts}} パッケージを[[インストール]]してください。

=== python-pip を使う ===

* {{Pkg|python-pip}} パッケージを[[インストール]]してください。
* [https://powerline.readthedocs.io/en/master/installation.html Powerline のインストールガイド] を見て python-pip でインストールしてください。

=== vim プラグインマネージャを使う ===

Powerline をインストール・アップデートできる vim のプラグインマネージャは多数存在します (Python をサポートしているバージョンの vim を使っていて {{Pkg|python}} がインストールされていることが前提)。例えば {{AUR|vim-plug}} を使用する場合、{{ic|.vimrc}} ファイルに以下を追加します:

{{hc|~/.vimrc|
call plug#begin(<nowiki>'</nowiki>''path/to/vim/plugins/directory''<nowiki>'</nowiki>)

Plug 'powerline/powerline'

call plug#end()
}}

{{ic|''path/to/vim/plugins/directory''}} は {{ic|~/.vim/plugged}} (Neovim の場合は {{ic|~/.local/share/nvim/plugged}}) など実際のディレクトリに置き換えて、vim の中から vim-plug コマンド {{ic|:PlugInstall}} を実行してください。[https://github.com/powerline/powerline Powerline の GitHub ページ] から指定したプラグインディレクトリに Powerline がダウンロードされ追加されます。

=== フォント ===
Powerline は特殊な記号を使用するため、fontconfig に追加するかパッチの適用されたフォントをインストール・使用しないと正しく表示されません。fontconfig とパッチ済みフォントは {{Pkg|powerline-fonts}} パッケージでインストールできます。テキストコンソール向けの省略版のフォントセットは {{aur|powerline-console-fonts}} パッケージでインストールできます。

=== Airline-vim 代替 ===

Powerline の代替として [https://github.com/vim-airline Vim-airline] が存在します。{{Grp|vim-plugins}} グループに含まれており {{Pkg|vim-airline}} で別個にインストールできます。また、任意で {{Pkg|vim-airline-themes}} をインストールしてください。

=== 特殊なプラグイン ===
Powerline をどこで使用したいかによって、追加でパッケージをインストールする必要があります。
;[[Vim]]: {{Pkg|powerline-vim}}
複数のバージョンの python をインストールしている場合、vimrc に {{ic|let g:powerline_pycmd<nowiki>=</nowiki>"py3"}} または {{ic|let g:powerline_pycmd<nowiki>=</nowiki>"py"}} を追加してください。
{{Tip|
* デフォルトでは、複数のウィンドウを開いた場合にのみステータス行 (と Powerline) が表示されます。常に表示したい場合は {{ic|1=:set laststatus=2}} を使ってください。
* 上記のパッケージは Powerline を {{ic|/usr/share/vim/vimfiles/plugin}} にインストールします。vim によってデフォルトでチェックされるため、全てのユーザーの vim に Powerline がインストールされ設定が必要になります。ユーザー個別にインストールしたい場合、vim のプラグインマネージャを使用するか、{{Pkg|powerline}} パッケージをインストールしてから vimrc に {{ic|set rtp+<nowiki>=</nowiki>/usr/lib/python3.6/site-packages/powerline/bindings/vim}} を追加する方法を使ってください。}}

== 使用方法 ==
=== Bash ===
{{Pkg|powerline}} と {{Pkg|powerline-fonts}} をインストールしたら以下を [[bashrc|~/.bashrc]] に追加してください:
 powerline-daemon -q
 POWERLINE_BASH_CONTINUATION=1
 POWERLINE_BASH_SELECT=1
 . /usr/lib/python3.6/site-packages/powerline/bindings/bash/powerline.sh
一度ターミナルを閉じてから再度開けば機能するはずです。機能しない場合、[https://powerline.readthedocs.io/en/latest/usage/shell-prompts.html#bash-prompt Powerline bash プロンプト] の使用手順を確認してください。

=== 他のプラグイン ===
他のシェルやウィンドウマネージャのウィジェットで Powerline を使用するように設定する方法など、詳しい説明は [https://powerline.readthedocs.io/en/latest/index.html Powerline ドキュメント] の [https://powerline.readthedocs.io/en/latest/usage.html#usage Usage セクション] を参照してください。

== トラブルシューティング ==

=== フォント:グリフが見つからない ===

{{Pkg|powerline-fonts}} をインストールしたが、グリフが見つからない場合は、 [[ロケール]] が設定されていることを確認してください。セッションを再起動して変更を確認します。