Alopexのソースを表示

{{DISPLAYTITLE:Alopex}}
[[Category:動的ウィンドウマネージャ]]
[[en:Alopex]]
{{Related articles start}}
{{Related|dmenu}}
{{Related|dwm}}
{{Related|i3}}
{{Related articles end}}
[https://github.com/TrilbyWhite/alopex Alopex] (旧名 TTWM) は {{AUR|tinywm}}, [[dwm]], [[i3|i3wm]] の概念や要素を併せ持ったミニマルなタイル型ウィンドウマネージャです。[[monsterwm]] などの他の素晴らしいタイル型ウィンドウマネージャからインスピレーションが得られています。Alopex はウィンドウをタイルレイアウトと縦横のスタックレイアウト、一時的なフローティングとフルスクリーンモードで管理します。
{{Note|このページは Alopex 3.x が安定した状態になるまで 2.x について扱います。安定したら、最新版のドキュメントにあうようにページを編集します。}}

==インストール==

[[AUR]] から {{AUR|alopex-git}} をインストールしてください。PKGBUILD を取得して以下のコマンドを実行するだけです:
 $ makepkg -si

{{Tip|設定はコンパイル時に行うようになっているので、(キーバインドやカラースキームのカスタマイズなどの) 修正は (上流の) {{ic|config.h}} を {{ic|$HOME/.alopex_config.h}} や {{ic|$XDG_CONFIG_HOME/alopex/config.h}} にコピーしてからユーザーの設定にあわせてファイルを編集することで行います。[[#カスタム設定]]を参照。}}

==推奨ドキュメント==
Alopex には3つの man ページがあります ({{ic|alopex.1}}, {{ic|alopex.config.5}}, {{ic|alopex.icons.5}})。このページの情報についてより詳しいことが書かれています。
{{Note|man ページが完成したら、このページの情報もデフォルト設定などにあわせて編集します。}}
==基本的な使い方==
デフォルトでは、Alopex は以下の4つの修飾マスクを使います:
{| class="wikitable" border="1" style="text-align:center"
! scope="col" | 参照
! scope="col" | キー
|-
! {{ic|KEY1}}
| "Super"
|-
! {{ic|KEY2}}
| "Alternate"
|-
! {{ic|KEY3}}
| "Control"
|-
! {{ic|KEY4}}
| "Shift"
|-
|}

===プログラムの起動===
[[Dmenu]] は Alopex の便利なアドオンです。リスト式やドロップダウンのメニューと違って、dmenu はキーボードで入力するプログラムランチャーです。Alopex の推奨ランチャーであり、デフォルト設定では dmenu の起動が {{ic|KEY1}} + {{ic|p}} に割り当てられています。

{{Note|Alopex の作者は [[dmenu]] の代わりとして使うことができる [https://bbs.archlinux.org/viewtopic.php?id&#61;160182 interrobang] という名前の軽量なメニューも作成しています。{{AUR|interrobang-git}} で簡単にインストールできます。interrobang で dmenu を置き換えるには、[[#カスタム設定]]のキーバインドをカスタマイズする方法を読んでください。}}

===タグを使う===
ウィンドウに特定のタグを割り当てるには、操作するウィンドウをまずフォーカスする必要があります。フォーカスは {{ic|KEY1}} + {{ic|j}} や {{ic|KEY1}} + {{ic|k}} で出来ます。
{| class="wikitable" border="1" style="text-align:center"
! scope="col" | アクション
! scope="col" | キーバインド
|-
! タグ "x" を表示
| {{ic|KEY1}} + {{ic|x}}
|-
! タグ "x" に移動
| {{ic|KEY1}} + {{ic|KEY2}} + {{ic|x}}
|-
! タグ "x" を割り当てる
| {{ic|KEY1}} + {{ic|KEY3}} + {{ic|x}}
|-
! タグ "x" の表示を切り替え
| {{ic|KEY1}} + {{ic|KEY4}} + {{ic|x}}
|-
|}
{{Note|[[dwm]] と同じように、Alopex はタグとビュー (ワークスペース) を区別します。デフォルトでは、Alopex は6つのタグと2つのビューを使うことができます。ビューは {{ic|KEY2}} + {{ic|Tab}} で切り替えが可能です。その違いを理解・利用してワークフローを改善する文章として、(dwm 用に書かれた) [http://wongdev.com/blog/dwm-tags-are-not-workspaces/ こちらの記事] が役に立つでしょう。}}

{{Tip|{{ic|config.h}} と {{ic|icons.h}} をカスタマイズすることでタグのラベルを貼る方法を変更することができます。[[#タグのカスタマイズ]]を参照。}}

===ウィンドウレイアウト===
Alopex には3つのベースレイアウトがあり、一時的なフルスクリーンとフローティングモードで補完しています: Vertical と Horizontal の Stacking と "Monocle" (ステータスバーのタブが表示されるフルスクリーン) です。デフォルトでは、縦のスタックレイアウトが使用されます。{{ic|KEY1}} + {{ic|space}} を押すことで3つのレイアウトを切り替えることが可能です。以下のショートカットを使うことで各モードを直接選択することができます:
{| class="wikitable" border="1" style="text-align:center"
! scope="col" | モード
! scope="col" | キーバインド
! scope="col" | 表示されるウィンドウ
! scope="col" | 配置
|-
! V-Stack (rstack)
| {{ic|KEY1}} + {{ic|KEY2}} + {{ic|r}} || 3 || 左側に Master、右側にスタック
|-
! H-Stack (bstack)
| {{ic|KEY1}} + {{ic|KEY2}} + {{ic|b}} || 3 || 上部に Master、下部にスタック
|-
! Monocle
| {{ic|KEY1}} + {{ic|KEY2}} + {{ic|m}} || 1 || 各ウィンドウの可変タブ
|-
|}

{{ic|stackcount}} オプションを使うことで、スタックに表示するウィンドウの数を指定できます。{{ic|KEY1}} + {{ic|&#61;}} や {{ic|KEY1}} + {{ic|-}} でスタックに表示するウィンドウの数を動的に増減することも可能です。さらに、{{ic|KEY1}} + {{ic|.}} で全てのウィンドウが表示されます。

{{Tip|{{ic|KEY1}} + {{ic|f}} を押すことでウィンドウをフルスクリーンモードにしたり、通常モードに戻したりできます。同じく、{{ic|KEY1}} + {{ic|KEY2}} + {{ic|f}} を押すことでフローティングモードの切り替えができます。}}

===終了===
ウィンドウを終了するには {{ic|KEY2}} + {{ic|F4}} を押します。Alopex の終了は {{ic|KEY1}} + {{ic|KEY4}} + {{ic|Q}} です。

==高度な使い方==
===カスタム設定===
先に触れたとおり、Alopex の設定は主にソースファイル ({{ic|config.h}} と {{ic|icons.h}}) を編集することでコンパイル時に行います。上流のデフォルト設定で大抵は問題ありませんが、ユーザー設定をするのは難しくありません。

[[#インストール]]に書かれているように、{{AUR|alopex-git}} は {{ic|$HOME/.alopex_config.h}} と {{ic|$XDG_CONFIG_HOME/alopex/config.h}} を確認して、ファイルが存在する場合、ビルドを始める前にデフォルトの {{ic|config.h}} を置き換えます。[[makepkg]] を使ってソースを取得した後、{{ic|config.h}} を {{ic|$HOME/.alopex_config.h}} か {{ic|$XDG_CONFIG_HOME/alopex/config.h}} のどちらかにコピーして修正を加えて下さい。

設定の変更が済んだら、パッケージディレクトリに戻ってコンパイル・インストールしてください:
 $ makepkg -si
{{Tip|既にコンパイルしてしまっている場合、{{ic|f}} スイッチを使うことで強制的に再コンパイルできます。}}

設定の変更に問題がなければ、カスタマイズされた Alopex がコンパイル・インストールされます。問題があった場合、出力を問題を特定してください。

変更を適用するには、Alopex を（再）起動する必要があります。

====カスタムキーバインド====
カスタムキーバインドを使うには {{ic|config.h}} を編集する必要があります。カスタムキーバインドをマップするには、以下の構文で {{ic|keys}} 配列に必要な行を追加してください:
 { MODKEY, <key>, spawn, CMD("program") },
{{Tip|To map a single key to a function (that is, without a modifier key), use {{ic|0}} for {{ic|MODKEY}}.}}

{{ic|<key>}} はヘックスキーコード (例: {{ic|0x68}}) や X のキーシム (例: {{ic|XK_h}}) のどちらかで指定できます。キーコードやキーシムは {{Pkg|xorg-xev}} を使って確認してください。(メディアキーなど) XF86 のキーシムを使いたい場合、{{ic|config.h}} の以下の行をアンコメントする必要があります:
 #include <X11/XF86keysym.h>

{{ic|#define}} を使うことで複雑なコマンドを使うための特別な関数を定義することもできます:
 #define FUNCTION "program -switches --options arguments"
上の構文で {{ic|CMD(FUNCTION)}} を使うことでキーバインドにマッピングできます。

{{Note|Using {{ic|#define FUNCTION}}, you do not quote {{ic|FUNCTION}} in the keybinding declaration.}}

====タグのカスタマイズ====
{{ic|tagcons}} 配列を使うことでステータスバーに表示するタグをカスタマイズすることができます。デフォルトでは、タグには {{ic|one}} から {{ic|six}} という名前が付けられています。{{ic|tagcons}} 配列を使うことで、プリフィックス・アイコン・サフィックスを組み合わせて使うことが可能です。以下の構文でタグの外観を追加・カスタマイズします:
 static const Tagcon tagcons=[] = {
    { "prefix",   #,   "suffix" },
 };
上記の {{ic|#}} は {{ic|icons.h}} の一番下にある配列のアイコンの位置です。{{ic|"prefix"}} と {{ic|"suffix"}} はアイコンの前後にタグに付けられるテキストのラベルです。タグにアイコンを表示したくないときは、{{ic|#}} を {{ic|NO_ICON}} か {{ic|-1}} に置き換えて下さい。ラベルをタグに表示したくない場合、{{ic|"prefix"}} や {{ic|"suffix"}} を {{ic|NULL}} に置き換えて下さい。タグの表示される順番は {{ic|tagcons}} 配列のタグの順番と同じになります。
{{Note|{{ic|NULL}} にクォートは付けないで下さい。プリフィックスやサフィックスのテキストにはクォートが必要です。}}

===ステータスバー===
スクリプトやプログラムを引数として Alopex に渡すことで、ミニマルなステータスバーを作成することができます。[https://bbs.archlinux.org/viewtopic.php?pid=1237677#p1237677 CPU の競合] を避けるために、Alopex には何も指定されなかった場合のデフォルトのステータスバースクリプトが存在します。このデフォルトスクリプトはシンプルな時計だけを表示します。スクリプト (あるいは小規模なプログラム) を書いたり conky などのステータスバープログラムを使うことで、もっと強力なステータスバーを使うことができます。スクリプト (やプログラム) 自体にも引数を指定する場合、ステータスバーの引数全体をクォートで囲って下さい。例えば、Alopex とスクリプトや conky を実行するコマンドは以下のようになります:
 $ xinit /usr/bin/alopex "/home/username/script.sh -args"

 $ xinit /usr/bin/alopex "conky -c /path/to/conkyrc"

スクリプトの出力の一部 (または全部) をカラー化するには、{{ic|{#RRGGBB} }} を使います。"#RRGGBB" は標準的なヘックスカラーコードで、大括弧で囲むことで他のカラーコードが指定されるまでステータスバーの出力をカラーにします。

====カスタムアイコン====
{{ic|config.h}} と同じように、Alopex では {{ic|$HOME/.alopex_icons.h}} や {{ic|$XDG_CONFIG_HOME/alopex/icons.h}} で　{{ic|icons.h}} をカスタマイズすることでカスタムアイコンセットを使うことができます。

大括弧のカラーコードと同じように、ステータスバースクリプトやプログラムでは {{ic|{i X} }} を使うことでアイコンを参照できます。"X" はアイコンの数字になります。デフォルトの {{ic|icons.h}} をみて、どのアイコンが使えるのか X にはどの値が入るのか確認してください (アイコンの順番はファイルに書かれている配列の順番によって決まります)。
{{Note|アイコンはコンパイル時に読み込まれるため、アイコンセットをカスタマイズするには、Alopex の再コンパイル・再インストール・再起動が必要です。}}

===テーマ===
コンパイル時にカラースキームを適用するという形で Alopex は初歩的なテーマをサポートしています。テーマは {{ic|theme.h}} で定義されます。デフォルトでは、Alopex には3つのテーマが存在します: {{ic|WinterCoat}}, {{ic|SummerCoat}}, {{ic|DayLight}}。カスタムテーマを追加するのは簡単で、デフォルトの {{ic|theme.h}} を {{ic|$XDG_CONFIG_HOME/alopex/theme.h}} や {{ic|$HOME/.alopex_theme.h}} にコピーして使用したい色の配列を新しく追加するだけです。使用するテーマを選択するには、{{ic|makepkg}} の前に使用したいテーマの名前を {{ic|MOLT}} 環境変数に指定してください。例:
 $ MOLT=DayLight makepkg -s
テーマが選択されなかった場合、デフォルトでは {{ic|WinterCoat}} テーマが適用されます。

===マルチモニターのサポート===
Alopex には xrandr による16台までの外付けモニターの実験的なサポートがあります。外部モニターの自動検出はまだ対応していませんが、バージョン 2.1 で計画されています。内部モニターと違って、Alopex は外付けモニターのウィンドウを異なるルールセットで管理します。各ウィンドウには (タグやフラグなどの情報に加えて) モニター番号が割り振られます。モニター番号が利用できるモニターの数より大きい場合、ウィンドウは一番数字が大きいモニターに配置されます。そうでない場合は数字に対応するモニターに配置されます。詳しくは man ページのドキュメントや {{ic|config.h}} を見てください。

===ウィンドウルール===
Alopex ではクライアントウィンドウの {{ic|WM_CLASS}} プロパティに含まれたリソース名やクラス名を元にウィンドウルールを定義することもできます。以下の構文で {{ic|config.h}} の {{ic|rules}} 配列を編集することでルールを追加・編集できます:
 static Rule rules[] = {
    { "name",   "class",  tags,   flags },
 }
特定のルールの値を無視するには {{ic|"name"}} や {{ic|"class"}} を {{ic|NULL}} に置き換えて下さい。両方が指定された場合、両方の条件にあてはまる場合にのみルールは適用されます。{{ic|"name"}} や {{ic|"class"}} に使用する値は {{Pkg|xorg-xprop}} で確認できます。{{ic|tags}} に値を指定することでウィンドウを開いたときにデフォルトで設定するタグを指定することが可能です。この挙動を使いたくない場合は、{{ic|tags}} の部分に {{ic|0}} を使ってください。最後に、{{ic|flags}} の値はウィンドウに特殊なプロパティを指定できます (例: 強制的にフローティングモード)。この挙動を使いたくない場合は、{{ic|flags}} を {{ic|0}} に置き換えて下さい。詳しい説明は man ページを参照 ([[#推奨ドキュメント]]を見てください)。

==参照==
* [http://trilbywhite.github.io/alopex/index.html Alopex ホームページ]
* [https://github.com/TrilbyWhite/alopex GitHub の Alopex ソースコード]
* [[dmenu]] - dwm の開発者によるシンプルなアプリケーションランチャー
* フォーラムの [https://bbs.archlinux.org/viewtopic.php?id=146889 Alopex スレッド]
* フォーラムの [https://bbs.archlinux.org/viewtopic.php?id=160182 Interrobang スレッド]