Dmenuのソースを表示

{{DISPLAYTITLE:dmenu}}
[[Category:アプリケーション]]
[[da:dmenu]]
[[en:Dmenu]]
[[es:Dmenu]]
[[zh-CN:Dmenu]]
{{Related articles start}}
{{Related|アプリケーション一覧/その他#アプリケーションランチャー}}
{{Related articles end}}

[http://tools.suckless.org/dmenu dmenu] は X 向けの高速で軽量なダイナミックメニューです。標準入力から任意のテキストを読み込んで、1行ごとを1つのアイテムとしてメニューを作成します。ユーザーは矢印キーや名前の一部を入力してアイテムを選択することができ、標準出力に行が出力されます。dmenu_run は dmenu をアプリケーションランチャーとして使えるようにするラッパーです。

== インストール ==

[[公式リポジトリ]]から {{Pkg|dmenu}} パッケージを[[インストール]]してください。git の開発ビルドを使いたい場合は、[[Arch User Repository|Arch User Repository]] から {{AUR|dmenu-git}} パッケージをインストールしてください。

dmenu にはデフォルトの機能を拡張した、様々な亜種も存在します。[[AUR|AUR]] から以下のパッケージがインストールできます:

* {{AUR|dmenu-xft}}: XFT フォントをサポート
* {{AUR|dmenu-xft-height}}: XFT フォントをサポートし、高さのカスタムもサポート
* {{AUR|dmenu-xft-transparency}}: XFT フォントと透過をサポート
* {{AUR|dmenu-xft-mouse-height}}: XFT フォント、高さのカスタム、マウスをサポート
* {{AUR|dmenu2}}: 多数の便利なパッチが適用された dmenu のフォーク。明るさの調整や透過のカスタマイズ、下線などの機能が追加されています。

''dmenu'' は次のコマンドで実行できます:

 $ dmenu_run

== 設定 ==

{{Ic|dmenu_run}} コマンドにはキーストロークのコンビネーションを割り振ると良いでしょう。ウィンドウマネージャやデスクトップ環境の設定を使ったり、{{Pkg|xbindkeys}} などのプログラムで設定できます。詳しくは[[ホットキー]]の記事を見て下さい。また、''dmenu'' を [[Prelink]] するのも有用です。

=== カスタムアイコンの表示 ===
''dmenu'' にカスタムアイテムをパイプで渡すことで表示できます。例えば:

 $ echo -e "first\nsecond\nthird" | dmenu

=== 手動でアイテムを追加 ===
''dmenu'' は {{ic|$PATH}} で定義されたディレクトリにある実行可能ファイルを検索します。{{ic|$PATH}} を変更する方法については次の記事を参照: [[環境変数]]。

=== フォント ===
''dmenu'' は ({{Pkg|xorg-xfontsel}} に入っている) ''xfontsel'' ツールを使って [[Wikipedia:XLFD|X 論理フォント記述子]] を利用してフォントを表示できます。次の例は {{Pkg|terminus-font}} を使って dmenu を実行します:

 $ dmenu_run -fn "-xos4-terminus-medium-r-*-*-14-*"

XFT サポートのパッチが適用された ''dmenu'' を使用する場合も構文は同じです:

 $ dmenu_run -fn 'Droid Sans Mono-9'

=== シェルのエイリアスのサポート ===
''dmenu'' は[[Bash#エイリアス|シェルのエイリアス]]に対応していません。''dmenu'' にエイリアスを認識させるには、[[AUR|AUR]] から {{AUR|dmenu-recent-aliases}} パッケージを[[インストール]]して {{ic|dmenu_run_aliases}} を実行してください。''dmenu_run_aliases'' によって認識させるにはエイリアスを {{ic|~/.bash_aliases}} か {{ic|~/.zsh_aliases}} のどちらかに記述する必要があります。

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

=== No locale support ===

''dmenu_run'' を実行すると以下のエラーメッセージが表示される場合:

{{hc|$ dmenu_run|
no locale support
}}

{{ic|LANG}} 環境変数が正しく設定されていることを確認してください。詳しくは次のページを参照: [[ロケール#トラブルシューティング]]。

=== メニューエントリが表示されない ===

特定のメニューエントリが ''dmenu'' に表示されない場合、キャッシュが壊れている可能性があります。キャッシュを削除して ''dmenu'' を再起動してください:
 $ rm ~/.dmenu_cache
 $ rm ~/.cache/dmenu_run
{{ic|$XDG_CACHE_HOME}} が設定されている場合、キャッシュファイルは一つしか存在しません。詳しくは {{ic|/usr/bin/dmenu_run}} の中を見て下さい。

== 参照 ==
* [http://tools.suckless.org/dmenu dmenu] &ndash; dmenu 公式ウェブサイト
* [https://bbs.archlinux.org/viewtopic.php?id=80145 Dmenu Hacking thread ] &ndash; Dmenu hacking thread in arch linux forums. An overview of scripts is provided in the [https://github.com/orschiro/dmenu-scripts-collection dmenu_scripts collection].