「Powerline」の版間の差分

2024年4月1日 (月) 01:07時点における最新版

Powerline は Vim のステータスラインプログラムです。zsh, bash, tmux, IPython, Awesome, i3, Qtile など他のアプリケーションのステータスラインやプロンプトも提供します。

インストール

公式リポジトリから powerline と powerline-fonts をインストールします

ノート: powerline-fonts をインストールしても、powerline-fonts-git^AUR でパッチが適用されたフォントは提供されません

使用方法

Bash

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

~/.bashrc

powerline-daemon -q
POWERLINE_BASH_CONTINUATION=1
POWERLINE_BASH_SELECT=1
. /usr/share/powerline/bindings/bash/powerline.sh

一度ターミナルを閉じてから再度開けば機能するはずです。機能しない場合、Powerline bash プロンプトの使用手順を確認してください。

ヒント: ターミナルを閉じて再度開きたくない場合は、後で source することもできます。

Zsh

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

~/.zshrc

powerline-daemon -q
. /usr/share/powerline/bindings/zsh/powerline.zsh

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

Fish

以下を config.fish に追加します:

~/.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.conf に追加します:

~/.config/tmux/tmux.conf

 source /usr/share/powerline/bindings/tmux/powerline.conf

ノート:

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

Vim

powerline-vim のインストール

ノート: 複数のバージョンのPythonがインストールされている場合は、.vimrc に let g:powerline_pycmd="py3" または let g:powerline_pycmd="py" を追加してください。

ヒント:

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

使用方法の詳細

Powerline を他のシェルやウィンドウマネージャのウィジェットと組み合わせて使用するようにシステムを設定するなど、詳しい使用方法については、 Powerline documentation の Usage section を参照してください。

カスタマイズ

公式 Powerline ドキュメントの powerline_root を参照してください。Arch Linux では次のようになります。

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

powerline をカスタマイズするには、デフォルトの config ファイルを $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 を使用する

インストール公式リポジトリの python-pip
python-pip の追加手順については、 Powerline installation guide を参照してください。

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

Python をサポートしたバージョンの vim を使用しているか、python をインストールしていれば、 Powerline をインストールしたり更新したりできる vim プラグインマネージャはたくさんあります。たとえば、 AUR の vim-plug^AUR を使用して、 .vimrc ファイルに次の行を追加します。

~/.vimrc

call plug#begin('path/to/vim/plugins/directory')

Plug 'powerline/powerline'

call plug#end()

path/to/vim/plugins/directory を実際のディレクトリ Neovim の場合は ~/.vim/plugged、 ~/.local/share/nvim/plugged などに置き換え、 vim 内で vim-plug コマンド :PlugInstall を実行します。Powerlineを Powerline GitHub page から指定したプラグインディレクトリにダウンロードし、 vim に追加します。

代替フォント

powerline-console-fonts^AUR では、テキストコンソール用の縮小されたフォントセットを使用できます。

代替パッケージ

Powerline に代わるものとして Vim-airline があります。これはvim-plugins の一部であり、 vim-airline として個別にインストールできます。必要に応じて、 vim-airline-themes をインストールして下さい。

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

他のプラグイン

他のシェルやウィンドウマネージャのウィジェットで Powerline を使用するように設定する方法など、詳しい説明は Powerline ドキュメントの Usage セクションを参照してください。

トラブルシューティング

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

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

@@ 6行目: / 6行目: @@
 == インストール ==
+[[公式リポジトリ]] から {{Pkg|powerline}} と {{Pkg|powerline-fonts}} を [[インストール]]します
-[https://powerline.readthedocs.io/en/master/index.html Powerline] は様々な方法でインストールすることができます。
 {{note|{{Pkg|powerline-fonts}} をインストールしても、{{aur|powerline-fonts-git}} でパッチが適用されたフォントは提供されません}}
 == 使用方法 ==
 === Bash ===
-{{Pkg|powerline}} と {{Pkg|powerline-fonts}} をインストールしたら以下を [[bashrc|~/.bashrc]] に追加してください:
+以下を [[bashrc|~/.bashrc]] に追加してください:
- powerline-daemon -q
- POWERLINE_BASH_CONTINUATION=1
+{{hc|~/.bashrc|2=
- POWERLINE_BASH_SELECT=1
+powerline-daemon -q
- . /usr/lib/python3.6/site-packages/powerline/bindings/bash/powerline.sh
+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]] することもできます。}}
- source ~/.bashrc
-端末を閉じて再起動したくない場合は、このオプションを選択します。
 === Zsh ===
 以下を '''~/.zshrc''' に追加します。
- powerline-daemon -q
+{{hc|~/.zshrc|
- ./usr/share/powerline/bindings/zsh/powerline.zsh
+powerline-daemon -q
-{{Note|'''oh-my-zsh''' を使用している場合は、'''~/.zshrc''' の {{ic|ZSH_THEME<nowiki>=</nowiki>"''oh-my-zsh theme''"}} 行を削除するかコメントアウトする必要があります。同様に、 '''grml-zsh-config''' を使用している場合は、上記の追加の前に {{ic|prompt off}} を忘れずに挿入してください。}}
+. /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 ===
-{{Note|.tmux.conf 内の干渉するスタイルに注意してください (すなわち window-status-format)}} 次の行を ''~/.tmux.conf'' に追加します。
+以下を [[Tmux#設定|tmux.conf]] に追加します:
+{{hc|~/.config/tmux/tmux.conf|
  source /usr/share/powerline/bindings/tmux/powerline.conf
+}}
-{{Note|これを .tmux.conf に追加するだけで十分です (zshrc や bashrc に追加する必要はありません)}}
+{{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}} を使用します。}}
+{{Tip|
-{{Tip|このパッケージは、 {{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) は、複数のウィンドウが開いている場合にのみ表示されます。常に表示するには、 {{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
 == その他 ==