Powerlineのソースを表示

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

== インストール ==

[[公式リポジトリ]] から {{Pkg|powerline}} と {{Pkg|powerline-fonts}} を [[インストール]]します
{{note|{{Pkg|powerline-fonts}} をインストールしても、{{aur|powerline-fonts-git}} でパッチが適用されたフォントは提供されません}}

== 使用方法 ==

=== Bash ===

以下を [[bashrc|~/.bashrc]] に追加してください:

{{hc|~/.bashrc|2=
powerline-daemon -q
POWERLINE_BASH_CONTINUATION=1
POWERLINE_BASH_SELECT=1
. /usr/share/powerline/bindings/bash/powerline.sh
}}

一度ターミナルを閉じてから再度開けば機能するはずです。機能しない場合、[https://powerline.readthedocs.io/en/latest/usage/shell-prompts.html#bash-prompt Powerline bash プロンプト] の使用手順を確認してください。

{{Tip|ターミナルを閉じて再度開きたくない場合は、後で [[source]] することもできます。}}

=== Zsh ===

以下を '''~/.zshrc''' に追加します。

{{hc|~/.zshrc|
powerline-daemon -q
. /usr/share/powerline/bindings/zsh/powerline.zsh
}}

{{Note|'''oh-my-zsh''' を使用している場合は、'''~/.zshrc''' の {{ic|ZSH_THEME<nowiki>=</nowiki>"''oh-my-zsh theme''"}} 行を削除するかコメントアウトする必要があります。同様に、'''grml-zsh-config''' を使用している場合は、上記の追加の前に {{ic|prompt off}} を忘れずに挿入してください。}}

=== Fish ===

以下を [[Fish#設定|config.fish]] に追加します:

{{hc|~/.config/fish/config.fish|
set fish_function_path $fish_function_path "/usr/share/powerline/bindings/fish"
source /usr/share/powerline/bindings/fish/powerline-setup.fish
powerline-setup
}}

ターミナルを再起動して下さい。

=== Tmux ===

以下を [[Tmux#設定|tmux.conf]] に追加します:

{{hc|~/.config/tmux/tmux.conf|
 source /usr/share/powerline/bindings/tmux/powerline.conf
}}

{{Note|
* これを tmux 設定に追加するだけで十分です。シェル設定に何かを追加する必要はありません。
* tmux 設定内の干渉スタイルに注意してください (つまり、{{ic|window-status-format}})
}}

=== Vim ===

{{Pkg|powerline-vim}} のインストール
{{note|複数のバージョンのPythonがインストールされている場合は、{{ic|.vimrc}} に {{ic|let g:powerline_pycmd<nowiki>=</nowiki>"py3"}} または {{ic|let g:powerline_pycmd<nowiki>=</nowiki>"py"}} を追加してください。}}

{{Tip|
* デフォルトでは、ステータスライン (およびPowerline) は、複数のウィンドウが開いている場合にのみ表示されます。常に表示するには、 {{ic|1=:set laststatus=2}} を使用します。
* このパッケージは、 {{ic|/usr/share/vim/vimfiles/plugin}} に Powerline をインストールします。 vim はデフォルトでチェックするように設定されています。つまり、すべてのユーザーに対して vim に Powerline をインストールし、追加の設定が必要になる場合があります。意図していない場合は、 vim プラグインマネージャーを使用するか、 {{Pkg|powerline}} パッケージをインストールして {{ic|set rtp+<nowiki>=</nowiki>/usr/share/powerline/bindings/vim}} を {{ic|.vimrc}} に追加することを検討してください。}}

=== 使用方法の詳細 ===

Powerline を他のシェルやウィンドウマネージャのウィジェットと組み合わせて使用するようにシステムを設定するなど、詳しい使用方法については、 [https://powerline.readthedocs.io/en/latest/usage.html#usage Powerline documentation] の [https://powerline.readthedocs.io/en/latest/index.html Usage section] を参照してください。

== カスタマイズ ==

公式 [https://powerline.readthedocs.io/en/master/ Powerline ドキュメント] の {{ic|powerline_root}} を参照してください。Arch Linux では次のようになります。

 /usr/lib/python 3.''x''/site-packages/powerline

powerline をカスタマイズするには、デフォルトの config ファイルを {{ic|$XDG_CONFIG_HOME/powerline /...}} にコピーし、必要に応じてファイルを編集します。

tmux powerline をカスタマイズする例:
 $ mkdir -p ~/.config/powerline/themes/tmux/
 $ cp /usr/lib/python3.9/site-packages/powerline/config_files/themes/tmux/default.json ~/.config/powerline/themes/tmux/default.json

== その他 ==
=== 代替インストール ===
==== python-pip を使用する ====

* [[インストール]] [[公式リポジトリ]] の {{Pkg|python-pip}}
* python-pip の追加手順については、 [https://powerline.readthedocs.io/en/master/installation.html Powerline installation guide] を参照してください。

==== vim プラグインマネージャーを使用する====

Python をサポートしたバージョンの vim を使用しているか、{{Pkg|python}} をインストールしていれば、 Powerline をインストールしたり更新したりできる vim プラグインマネージャはたくさんあります。たとえば、 [[AUR]] の {{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''}} を実際のディレクトリ Neovim の場合は {{ic|~/.vim/plugged}}、 {{ic|~/.local/share/nvim/plugged}} などに置き換え、 vim 内で vim-plug コマンド {{ic|:PlugInstall}} を実行します。Powerlineを [https://github.com/powerline/powerline Powerline GitHub page] から指定したプラグインディレクトリにダウンロードし、 vim に追加します。
=== 代替フォント ===
{{aur|powerline-console-fonts}} では、テキストコンソール用の縮小されたフォントセットを使用できます。

===代替パッケージ===

Powerline に代わるものとして [https://github.com/vim-airline Vim-airline] があります。これは{{Grp|vim-plugins}} の一部であり、 {{Pkg|vim-airline}} として個別にインストールできます。必要に応じて、 {{Pkg|vim-airline-themes}} をインストールして下さい。

{{note| {{pkg|vim-airline}} では、現在の git ブランチが {{pkg|vim-fugitive}} に依存していることを示します。vim-fugitive v2.4 は、この機能を無効にする変更を行いました。[https://github.com/vim-airline/vim-airline/issues/1815 Upstreamは新しいリリースにタグを付けません] vim-fugitive v2.4 との互換性を修正する単一コミットです。それまでは、現在の git ブランチを表示するには {{AUR|vim-airline-git}}を使用する必要があります。vim-fugitive を v2.3 にダウングレードする;あるいは、自分の vim-airline v0.9.0 を作って、 [https://github.com/vim-airline/vim-airline/commit/30a3c4f54948bc2692a6e218a600d1ebea42f94d upstreamのfixing commit] を実行します。いいとこ取りをしようとすると綺麗に塗れないので、それも直す必要があります。}}

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

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

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

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