「Powerline」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(同期)
 
(2人の利用者による、間の10版が非表示)
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]] に追加してください:
−
=== python-pip を使う ===
  
   
  +
{{hc|~/.bashrc|2=
−
* {{Pkg|python-pip}} パッケージを[[インストール]]してください。
  
  +
powerline-daemon -q
−
* [https://powerline.readthedocs.io/en/master/installation.html Powerline のインストールガイド] を見て python-pip でインストールしてください。
  
  +
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 プロンプト] の使用手順を確認してください。
−
=== vim プラグインマネージャを使う ===
  
  +
  +
{{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 プラグインマネージャーを使用する====
   
−
Powerline をインストール・アップデートできる vim のプラグインマネージャは多数存在します (Python をサポートしているバージョンの vim を使っていて {{Pkg|python}} がインストールされていることが前提)。例えば {{AUR|vim-plug}} を使用する場合、{{ic|.vimrc}} ファイルに以下を追加します:
 +
Python をサポートしたバージョンの vim を使用しているか、{{Pkg|python}} をインストールしていれば、 Powerline をインストールしたり更新したりできる vim プラグインマネージャはたくさんあります。たとえば、 [[AUR]] の {{AUR|vim-plug}} を使用して、 {{ic|.vimrc}} ファイルに次の行を追加します。
   
 
{{hc|~/.vimrc|
  
{{hc|~/.vimrc|
29行目: 106行目:
 
}}
  
}}
   
−
{{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 がダウンロードされ追加されます。
 +
{{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 は特殊な記号を使用するため、fontconfig に追加するかパッチの適用されたフォントをインストール・使用しないと正しく表示されません。fontconfig とパッチ済みフォントは {{Pkg|powerline-fonts}} パッケージでインストールできます。テキストコンソール向けの省略版のフォントセットは {{aur|powerline-console-fonts}} パッケージでインストールできます。
  
   
  +
Powerline に代わるものとして [https://github.com/vim-airline Vim-airline] があります。これは{{Grp|vim-plugins}} の一部であり、 {{Pkg|vim-airline}} として個別にインストールできます。必要に応じて、 {{Pkg|vim-airline-themes}} をインストールして下さい。
−
=== Airline-vim 代替 ===
  
   
  +
{{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://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 セクション] を参照してください。
  
他のシェルやウィンドウマネージャのウィジェットで Powerline を使用するように設定する方法など、詳しい説明は [https://powerline.readthedocs.io/en/latest/index.html Powerline ドキュメント] の [https://powerline.readthedocs.io/en/latest/usage.html#usage Usage セクション] を参照してください。
  +
  +
== トラブルシューティング ==
  +
  +
=== フォント:グリフが見つからない ===
  +
  +
{{Pkg|powerline-fonts}} をインストールしたが、グリフが見つからない場合は、 [[ロケール]] が設定されていることを確認してください。セッションを再起動して変更を確認します。

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

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

インストール

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

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

使用方法

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 を使用する

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

Python をサポートしたバージョンの vim を使用しているか、python をインストールしていれば、 Powerline をインストールしたり更新したりできる vim プラグインマネージャはたくさんあります。たとえば、 AUR の vim-plugAUR を使用して、 .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-fontsAUR では、テキストコンソール用の縮小されたフォントセットを使用できます。

代替パッケージ

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-gitAURを使用する必要があります。vim-fugitive を v2.3 にダウングレードする;あるいは、自分の vim-airline v0.9.0 を作って、 upstreamのfixing commit を実行します。いいとこ取りをしようとすると綺麗に塗れないので、それも直す必要があります。

他のプラグイン

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

トラブルシューティング

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

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

「https://wiki.archlinux.jp/index.php?title=Powerline&oldid=36725」から取得