「Powerline」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎インストール: 翻訳を更新)
 
(2人の利用者による、間の3版が非表示)
6行目: 6行目:
 
== インストール ==
 
== インストール ==
   
[[公式リポジトリ]] から powerline と powerline-fonts を [[インストール]]します
+
[[公式リポジトリ]] から {{Pkg|powerline}}{{Pkg|powerline-fonts}} を [[インストール]]します
 
{{note|{{Pkg|powerline-fonts}} をインストールしても、{{aur|powerline-fonts-git}} でパッチが適用されたフォントは提供されません}}
 
{{note|{{Pkg|powerline-fonts}} をインストールしても、{{aur|powerline-fonts-git}} でパッチが適用されたフォントは提供されません}}
   
 
== 使用方法 ==
 
== 使用方法 ==
  +
 
=== Bash ===
 
=== 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 プロンプト] の使用手順を確認してください。
 
一度ターミナルを閉じてから再度開けば機能するはずです。機能しない場合、[https://powerline.readthedocs.io/en/latest/usage/shell-prompts.html#bash-prompt Powerline bash プロンプト] の使用手順を確認してください。
   
次のように入力することもできます。
+
{{Tip|ターミナルを閉じて再度開きたくない場合は、後で [[source]] することもできます。}}
source ~/.bashrc
 
端末を閉じて再起動したくない場合は、このオプションを選択します。
 
   
 
=== Zsh ===
 
=== Zsh ===
  +
 
以下を '''~/.zshrc''' に追加します。
 
以下を '''~/.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 ===
 
=== 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
 
source /usr/share/powerline/bindings/tmux/powerline.conf
  +
}}
{{Note|これを .tmux.conf に追加するだけで十分です (zshrc や bashrc に追加する必要はありません)}}
 
  +
  +
{{Note|
  +
* これを tmux 設定に追加するだけで十分です。シェル設定に何かを追加する必要はありません。
  +
* tmux 設定内の干渉スタイルに注意してください (つまり、{{ic|window-status-format}})
  +
}}
   
 
=== Vim ===
 
=== Vim ===
  +
 
{{Pkg|powerline-vim}} のインストール
 
{{Pkg|powerline-vim}} のインストール
 
{{note|複数のバージョンのPythonがインストールされている場合は、{{ic|.vimrc}} に {{ic|let g:powerline_pycmd<nowiki>=</nowiki>"py3"}} または {{ic|let g:powerline_pycmd<nowiki>=</nowiki>"py"}} を追加してください。}}
 
{{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] を参照してください。
 
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 docs] の "powerline_root" を参照してください。Arch Linux では次のようになります。
+
公式 [https://powerline.readthedocs.io/en/master/ Powerline ドキュメント] の {{ic|powerline_root}} を参照してください。Arch Linux では次のようになります。
   
/usr/lib/python 3.9/site-packages/powerline
+
/usr/lib/python 3.''x''/site-packages/powerline
   
powerline をカスタマイズするには、デフォルトの config ファイルを $XDG_CONFIG_HOME/powerline /... にコピーし、必要に応じてファイルを編集します。
+
powerline をカスタマイズするには、デフォルトの config ファイルを {{ic|$XDG_CONFIG_HOME/powerline /...}} にコピーし、必要に応じてファイルを編集します。
   
 
tmux powerline をカスタマイズする例:
 
tmux powerline をカスタマイズする例:
cp /usr/lib/python3.9/site-packages/powerline/config_files/themes/tmux/default.json ~/.config/powerline/themes/tmux/default.json
+
$ 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
   
 
== その他 ==
 
== その他 ==

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

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

インストール

公式リポジトリ から powerlinepowerline-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 を使用している場合は、~/.zshrcZSH_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がインストールされている場合は、.vimrclet 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 documentationUsage 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 プラグインマネージャはたくさんあります。たとえば、 AURvim-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 をインストールしたが、グリフが見つからない場合は、 ロケール が設定されていることを確認してください。セッションを再起動して変更を確認します。