Slurm

2016-10-14T16:11:27Z

Colajam93: カテゴリを同期

[[Category:分散コンピューティング]]
[[en:Slurm]]
{{Related articles start}}
{{Related|distcc}}
{{Related|TORQUE}}
{{Related articles end}}

'''Slurm''' (Slurm Workload Manager や slurm-llnl とも呼ばれます) はあらゆる規模の Linux クラスタで動作するように作られたオープンソースのワークロードマネージャです。世界中のスーパーコンピュータやコンピュータクラスタで使われています。Slurm の機能は主に3つです。まず、一定時間、リソース (コンピュータノード) への排他的・非排他的なアクセスをユーザーに配分して、ユーザーが作業を行えるようにします。次に、割り当てられたノードで作業 (通常は並列のジョブ) を開始・実行したり監視するためのフレームワークを用意しています。最後に、保留されている作業のキューを管理することでリソースの取り合いを調整します。

== インストール ==

{{Note|Slurm は強力なジョブスケジューラですが、単純にコンパイルのスループットを持ち上げるためだけのクラスタなら、[[distcc]] の方が簡単・簡潔です。}}
[[AUR]] から {{AUR|slurm-llnl}} パッケージを[[インストール]]してください。依存パッケージとして、認証サービスの {{AUR|munge}} もインストールされます。munge は slurmd の systemd サービスによって実行され、ホスト間の接続を暗号化します。そのため、クラスタの全てのノードには {{ic|/etc/munge/munge.key}} に同じ鍵を保存してください。

slurm パッケージには他にも多数の任意依存パッケージが存在しますが、利用するにはパッケージをインストールした後に slurm を再コンパイルする必要があります。

== セットアップ ==

slurm-llnl の設定ファイルは {{ic|/etc/slurm-llnl}} にあります。slurm サービスを起動する前に、設定ファイル {{ic|/etc/slurm-llnl/slurm.conf}} を作成して適切に設定してください。クライアントとサーバーは同一の設定ファイルが使えます。https://computing.llnl.gov/linux/slurm/configurator.html からファイルを生成するか {{ic|/etc/slurm-llnl/slurm.conf.example}} を {{ic|/etc/slurm-llnl/slurm.conf}} にコピーして自由に修正してください。

デフォルトでは、インストール時に UID と GID が 64030 の slurm ユーザーが作成されます。このユーザーを使うことで複数の環境でのセットアップが楽になります。UID と GID は Debian で使われている ID と同じなので、Debian と一緒に使うこともできます。ただしバイナリはディストリビューションによって違うので注意してください。

=== クライアント (計算ノード) の設定 ===

クライアント側では {{ic|slurmd.service}} を起動します (ブート時に起動させるにはサービスを有効化してください)。

slurmd が立ち上がっていることを確認するには、次を実行:

# systemctl status slurmd

=== サーバー (ヘッドノード) の設定 ===

{{ic|slurmctld.service}} を起動・有効化してください。

また、{{ic|slurmdbd.service}} を起動・有効化することで、mysql データベースを使って重要なプロセスの情報ログを簡単に管理することができます。

{{Note|systemd の力を利用して、{{ic|/etc/default/slurm-llnl}} の設定を変更することでプログラムに引数を追加することができます。このファイルは様々なサービスの environment ファイルとして処理され、設定された引数がプログラムに渡されます。}}

== 参照 ==

*[http://slurm.schedmd.com/tutorials.html slurm tutorials] - ユーザーとシステム管理者のための Slurm Workload Manager のイントロダクション。Slurm プログラマ向けの資料。
*[http://slurm.schedmd.com/quickstart_admin.html Quick Start Administrator Guide] - 詳細なセットアップガイド。
*[https://rc.fas.harvard.edu/resources/documentation/convenient-slurm-commands/ SLURM to manage jobs] - 便利な SLURM コマンド。
*[https://rc.fas.harvard.edu/resources/running-jobs/ Running Jobs] - ハーバード大学での slurm の利用事例。

TORQUE

2016-10-14T16:10:57Z

Colajam93: カテゴリを

[[Category:分散コンピューティング]]
[[en:TORQUE]]
{{Related articles start}}
{{Related|distcc}}
{{Related|Slurm}}
{{Related articles end}}

'''TORQUE''' はオープンソースのリソースマネージャです。バッチジョブや分散された計算ノードを制御します。TORQUE を使うことで、ホーム・スモールオフィス用の Linux クラスタを構築してジョブを管理することができます。クラスタは一つのヘッドノードと多数の計算ノードから成ります。ヘッドノードでは '''torque-server''' デーモンを動作させ計算ノードでは '''torque-client''' デーモンを動作させます。ヘッドノードではスケジューラデーモンも動かします。

== インストール ==

{{Note|TORQUE はとても強力なキューイングシステムですが、コンパイルのスループットを高めるためにクラスタを組むだけなら、[[distcc]] のほうがもっと簡潔に使うことができます。}}
[[AUR]] の {{AUR|torque}} パッケージを[[インストール]]してください。

== 要件 ==

=== /etc/hosts ===

クラスタの全てのマシンの {{ic|/etc/hosts}} に、クラスタの全てのマシンのホストネームを記述してください。例えば、クラスタを3つのマシン (mars, phobos, deimos) で構成する場合:

192.168.0.20 mars
192.168.0.21 phobos
192.168.0.22 deimos

=== ファイアウォールの設定 (インストールしている場合) ===

TORQUE を使用する全てのマシンの TCP を開いてください。

pbs_server (サーバー) と pbs_mom (クライアント) はデフォルトでは TCP と UDP のポート 15001-15004 を使用します。また、特権ポートが設定されている場合 (デフォルト) pbs_mom (クライアント) は UDP ポート 1023 以下も使用します。

=== NFS ===

技術的には、NFS を必ずしも使う必要はありませんが、使ったほうが設定が簡単になります。ビルドに使用するディスク領域を共有するために [[NFS]] の共有をサーバーや他のマシンで設定することを強く推奨します。

== セットアップ ==

=== サーバー (ヘッドノード) の設定 ===

ヘッドノード/スケジューラで以下の手順に従ってください。

{{ic|/var/spool/torque/server_name}} を編集してヘッドノードに名前を付けます。分かりやすいように {{ic|/etc/hostname}} のホストネームと一緒の名前にすることを推奨します。

torque サーバーを作成・設定:

{{bc|
# pbs_server -t create
PBS_Server localhost.localdomain: Create mode and server database exists,
do you wish to continue y/(n)?y
}}

以下を実行して trqauthd を起動:
{{bc|# trqauthd}}

最小限必要なオプションは以下の通りです。最初の行の "mars" を {{ic|/var/spool/torque/server_name}} で入力したホストネームに置き換えてください:

qmgr -c "set server acl_hosts = mars"
qmgr -c "set server scheduling=true"
qmgr -c "create queue batch queue_type=execution"
qmgr -c "set queue batch started=true"
qmgr -c "set queue batch enabled=true"
qmgr -c "set queue batch resources_default.nodes=1"
qmgr -c "set queue batch resources_default.walltime=3600"
qmgr -c "set server default_queue=batch"

完了したジョブは一定期間キューの中に保持すると良いでしょう:

qmgr -c "set server keep_completed = 86400"

上記の場合、86400秒 = 24時間後に、キューからジョブが自動的に削除されます。qstat の {{ic|-f}} スイッチを使うことでキューから削除されたジョブのログを確認することができます:

qstat -f

サーバーの設定を確認したい場合は次のコマンドを実行:
# qmgr -c 'p s'

{{ic|/var/spool/torque/server_priv/nodes}} を編集して計算ノードを全て追加してください。ヘッドノードと同じように、LAN 上のマシンのホストネームと同じ名前を使うことを推奨します。構文は HOSTNAME np=x gpus=y properties です。

* HOSTNAME=マシンのホストネーム
* np=プロセッサの数
* gpus=gpu の数
* properties=コメント

ホストネームだけが必須で、後のフィールドは任意です。

例:

mars np=4
phobos np=2
deimos np=2

{{Note|
* 同じマシンでサーバーとクライアントの両方を動作させることもできます。
* {{ic|pbs_server -t create}} を再実行することで nodes ファイルを削除することができます。
}}

サーバーを再起動して新しいオプションを読み込ませてください。

=== クライアント (計算ノード) の設定 ===

クラスタ内の全ての計算ノードで以下の手順に従ってください。
{{Note|同一マシンでサーバーとクライアントの両方を動作させる場合、クラスタ内の''純粋な''クライアントだけでなくサーバーマシンでも以下の設定を行なってください。}}

{{ic|/var/spool/torque/mom_priv/config}} を編集してサーバーに関する基本的な情報を記述:

$pbsserver mars # note: this is the hostname of the headnode
$logevent 255 # bitmap of which events to log

=== サーバーの再起動 ===

サーバーを再起動すると設定が適用されます:
{{bc|
# killall -s 9 pbs_server
# pbs_server
}}

=== クライアントの起動 ===

クライアントマシンで以下を実行することでクライアントが起動します:
{{bc|
# pbs_mom
}}

== クラスタの状態を確認 ==

クラスタの状態を確認したいときは、以下を実行:
$ pbsnodes -a

''state'' が ''free'' となっていればノードはジョブを受け取る準備が出来ています。ノードが落ちている場合、state は ''down'' となります。

出力例:
{{bc|<nowiki>
mars
state = free
np = 4
ntype = cluster
status = rectime=1308479899,varattr=,jobs=0.localhost.localdomain,state=free,netload=1638547057,
gres=,loadave=2.69,ncpus=4,physmem=8195892kb,availmem=7172508kb,totmem=8195892kb,
idletime=24772,nusers=1,nsessions=5,sessions=1333 1349 1353 1388 9095,
uname=Linux mars 2.6.39-ck #1 SMP PREEMPT Sat Jun 18 14:19:01 EDT 2011 x86_64,opsys=linux
mom_service_port = 15002
mom_manager_port = 15003
gpus = 2

phobos
state = free
np = 2
ntype = cluster
status = rectime=1308479933,varattr=,jobs=,state=free,netload=1085755815,
gres=,loadave=2.84,ncpus=2,physmem=4019704kb,availmem=5753552kb,totmem=6116852kb,
idletime=7324,nusers=2,nsessions=6,sessions=1565 1562 1691 1716 1737 1851,
uname=Linux phobos 2.6.37-ck #1 SMP PREEMPT Sun Apr 3 17:16:35 EDT 2011 x86_64,opsys=linux
mom_service_port = 15002
mom_manager_port = 15003
gpus = 1

deimos
state = free
np = 2
ntype = cluster
status = rectime=1308479890,varattr=,jobs=2.localhost.localdomain,state=free,netload=527239670,
gres=,loadave=0.52,ncpus=2,physmem=4057808kb,availmem=3955624kb,totmem=4057808kb,
idletime=644,nusers=1,nsessions=1,sessions=865,
uname=Linux deimos 2.6.39-ck #1 SMP PREEMPT Sat Jun 11 12:36:21 EDT 2011 x86_64,opsys=linux
mom_service_port = 15002
mom_manager_port = 15003
gpus = 1
</nowiki>}}

== ジョブをキューに追加 ==

クラスタのキューにジョブを登録するには ''qsub'' コマンドを使います。

sleep を実行するだけの簡単なテスト:
$ echo "sleep 30" | qsub

キューの状態は下に書かれているように ''qstat'' コマンドで確認できます。待機中のジョブの状態は "Q" になります。ジョブを開始するには、スケジューラを実行:

# pbs_sched

''torque-server'' の ''systemd'' デーモンを修正することで起動時に pbs_sched を有効にすることができます。

また、qsub にはジョブに名前をつけてスクリプトをキューに入れるという使い方もあります:

$ qsub -N x264 /home/facade/bin/x264_HQ.sh

{{Note|STDOUT and STDERR for a queued job will be logged by default in the form text files corresponding to the respective outputs ''pid.o'' and ''pid.e'' and will be written to the path from which the qsub command was issued.}}

Another example can use a wrapper script to make and queue work ''en mass'' automatically.

== ジョブの状態の確認 ==

作業状況を確認するには {{ic|qstat}} を使います:

{{hc|$ qstat|<nowiki>
Job id Name User Time Use S Queue
------------------------- ---------------- --------------- -------- - -----
13.localhost generic-i686.pbs facade 00:05:06 R batch
14.localhost atom-i686.pbs facade 00:03:09 R batch
15.localhost core2-i686.pbs facade 00:01:02 R batch
16.localhost k7-i686.pbs facade 0 Q batch
17.localhost k8-i686.pbs facade 0 Q batch
18.localhost k10-i686.pbs facade 0 Q batch
19.localhost p4-i686.pbs facade 0 Q batch
20.localhost pentm-i686.pbs facade 0 Q batch
21.localhost ...ic-x86_64.pbs facade 0 Q batch
22.localhost atom-x86_64.pbs facade 0 Q batch
23.localhost core2-x86_64.pbs facade 0 Q batch
24.localhost k8-x86_64.pbs facade 0 Q batch
25.localhost k10-x86_64.pbs facade 0 Q batch
</nowiki>}}

{{ic|-n}} スイッチを追加することでどのノードがどのジョブを実行しているのか確認できます:
{{hc|$ qstat -n|<nowiki>
localhost.localdomain:
405.localhost.lo facade batch i686-generic 3035 1 0 -- 01:00 C 00:12
mars/3+mars/2+mars/1+mars/0
406.localhost.lo facade batch i686-atom 5768 1 0 -- 01:00 C 00:46
phobos/1+phobos/0
407.localhost.lo facade batch i686-core2 22941 1 0 -- 01:00 C 00:12
mars/3+mars/2+mars/1+mars/0
408.localhost.lo facade batch i686-k7 10152 1 0 -- 01:00 C 00:12
mars/3+mars/2+mars/1+mars/0
409.localhost.lo facade batch i686-k8 29657 1 0 -- 01:00 C 00:12
mars/3+mars/2+mars/1+mars/0
410.localhost.lo facade batch i686-k10 16838 1 0 -- 01:00 C 00:12
mars/3+mars/2+mars/1+mars/0
411.localhost.lo facade batch i686-p4 25340 1 0 -- 01:00 C 00:46
deimos/1+deimos/0
412.localhost.lo facade batch i686-pentm 12544 1 0 -- 01:00 R 00:20
phobos/1+phobos/0
413.localhost.lo facade batch x86_64-generic 4024 1 0 -- 01:00 C 00:13
mars/3+mars/2+mars/1+mars/0
414.localhost.lo facade batch x86_64-atom 19330 1 0 -- 01:00 C 00:13
mars/3+mars/2+mars/1+mars/0
415.localhost.lo facade batch x86_64-core2 2146 1 0 -- 01:00 C 00:13
mars/3+mars/2+mars/1+mars/0
416.localhost.lo facade batch x86_64-k8 17234 1 0 -- 01:00 R 00:11
mars/3+mars/2+mars/1+mars/0
417.localhost.lo facade batch x86_64-k10 -- 1 0 -- 01:00 Q --
--
</nowiki>}}

== 参照 ==

*[http://www.cgl.ucsf.edu/Resources/pbs/user_guide.html TORQUE short course from University of California, San Francisco] - Good guide with templates.
*[http://docs.adaptivecomputing.com/torque/5-1-0/help.htm TORQUE admin manual] - Great resource and easy to read.
*[http://www.bc.edu/offices/researchservices/cluster/torqueug.html Boston College's Torque user guide] - Guide not extensive but gives a flavor for how end-users can use a cluster. Probably overkill for home clusters where only one user is submitting work.
*[http://www.adaptivecomputing.com/support/download-center/torque-download/mailing-lists/ TORQUE mailing lists] - The TORQUE community is very knowledgeable and a key asset.
*[http://www.clusterresources.com/pipermail/torqueusers/ TORQUE users mailing list archives] - Searchable archive of TORQUE-users.

Distcc

2016-10-14T16:08:23Z

Colajam93: カテゴリを追加

[[Category:パッケージ開発]]
[[Category:分散コンピューティング]]
[[en:Distcc]]
[[it:Distcc]]
[[zh-CN:Distcc]]
{{Related articles start}}
{{Related|TORQUE}}
{{Related|Slurm}}
{{Related articles end}}
Distcc は C, C++, Objective C, Objective C++ のコードのビルドをネットワーク上の複数のマシンに分散させるプログラムです。distcc は常にローカルビルドと同じ結果を生成し、インストールと使用方法がシンプルで、ローカルコンパイルよりもずっと高速です。makepkg などの Arch のビルドツールで使うことができます。

==用語==

; マスター: コンパイルを開始して設定済みのスレーブにコンパイルを分散させるコンピューター。

; スレーブ: distcc デーモンが動いており、マスターからコンパイルリクエストを受け取る。

==インストール==

[[公式リポジトリ]]からクラスタの PC 全てに {{pkg|distcc}} パッケージを[[pacman|インストール]]してください。

他のディストロや、Cygwin を使用する Windows など他の OS を使う場合は、[http://distcc.samba.org/doc.html distcc のドキュメント] を参照してください。

==設定==
=== スレーブ ===

スレーブの設定は {{ic|/etc/conf.d/distccd}} に保存します。利用できるコマンドラインオプションは [http://distcc.googlecode.com/svn%20...%20%3Cdiv%20class=/trunk/doc/web/man/distccd_1.html distcc マニュアル] に記載されています。最低でも、許可するアドレスの範囲を [[wikipedia:Classless_Inter-Domain_Routing|CIDR]] 形式で指定してください:

DISTCC_ARGS="--allow 192.168.0.0/24"

アドレスの範囲を CIDR 形式に変換するツールが次のページにあります: [http://www.ipaddressguide.com/cidr CIDR Utility Tool]。

コンパイルに参加する全てのスレーブで {{ic|distccd.service}} を[[起動]]してください。起動時に {{ic|distccd.service}} を実行させるには、全てのマシンでサービスを[[有効化]]してください。

=== マスター ===

==== スタンドアロン ====

マスターで設定する distcc の最小設定は、利用するスレーブの設定です。環境変数 {{ic|DISTCC_HOSTS}} や {{ic|$DISTCC_HOSTS}}, {{ic|$DISTCC_DIR/hosts}}, {{ic|~/.distcc/hosts}}, {{ic|/etc/distcc/hosts}} などの設定ファイルでアドレスを指定することで設定できます。

{{ic|DISTCC_HOSTS}} を使ってスレーブのアドレスを設定する例:

$ export DISTCC_HOSTS="192.168.0.3,lzo,cpp 192.168.0.4,lzo,cpp"

{{Note|このリストは空白で分けられています。}}

{{ic|hosts}} 設定ファイルでスレーブのアドレスを設定する例:

{{hc|~/.distcc/hosts|
192.168.0.3,lzo,cpp 192.168.0.4,lzo,cpp
}}

サーバーのアドレスを明示的に指定する代わりに、avahi の zeroconf モードを使うこともできます。このモードを使うにはサーバーアドレスのところに {{ic|+zeroconf}} と記述して、スレーブ側で distcc デーモンを {{ic|--zeroconf}} オプションを使って起動するようにしてください。このオプションは pump モードをサポートしてないので注意してください。

上記の例ではアドレスに以下のオプションを追加しています:

* {{ic|lzo}}: TCP と SSH ホスト (スレーブ) で LZO 圧縮を使う。
* {{ic|cpp}}: ホスト (スレーブ) で distcc-pump モードを使う。サーバーを起動するにはビルドコマンドを pump スクリプトでラッピングする必要があるので注意。

pump モードの説明は次のページにあります: [http://distcc.googlecode.com/svn%20...%20%3Cdiv%20class=/trunk/doc/web/man/distcc_1.html#TOC_8 HOW DISTCC-PUMP MODE WORKS] と [http://google-opensource.blogspot.de/2008/08/distccs-pump-mode-new-design-for.html distcc's pump mode: A New Design for Distributed C/C++ Compilation] 。

スレーブで distcc-pump モードを使うには、pump スクリプトを使ってコンパイルを開始する必要があります。そうしないとコンパイルは失敗します。

==== Makepkg ====

{{ic|/etc/makepkg.conf}} の以下の3つのセクションを編集してください:

#BUILDENV で distcc の前のエクスクラメーションポイントを外して有効にしてください。
#''DISTCC_HOSTS'' 行をアンコメントして、スレーブの IP アドレスとスラッシュ、使用するスレッドの数を追加してください。後ろの IP アドレスとスレッドは空白で区切ります。リストは一番強力なサーバーから非力なサーバーの順で並べます (処理能力)。
#MAKEFLAGS 変数を個々のサーバーの最大スレッド数をすべて合計した数字にしてください。下の例の場合、5+3+3=11 になります。合計数以上を指定した場合、余った論理スレッドは distcc によってブロックされ、下で説明している ''distccmon-text'' などの監視ユーティリティでそのように表示されます。

{{Note|よく物理コアとハイパースレッドのコア数に1を加えた数をスレッド数として定義することがありますが、この設定では MAKEFLAGS で1を加えないようにしてください。}}

例:
BUILDENV=(distcc fakeroot color !ccache !check)
MAKEFLAGS="-j11"
DISTCC_HOSTS="192.168.0.2/5 192.168.0.3/3 192.168.0.4/3"

SSH を通して distcc を使いたい場合、セクションの IP アドレスの前に "@" シンボルを追加してください。キーベースの認証をセットアップしていないときは、認証済みのホストのチェックを無視するように DISTCC_SSH 変数を設定してください: {{ic|<nowiki>DISTCC_SSH="ssh -i"</nowiki>}}。

==コンパイル==
=== スタンドアロン ===

distcc の pump モードを使ってソースファイルをコンパイルするには、次のコマンドを使用します:

$ pump distcc g++ -c hello_world.cpp

この場合 pump スクリプトは distcc を実行してから "-c hello_world.cpp" をパラメータとして g++ を呼び出します。

Makefile プロジェクトをコンパイルするには、まずコンパイラによって設定される変数を確認する必要があります。例えば、gzip-1.6 の場合、Makefile の中に次の行を見つけることができます: {{ic|1=CC = gcc -std=gnu99}}。基本的に {{ic|CC}} は C プロジェクトで使われる変数で、{{ic|CXX}} は C++ プロジェクトで使われる変数です。distcc を使ってプロジェクトをコンパイルするには以下のようにします:

$ wget ftp://ftp.gnu.org/pub/gnu/gzip/gzip-1.6.tar.xz
$ tar xf gzip-1.6.tar.xz
$ cd gzip-1.6
$ ./configure
$ pump make -j2 CC="distcc gcc -std=gnu99"

上記例では distcc の pump モードによって2つのコンパイルスレッドを使って gzip をコンパイルします。{{ic|-j}} の設定については [https://cdn.rawgit.com/distcc/distcc/master/doc/web/faq.html What -j level to use?] を見て下さい。

=== Makepkg ===

通常通り makepkg でコンパイルしてください。

==進捗を見る==
複数の方法で進行状況を確認することができます。
#distccmon-text
#ログファイルを tail で表示する

distccmon-text を実行してコンパイル状況をチェックします:
{{bc|$ distccmon-text
29291 Preprocess probe_64.c 192.168.0.2[0]
30954 Compile apic_noop.c 192.168.0.2[0]
30932 Preprocess kfifo.c 192.168.0.2[0]
30919 Compile blk-core.c 192.168.0.2[1]
30969 Compile i915_gem_debug.c 192.168.0.2[3]
30444 Compile block_dev.c 192.168.0.3[1]
30904 Compile compat.c 192.168.0.3[2]
30891 Compile hugetlb.c 192.168.0.3[3]
30458 Compile catalog.c 192.168.0.4[0]
30496 Compile ulpqueue.c 192.168.0.4[2]
30506 Compile alloc.c 192.168.0.4[0]
}}

プログラムを持続的に実行させるには、watch を使うか、コマンドに空白と繰り返す待機秒数を加えます:
$ watch distccmon-text
または
$ distccmon-text 2

デーモンで {{ic|/var/log/messages.log}} を tail することもできます:
# tail -f /var/log/messages.log

==distcc で "クロスコンパイル"==
=== X86 ===

現在、x86_64 環境から i686 のパッケージをビルドするのに、distcc でクラスタに作業を分散させる方法は2つ存在します。どちらも理想的とは言いがたいですが、今のところ、この2つの方法しかドキュメントになっていません。

An ideal setup is one that uses the unmodified ARCH packages for distccd running only once one each node regardless of building from the native environment or from within a chroot AND one that works with makepkg. Again, this Utopian setup is not currently known.

A [https://bbs.archlinux.org/viewtopic.php?id=129762 discussion thread] has been started on the topic; feel free to contribute.

==== Chroot を使う方法 (推奨) ====
{{Note|以下の方法は全てのノードに distccd をインストールして32ビットの chroot も必要なのであまりエレガントな方法とは言えません。}}

[[64ビット環境に32ビット環境をインストール|32ビットの chroot]] を distcc クラスタの'''各ノード'''に設定したら、各ノードで2つの distccd インスタンスを別々のポートで実行させます。片方はネイティブの x86_64 環境で実行させ、もう片方は x86 chroot で動かします。makepkg は [[64ビット環境に32ビット環境をインストール#Schroot|schroot コマンド]]を通して実行します。

===== i686 chroot の DISTCC_HOSTS にポート番号を追加する =====
以下のように {{ic|/opt/arch32/etc/makepkg.conf}} の各ホストにポート番号 (3692) を追加してください:

DISTCC_HOSTS="192.168.1.101/5:3692 192.168.1.102/5:3692 192.168.1.103/3:3692"

{{Note|This only needs to be setup on the "master" i686 chroot. Where "master" is defined as the one from which the compilation will take place.}}

===== ネイティブ環境から makepkg を呼び出す =====

ネイティブの x86_64 環境に [[64ビット環境に32ビット環境をインストール#Schroot|schroot]] をセットアップしてください。ネイティブの x86_64 環境から makepkg を実行して i686 パッケージのビルドをするには:

$ schroot -p -- makepkg -src

==== Multilib GCC を使う方法 (非推奨) ====
{{Warning|以下の方法を使ってネイティブの x86_64 環境から i686 の linux パッケージをビルドするとエラーが発生することが報告されています。カーネルパッケージをビルドする場合 chroot を使用する方法を推奨します。}}

{{ic|/etc/pacman.conf}} を編集して [multilib] リポジトリをアンコメントしてください:

[multilib]
Include = /etc/pacman.d/mirrorlist

[[公式リポジトリ]]から {{pkg|gcc-multilib}} を[[pacman|インストール]]してください。

{{ic|$HOME/.makepkg.conf}} に以下の行を追加するだけで x86_64 で i686 用のパッケージをコンパイルできます:
CARCH="i686"
CHOST="i686-pc-linux-gnu"
CFLAGS="-march=i686 -O2 -pipe -m32"
CXXFLAGS="${CFLAGS}"

次のコマンドで makepkg を呼び出して下さい:
$ linux32 makepkg -src

i686 パッケージをコンパイルし終わった後は {{ic|$HOME/.makepkg.conf}} を忘れずに削除または修正してください。

=== 他のアーキテクチャ ===

==== Arch ARM ====

Arch ARM デバイスでビルドをする場合、開発者は公式のプロジェクトツールチェインを使用することを強く推奨しています:
*[https://archlinuxarm.org/builder/xtools/x-tools8.tar.xz ARMv8]
*[https://archlinuxarm.org/builder/xtools/x-tools7h.tar.xz ARMv7l hard]
*[https://archlinuxarm.org/builder/xtools/x-tools6h.tar.xz ARMv6l hard]
*[https://archlinuxarm.org/builder/xtools/x-tools.tar.xz ARMv5te soft]

必要なアーキテクチャのツールチェインをスレーブのファイルシステムのどこかに展開して {{ic|/etc/conf.d/distccd}} を編集し、ツールチェインが使えるように PATH を通してください。

例えばツールチェインを {{ic|/mnt/data}} に展開した場合:
PATH=/mnt/data/x-tools8/aarch64-unknown-linux-gnueabi/bin:$PATH

設定ファイルが読み込まれるように、{{ic|distcc.service}} を[[systemd#ユニットを使う|再起動]]する必要があります。

makepkg を使用しないでビルドする場合、任意でユーザーのホームディレクトリにリンクを作成してください。例:
$ ln -s /mnt/data/x-tools8 x-tools8

==== 追加ツールチェイン ====
ツールチェインを入手する方法は複数存在します:

* [https://embtoolkit.org/ EmbToolkit]: クロスコンパイルツールチェインを作成するためのツール。ARM と MIPS アーキテクチャをサポートしており、LLVM ベースのツールチェインのビルドをサポートしています。
* [http://crosstool-ng.org/ crosstool-ng]: EmbToolkit と同じようなツール。EmbToolkit よりも多数のアーキテクチャをサポートしています (詳しくはウェブサイトを参照)。
* [https://www.linaro.org/downloads/ Linaro]: ARM 開発用のツールチェインを提供しています。

{{ic|EmbToolkit}} にはツールチェインを設定するためのグラフィカルな設定メニュー ({{ic|make xconfig}}) が付属しています。

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

=== Journalctl ===

問題が発生したときは {{ic|journalctl}} を使って原因を確認してください:

$ journalctl $(which distccd) -e --since "5 min ago"

=== code 110 ===

distcc デーモンのプロセスが起動されるユーザーアカウント (デフォルトは nobody) でツールチェインが正しく機能することを確認してください。以下ではユーザー nobody でツールチェインが動作することをテストします。{{ic|/etc/passwd}} で nobody ユーザーのログインを以下のように変更してください:

{{hc|$ cat /etc/passwd|
...
nobody:x:99:99:nobody:/:/bin/bash
...
}}

それからクロスコンパイラのバイナリが存在するディレクトリに cd してからコンパイラの実行を試行します:

# su nobody
$ ./gcc --version
bash: ./gcc: Permission denied

上記のエラーが発生する場合、[[#他のアーキテクチャ]] に記述されているグループパーミッションの設定を正しく行ったか確認してください。

変更を行った後は {{ic|/etc/passwd}} を元に戻すようにしましょう。

もしくは、sudo を使うことで {{ic|/etc/passwd}} でシェルを変更しなくても実行できます:

# sudo -u nobody gcc --version

===ログレベルを設定する===
デフォルトでは、distcc は {{ic|/var/log/messages.log}} にログを出力します。このログはファイルに直接出力することができます (distccd の man ページで実際に推奨されています)。ログファイルを {{ic|/tmp}} を使って RAM 上に配置することも可能です。また、ログファイルに出力されるエラーのログレベルを下げることもできます。接続のエントリよりもエラーメッセージを見たいというときに有用です。LEVEL は標準的な syslog のレベルで設定でき critical, error, warning, notice, info, debug などを指定します。

以下の行を {{ic|/etc/conf.d/distccd}} の DISTCC_ARGS に追記してください:

DISTCC_ARGS="--user nobody --allow 192.168.0.0/24 --log-level error --log-file /tmp/distccd.log"

===CMake などのツールでビルドが失敗する===
CMake はときどき gcc に [http://gcc.gnu.org/wiki/Response_Files "レスポンスファイル"] を渡すことがありますが、distcc はレスポンスファイルを扱うことができません。[http://code.google.com/p/distcc/issues/detail?id=85&q=response パッチファイル] は存在しているのですが、上流のコードには適用されていないようです。この問題が発生する場合は、このファイルをパスするか [[AUR]] の {{AUR|distcc-rsp}} パッケージを使って下さい。

===HDD/SSD の使用量を制限する===
====$HOME/.distcc を移動する====
デフォルトでは、distcc は {{ic|$HOME/.distcc}} を作成して、一時的に情報を保存してノードにコンパイルさせる作業を割り当てます。{{ic|/tmp}} などの RAM に ''.distcc'' という名前のディレクトリを作成して $HOME の ''.distcc'' にソフトリンクします。これで無駄な HDD の読み書きが減ります。特に SSD の場合は効果的です。

$ mv $HOME/.distcc /tmp
$ ln -s /tmp/.distcc $HOME/.distcc

systemd を使って再起動時にこのディレクトリを再作成 (他のファイルと同じように手動で削除されるまでソフトリンクは消えません) します。以下の tmpfile を作成:

{{hc|/etc/tmpfiles.d/tmpfs-create.conf|<nowiki>
d /tmp/.distcc 0755 <username> users -
</nowiki>}}

Hadoop

2016-10-14T16:01:07Z

Colajam93: カテゴリを同期

[[Category:分散コンピューティング]]
[[en:Hadoop]]
[[zh-CN:Hadoop]]
[http://hadoop.apache.org Apache Hadoop] はコモディティハードウェアによる巨大なクラスタ上でアプリケーションを実行するためのフレームワークです。Hadoop フレームワークは透過的にアプリケーションに信頼性とデータモーションを提供します。Hadoop は Map/Reduce という名前の計算パラダイムを実装しています。そこではアプリケーションは多数の小さな欠片に分割して、クラスタ内のノード上でそれぞれを実行・再実行できるようにします。さらに、Hadoop は計算ノード上にデータを保存するための分散ファイルシステム (HDFS) を備えており、クラスタ全体で非常に高い帯域を実現します。MapReduce と Hadoop Distributed File System はどちらもノードでのエラーをフレームワークによって自動的に処理できるように設計されています。

== インストール ==
[[Arch User Repository]] の {{AUR|hadoop}} パッケージをインストールしてください。

== 設定 ==

デフォルトで、hadoop は擬似分散操作ができるように設定されています。{{ic|/etc/profile.d/hadoop.sh}} には伝統的な hadoop とは異なる値が設定されている環境変数があります。

{| class="wikitable"
|-
! scope="col"| 環境変数
! scope="col"| 値
! scope="col"| 説明
! scope="col"| パーミッション
|-
| align="center"|HADOOP_CONF_DIR
| align="left"|{{ic|/etc/hadoop}}
| align="center"|{{ic|Where configuration files are stored.}}
| align="left"|Read
|-
| align="center"|HADOOP_LOG_DIR
| align="left"|{{ic|/tmp/hadoop/log}}
| align="center"|{{ic|Where log files are stored.}}
| align="left"|Read and Write
|-
| align="center"|HADOOP_SLAVES
| align="left"|{{ic|/etc/hadoop/slaves}}
| align="center"|{{ic|File naming remote slave hosts.}}
| align="left"|Read
|-
| align="center"|HADOOP_PID_DIR
| align="left"|{{ic|/tmp/hadoop/run}}
| align="center"|{{ic|Where pid files are stored.}}
| align="left"|Read and Write
|}

また、以下のファイルを正しく設定する必要があります。

/etc/hosts
/etc/hostname
/etc/locale.conf

{{ic|JAVA_HOME}} は {{pkg|jdk7-openjdk}} の {{ic|/etc/profile.d/jre.sh}} によって自動的に設定されているはずです。{{ic|JAVA_HOME}} を確認:
$ echo $JAVA_HOME

何も出力されない場合、一度ログアウトしてからログインしなおして下さい。

== シングルノード設定 ==
{{out of date|This section of the article is based on documentation for an earlier version of Hadoop.}}

{{Note|This section is based on the [http://hadoop.apache.org/docs/stable/ Hadoop Official Documentation] }}

=== スタンドアロン操作 ===

By default, Hadoop is configured to run in a non-distributed mode, as a single Java process. This is useful for debugging.

The following example copies the unpacked conf directory to use as input and then finds and displays every match of the given regular expression. Output is written to the given output directory.
$ export HADOOP_CONF_DIR=/usr/lib/hadoop/orig_conf
$ mkdir input
$ cp /etc/hadoop/*.xml input
$ hadoop jar /usr/lib/hadoop/hadoop-examples-*.jar grep input output 'dfs[a-z.]+'
$ cat output/*

For the current 2.5.x release of hadoop included in the AUR:
$ HADOOP_CONF_DIR=/usr/lib/hadoop/orig_etc/hadoop/
$ mkdir input
$ cp /etc/hadoop/hadoop/*.xml input
$ hadoop jar /usr/lib/hadoop/share/hadoop/mapreduce/hadoop-mapreduce-examples-2.5.0.jar grep input output 'dfs[a-z.]+'
$ cat output/*

=== 擬似分散操作 ===

Hadoop can also be run on a single-node in a pseudo-distributed mode where each Hadoop daemon runs in a separate Java process.

By default, Hadoop will run as the user root. You can change the user in {{ic|/etc/conf.d/hadoop}}:

HADOOP_USERNAME="<your user name>"

==== パスフレーズの要らない ssh の設定 ====

Make sure you have [[sshd]] enabled, or start it with {{ic|systemctl enable sshd}}. Now check that you can connect to localhost without a passphrase:

$ ssh localhost

If you cannot ssh to localhost without a passphrase, execute the following commands:

$ ssh-keygen -t rsa -P "" -f ~/.ssh/id_rsa
$ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys2

Also make sure this line is commented in {{ic|/etc/ssh/sshd_config}}

{{hc|/etc/ssh/sshd_config|
#AuthorizedKeysFile .ssh/authorized_keys}}

==== 実行 ====

Format a new distributed-filesystem:
$ hadoop namenode -format

Start the hadoop daemons:
# systemctl start hadoop-datanode
# systemctl start hadoop-jobtracker
# systemctl start hadoop-namenode
# systemctl start hadoop-secondarynamenode
# systemctl start hadoop-tasktracker

The hadoop daemon log output is written to the {{ic|<nowiki>${HADOOP_LOG_DIR}</nowiki>}} directory (defaults to {{ic|/var/log/hadoop}}).

Browse the web interface for the NameNode and the JobTracker; by default they are available at:

* NameNode - http://localhost:50070/
* JobTracker - http://localhost:50030/

Copy the input files into the distributed filesystem:
$ hadoop fs -put /etc/hadoop input

Run some of the examples provided:
$ hadoop jar /usr/lib/hadoop/hadoop-examples-*.jar grep input output 'dfs[a-z.]+'

Examine the output files:

Copy the output files from the distributed filesystem to the local filesytem and examine them:
$ hadoop fs -get output output
$ cat output/*

or

View the output files on the distributed filesystem:
$ hadoop fs -cat output/*

When you're done, stop the daemons with:
# systemctl stop hadoop-datanode
# systemctl stop hadoop-jobtracker
# systemctl stop hadoop-namenode
# systemctl stop hadoop-secondarynamenode
# systemctl stop hadoop-tasktracker

カテゴリ:分散コンピューティング

2016-10-14T15:59:21Z

Colajam93: 作成

[[Category:ネットワーク]]
[[en:Category:Distributed computing]]

Apache Spark

2016-10-14T15:52:48Z

Colajam93: 作成

[[Category:分散コンピューティング]]
[[en:Apache Spark]]
{{Related articles start}}
{{Related|Hadoop}}
{{Related articles end}}

[https://spark.apache.org Apache Spark] はオープンソースのクラスタコンピューティングフレームワークで、もともとカリフォルニア大学バークレー校の AMPLab で開発されていました。
Hadoop の二段式ディスクベース MapReduce パラダイムと比較して、Spark のインメモリ処理はいくつかのアプリケーションにおいて100倍高速なパフォーマンスをもたらします。
クラスタのメモリへのデータのロードと、繰り返しアクセスがユーザープログラムに許されているため、Spark は機械学習アルゴリズムに適しています。

== インストール ==

{{AUR|apache-spark}} パッケージをインストールしてください。

== 設定 ==

いくつかの環境変数が {{ic|/etc/profile.d/apache_spark.sh}} に設定されています。

{| class="wikitable"
|-
! ENV
! Value
! Description
|-
| PATH
| {{ic|$PATH:/usr/lib/apache_spark/bin}}
| Spark binaries
|}

もしあなたのシェルが {{ic|/etc/profile.d}} を読み込まなかったら、{{ic|PATH}} [[環境変数]] を調整する必要があるかもしれません:

export PATH=$PATH:/usr/lib/apache_spark/bin

Java Runtime Environment のフォント

2016-10-14T14:58:39Z

Colajam93: 同期

[[Category:フォント]]
[[en:Java Runtime Environment fonts]]
[[ru:Java Runtime Environment fonts]]
{{Related articles start}}
{{Related|フォント}}
{{Related|フォント設定}}
{{Related|MS フォント}}
{{Related|X Logical Font Description}}
{{Related articles end}}
ユーザーによってはデフォルトの Java フォントや Java アプリケーションのフォントの表示モードが気に入らないという人もいるでしょう。Oracle Java Runtime Environment (JRE) のフォント表示を改善する方法は複数存在します。これらの方法は別々に使うこともできますが、多くの場合まとめて使うことでより良い結果が得られるでしょう。

TrueType フォントは Java で一番良くサポートされているフォーマットです。

==アンチエイリアス==
フォントの[[Wikipedia:Antialiased_font|アンチエイリアス]]は Linux の Oracle Java 1.6 及び OpenJDK で利用可能です。システム全体の設定でアンチエイリアスを使うには、次の行を {{ic|/etc/environment}} に追加してください:

export _JAVA_OPTIONS='-Dawt.useSystemAAFontSettings=''setting'''

{{Ic|''setting''}} は以下の7つの値のどれか一つに置き換えて下さい:

{| class="wikitable"
! 設定
! 説明
|-
| {{Ic|off}}, {{Ic|false}}, {{Ic|default}}
| アンチエイリアスなし
|-
| {{Ic|on}}
| 完全なアンチエイリアス
|-
| {{Ic|gasp}}
| フォントに埋め込まれたヒント情報を使う
|-
| {{Ic|lcd}}, {{Ic|lcd_hrgb}}
| 多数派の LCD モニターにあわせてアンチエイリアスを調整する
|-
| {{Ic|lcd_hbgr}}, {{Ic|lcd_vrgb}}, {{Ic|lcd_vbgr}}
| もうひとつの LCD モニター設定
|}

多くの場合 {{Ic|gasp}} と {{Ic|lcd}} の設定が上手く機能します。

任意で GTK のルックアンドフィールを使うには、代わりに下の行を .bashrc に追加してください。

_JAVA_OPTIONS='-Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel' ''

{{Note|
* 上述の Java オプションやこのオプションは Java で GUI を描写している Jdownloader などのアプリケーションでしか意味がありません。Java をバックエンドでしか利用していない Openoffice.org や Matlab などのアプリケーションでは表示が変わりません。
* '''TrueType''' フォントにはポイントサイズに合わせてどうフォントを表示するかデザイナーによって決められたグリッド調整およびスキャン変換手続き (''GASP'') テーブルが含まれています。サイズによっては完全にアンチエイリアスをかけられたり、場合によってはヒンティングを適用したり、あるいはビットマップフォントとして表示するようになったりします。特定のポイントサイズではそれらを組み合わせて使われることもあります。}}

コマンドラインで実行ファイルの前に変数を指定して新しい設定を試してみましょう:

_JAVA_OPTIONS=options exectuable

変更を適用するには再ログインする必要があります。

=== フォントのヒンティング ===

一部の Java アプリケーションにはヒンティングのシステム設定が反映されません。Java アプリを起動する前に、以下の環境変数のどれかを使ってみてください:

export FT2_SUBPIXEL_HINTING=0 # Classic mode
export FT2_SUBPIXEL_HINTING=1 # Infinality mode
export FT2_SUBPIXEL_HINTING=2 # Default mode

例えば、{{ic|0}} の場合 FreeType は太字でないフォントを使うようになります。

=== OpenJDK パッチ ===

Java のオプションを使って強制的にアンチエイリアスをかけても、ネイティブアプリケーションのアンチエイリアスよりかは品質で劣ります。[[AUR]] にある OpenJDK のパッチを使うことで改善することができます:
* パッチ適用済み ({{ic|1=--enable-infinality=yes}}) の '''OpenJDK7''' は {{AUR|jre7-openjdk-infinality}} でインストールできます。
* パッチ適用済みの '''OpenJDK8''' は {{AUR|jre8-openjdk-infinality}} でインストールできます ([[非公式ユーザーリポジトリ#infinality-bundle|Infinality 非公式リポジトリ]]からインストールすることも可能です)。
パッチを適用したバージョンでは fontconfig と freetype の [[Infinality]] パッチを上手く混ぜ合わせています。標準の {{Pkg|fontconfig}} API を使用しているため {{AUR|fontconfig-infinality}} に依存はしていません。

==フォント選択==

===TrueType フォント===
Java アプリケーションによっては特定の TrueType フォントを使用するよう選択できたりしますが、こういったアプリケーションは使用したいフォントのディレクトリパスを指定できるようになっています。TrueType フォントは {{ic|/usr/share/fonts/TTF}} ディレクトリにインストールされます。次の行を {{ic|/etc/environment}} に追加してフォントを有効にしてください。
JAVA_FONTS=/usr/share/fonts/TTF

変更を適用するには再ログインする必要があります。

===文字化けの修正 (JRE8)===
以下のディレクトリにフォントファイルを配置してください。ディレクトリが存在しない場合は作成してください。

/usr/lib/jvm/java-8-openjdk/jre/lib/fonts/fallback/

アドホックネットワーク

2016-08-19T17:49:26Z

Colajam93: Fix typo

[[Category:無線ネットワーク]]
[[en:Ad-hoc networking]]
[[zh-CN:Ad-hoc networking]]
{{Related articles start}}
{{Related|ネットワーク設定}}
{{Related|ワイヤレス設定}}
{{Related|ソフトウェアアクセスポイント}}
{{Related|インターネット共有}}
{{Related articles end}}
IBSS (Independent Basic Service Set) ネットワーク (アドホックネットワークとも呼ばれます) は中央制御を必要としない、ワイヤレスで互いに通信するための通信方式です。直接一対一で通信を行う、P2P ネットワークの一例です。

アドホックネットワークを使うことで、[[インターネット共有|インターネット接続の共有]]などが行えます。

== 要件 ==

* ネットワークに接続する全てのデバイスに [https://wireless.wiki.kernel.org/en/users/drivers nl80211] 対応の無線デバイスが必要です (例: ath9k)。

== Wifi リンク層 ==

IBSS ネットワークはピアツーピアネットワークなので、必要な wifi リンクの設定は全てのデバイスで共通です。

{{Tip|複雑なネットワークトポロジーを作成することも可能です。高度な例については [http://wireless.kernel.org/en/users/Documentation/iw/vif Linux Wireless documentation] を見て下さい。}}

=== 手動設定 ===

{{Warning|以下の方法では暗号化がないアドホックネットワークを作成します。WPA 暗号を使用する方法は [[#WPA supplicant]] を見て下さい。}}

以下で使っているコマンドの詳しい説明は[[ワイヤレス設定#手動セットアップ]]を見て下さい。また、{{Pkg|iw}} を[[pacman|インストール]]しておいてください。

動作モードを ibss に設定:

# iw ''interface'' set type ibss

インターフェイスを立ち上げる ({{ic|rfkill unblock wifi}} などの設定が必要になる場合もあります):

# ip link set ''interface'' up

これでアドホックネットワークを作成することができます。''your_ssid'' はネットワークの名前に、''frequency'' は使用したい周波数 (MHz) に置き換えて下さい。使用できる周波数の表が Wikipedia の [[Wikipedia:List_of_WLAN_channels#Interference_Concerns|List of WLAN channels]] ページに載っています。

# iw ''interface'' ibss join ''your_ssid'' ''frequency''

=== WPA supplicant ===

{{Note|以下の方法では WPA 暗号を使用するアドホックネットワークを作成します。2013年8月現在 WPA2 はサポートされていません。}}

{{Pkg|wpa_supplicant}} を[[pacman|インストール]]して、設定ファイルを作成してください (詳しくは [[WPA supplicant]] を参照):

{{hc|/etc/wpa_supplicant-adhoc.conf|<nowiki>
ctrl_interface=DIR=/run/wpa_supplicant GROUP=wheel

# use 'ap_scan=2' on all devices connected to the network
ap_scan=2

network={
ssid="MySSID"
mode=1
frequency=2432
proto=WPA
key_mgmt=WPA-NONE
pairwise=NONE
group=TKIP
psk="secret passphrase"
}
</nowiki>}}

以下のコマンドを使って、ネットワークに接続する全てのデバイスで ''wpa_supplicant'' を起動します:

# wpa_supplicant -B -i ''interface'' -c /etc/wpa_supplicant-adhoc.conf -D nl80211,wext

== ネットワーク設定 ==

最後に IP アドレスをネットワーク上の全てのデバイスに割り当てます。複数の方法が存在します:

* 固定 IP アドレスを割り当てる。詳しくは[[ネットワーク設定#固定 IP アドレス]]を見て下さい。
* デバイスのどれかで DHCP サーバーを動かす。詳しくは [[dhcpd]] や [[dnsmasq]] を見て下さい。
* ''avahi-autoipd'' を動かす。詳しくは [[Avahi#IPv4LL IP アドレスの取得]] を見て下さい。

アドホックネットワークでインターネット接続を共有したい場合、[[インターネット共有]]を見て下さい。

== Tips and tricks ==

=== NetworkManager を使う ===

[[NetworkManager]] を使っている場合、上記のように手動で設定する代わりに ''nm-applet'' を使ってアドホックネットワークの設定ができます。詳しくは [[NetworkManager#Ad-hoc]] を見て下さい。

{{Note|NetworkManager はアドホックモードでの WPA 暗号化をサポートしていません。}}

=== カスタム systemd サービス (wpa_supplicant と固定 IP) ===

以下のテンプレートを使うことで無線アドホックネットワークを使うことができます:

{{hc|/etc/conf.d/network-wireless-adhoc@<interface>|<nowiki>
addr=192.168.0.2
mask=24
</nowiki>}}

{{hc|/etc/systemd/system/network-wireless-adhoc@.service|<nowiki>
[Unit]
Description=Ad-hoc wireless network connectivity (%i)
Wants=network.target
Before=network.target
BindsTo=sys-subsystem-net-devices-%i.device
After=sys-subsystem-net-devices-%i.device

[Service]
Type=oneshot
RemainAfterExit=yes
EnvironmentFile=/etc/conf.d/network-wireless-adhoc@%i

# perhaps rfkill is not needed for you
ExecStart=/usr/bin/rfkill unblock wifi
ExecStart=/usr/bin/ip link set %i up
ExecStart=/usr/bin/wpa_supplicant -B -i %i -D nl80211,wext -c /etc/wpa_supplicant-adhoc.conf
ExecStart=/usr/bin/ip addr add ${addr}/${mask} dev %i

ExecStop=/usr/bin/ip addr flush dev %i
ExecStop=/usr/bin/ip link set %i down

[Install]
WantedBy=multi-user.target
</nowiki>}}

== 参照 ==

* [https://help.ubuntu.com/community/WifiDocs/Adhoc Ubuntu community wiki WifiDocs/Adhoc]
* [http://www.ubuntugeek.com/creating-an-adhoc-host-with-ubuntu.html Manual about creating an Ad-Hoc network on UbuntuGeek]
* [http://go2linux.garron.me/linux/2011/03/share-your-3g-internet-connection-over-wifi-linux-ipod-touch-925 Share your 3G Internet connection over wifi]

Electron

2016-08-19T13:59:02Z

Colajam93: パッケージへのリンクを公式リポジトリのものに変更

[[Category:開発]]
[[en:Electron]]
{{Related articles start}}
{{Related|Node.js}}
{{Related articles end}}

[http://electron.atom.io/ Electron] (旧名 Atom Shell) は GitHub によって開発されたアプリケーションで、ウェブ技術を使用してクロスプラットフォームのデスクトップアプリを作成することができます。Electron によって作成された最も有名なデスクトップアプリの例としては [[Atom]] テキストエディタが存在します。

== インストール ==

Electron は以下のパッケージでインストールできます:

* 公式リポジトリの {{Pkg|electron}} パッケージ
* 非公式の [[非公式ユーザーリポジトリ#atom|atom]] リポジトリの ''electron'' パッケージ: 別の [https://github.com/tensor5/arch-atom/blob/master/README.md#build-method ビルド方法] を使っています。

Django

2016-08-12T15:08:03Z

Colajam93: データベースドライバについて同期

[[Category:開発]]
[[en:Django]]
[[fr:Django]]
[http://www.djangoproject.com Django] は model–view–template (MVT) デザインパターンに従っている高水準な [[Python]] ウェブフレームワークです。

== インストール ==

現在[[公式リポジトリ]]には2つの Django パッケージが存在します。以下のパッケージで[[Pacman|インストール]]することができます:
* {{Pkg|python-django}} - 最新の python に対応。ドキュメントは [[AUR]] の {{aur|django-docs}} パッケージ。
* {{Pkg|python2-django}} - Python 2 に対応。

=== データベースドライバ ===

[[MySQL]] / MariaDB データベースをバックエンドとして使うつもりなら、{{aur|python-mysqlclient}} パッケージをインストールしてください。

== 使用方法 ==

Django プロジェクトを開始するには、{{ic|django-admin}} コマンドを使います:
$ django-admin startproject mysite

上記のコマンドでカレントディレクトリに ''mysite'' ディレクトリが作成されます。また、プロジェクトを管理するための ''manage.py'' スクリプトも作成されます。

詳しくは [https://docs.djangoproject.com/en/1.8/intro/tutorial01/ Django 公式チュートリアル] や [https://docs.djangoproject.com/en/ Django ドキュメント] を見てください。

I3

2016-06-24T04:50:34Z

Colajam93: /* i3status */

{{DISPLAYTITLE:i3}}
[[Category:タイル型ウィンドウマネージャ]]
[[Category:動的ウィンドウマネージャ]]
[[en:i3]]
[[ko:I3]]
[[ru:I3]]
[[zh-CN:I3]]
{{Related articles start}}
{{Related|デスクトップ環境}}
{{Related|ディスプレイマネージャ}}
{{Related|ファイルマネージャの機能}}
{{Related|ウィンドウマネージャ}}
{{Related|タイル型ウィンドウマネージャの比較}}
{{Related|クリップボード}}
{{Related|自動起動#グラフィカル}}
{{Related articles end}}

[http://i3wm.org/ i3] は [[wmii]] にインスパイアされて開発された動的[[Wikipedia:ja:タイル型ウィンドウマネージャ|タイル型ウィンドウマネージャ]]で、主に開発者や上級ユーザーをターゲットにしています。

i3 が公表している目標は、わかりやすいドキュメント、適切なマルチモニタサポート、ウィンドウのツリー構造、[[vim]] のような様々なモードなどです。

== インストール ==

[[公式リポジトリ]]から {{Grp|i3}} [[Pacman#パッケージグループのインストール|パッケージグループ]]を[[インストール]]してください。このグループにはウィンドウマネージャの {{Pkg|i3-wm}} と、[[Wikipedia:ja:標準ストリーム#標準出力 (stdout)|標準出力]]によってステータスラインに書き込みを行う {{Pkg|i3status}}、そして画面ロッカーの {{Pkg|i3lock}} が含まれています。

追加のパッケージは [[Arch User Repository]] から利用可能です。例は [[#パッチ|パッチ]] セクションを見てください。

=== ディスプレイマネージャ ===

{{Pkg|i3-wm}} はウィンドウマネージャを起動する [[Xsession]] として {{ic|i3.desktop}} を含んでいます。
{{ic|i3-with-shmlog.desktop}} はログを有効にします (デバッグに役立ちます)。
{{AUR|i3-gnome}} は {{ic|i3}} を [[GNOME]] に統合します。

=== xinitrc ===

[[xinitrc]] を編集して、次の行を追加してください:

exec i3

i3 からの出力を記録したいときは、代わりに次の行を追加してください:

exec i3 -V >> ~/.config/i3/i3log-$(date +'%F-%k-%M-%S') 2>&1

キーのマッピングに問題が起こるときは (例: セミコロンの {{ic|;}})、{{Pkg|xorg-xev}} を使うか、または[[特別なキーボードキー]]を見て下さい。

$ xev | grep -A2 --line-buffered '^KeyRelease' | sed -n '/keycode /s/^.*keycode $[0-9]*$.* (.*, $.*$).*$/\1 \2/p'

== 使用方法 ==

詳しい情報は [http://i3wm.org/docs 公式のドキュメント]、すなわち [http://i3wm.org/docs/userguide.html i3 User’s Guide] を見て下さい。

=== キーバインド ===

i3 では修飾キー ({{ic|$mod}} と表記されます) を使ってコマンドを呼び出します。デフォルトでは {{ic|Alt}} (Mod1) ですが、{{ic|Super}} (Mod4) も良く使われます。大抵のキーボードでは Super は Windows アイコンが印されたキーになります。Apple キーボードなら Command キーです。

デフォルトのキーバインドについては [http://i3wm.org/docs/refcard.html i3 リファレンスカード] や [http://i3wm.org/docs/userguide.html#_using_i3 Using i3] を見て下さい。新しくショートカットを追加する方法は [http://i3wm.org/docs/userguide.html#keybindings Keyboard bindings] に載っています。

Qwerty 以外のキーボード配列を使っている場合は[[#設定ウィザードとキーボードレイアウト|設定ウィザードとキーボードレイアウト]]に書かれているように設定ウィザードを迂回すると良いでしょう。

=== コンテナ ===

i3 はコンテナを基本単位としたツリー構造でウィンドウを管理します。この構造は縦や横に分岐していきます。デフォルトではコンテナはタイル状に並べられますが、タブでまとめたり積み重ねるレイアウトに設定したり、フロートさせることもできます (ダイアログウィンドウのように)。フローティングウィンドウは常に一番上に表示されます。

詳しくは [http://i3wm.org/docs/userguide.html#_tree i3 Tree] や [http://www.youtube.com/watch?v=AWA8Pl57UBY Containers and the tree data structure] を見て下さい。

=== アプリケーションランチャー ===

i3 はアプリケーションランチャーとして [[dmenu]] を使っており、デフォルトでは {{ic|$mod+d}} で呼び出せます。dmenu の代わりに、透過機能や xft フォントのサポートなどが搭載されている AUR の {{AUR|dmenu2}} を使うこともできます。

{{Pkg|i3-wm}} には ''dmenu'' の [[Wikipedia:ja:Perl|Perl]] ラッパーである ''i3-dmenu-desktop'' が含まれており、[[デスクトップエントリ]]を利用してインストールされている全てのアプリケーションのリストを作成します。また、{{AUR|j4-dmenu-desktop-git}} パッケージを使うこともできます。こちらは ''i3-dmenu-desktop'' とほぼ同様に使える上に、高速に動作します [https://github.com/enkore/j4-dmenu-desktop/blob/master/README.md]。

== 設定 ==

詳しくは [http://i3wm.org/docs/userguide.html#configuring Configuring i3] を参照。この記事では ''i3'' の設定ファイルは {{ic|~/.config}} に置くことにします (''i3-config-wizard'' では {{ic|~/.i3/config}} に作成されます)。

=== 設定ウィザードとキーボードレイアウト ===

''i3'' を最初に起動したとき、設定ウィザードの ''i3-config-wizard'' が実行されます。このツールは {{ic|/etc/i3/config.keycodes}} にあるテンプレート設定ファイルを書き換えることで {{ic|~/.i3/config}} を作成します。デフォルトテンプレートには以下の2つの変更が加えられます:

# ウィザードはデフォルトの修飾キーを何にするかユーザーに尋ねます。{{ic|set $mod Mod1}} のような行がテンプレートに追加されます。
# ユーザーの現在のキーボードレイアウトにあわせて ''bindcode'' 行をすべて ''bindsym'' 行で置き換えます。

後者が実行されることで、4つのナビゲーションショートカット {{ic|j}}, {{ic|k}}, {{ic|l}} と Qwerty キーボードの"セミコロン"が正しいキーシムにマッピングされます。例えば [[Dvorak]] キーボードなら {{ic|h}}, {{ic|t}}, {{ic|n}}, {{ic|s}} になります。ただし副作用として他のキーシムのマッピングが変更されるため Dvorak ユーザーはむしろ混乱してしまうかもしれません。"再起動"は {{ic|$mod1+r}} ではなく {{ic|$mod1+p}} に、"横に分割"は {{ic|$mod1+h}} ではなく {{ic|$mod1+d}} にバインドされます。チュートリアルに記載されているバインドと同じ、覚えやすいキーバインドを使いたい場合は {{ic|/etc/i3/config}} を {{ic|~/.config/i3/config}} (または {{ic|~/.i3/config}}) にコピーしてください。

キーボードレイアウトを頻繁に変更するユーザーなどに対応するために、キーコードによる設定も可能です。

=== カラースキーム ===

設定ファイルを使ってウィンドウ装飾の色をカスタマイズすることができますが、構文のためにテーマを作成したり共有するのは現実的ではありません。ユーザーが様々なテーマを作るのを楽にさせるプロジェクトが複数存在します。

* {{App|i3-style|JSON オブジェクトで保存されたテーマによって所定の設定を変更します。テーマは何度もカラースキームを調整・修正できるように作られています。|https://github.com/acrisci/i3-style|{{Aur|nodejs-i3-style}}}}
* {{App|j4-make-config|あなたの設定をテーマのコレクションや個人用の設定パーツ (たとえばホスト用の設定) と組み合わせます。テーマの簡単な変更や、柔軟でダイナミックな設定のカスタマイズを可能にします。|https://github.com/okraits/j4-make-config|{{Aur|j4-make-config-git}}}}

=== i3bar ===

i3bar はワークスペースの情報を表示するほかに、次のセクションで説明している、i3status などに入力を行うこともできます。例:

{{hc|~/.config/i3/config|2=
bar {
output LVDS1
status_command i3status
position top
mode hide
workspace_buttons yes
tray_output none

font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1

colors {
background #000000
statusline #ffffff

focused_workspace #ffffff #285577
active_workspace #ffffff #333333
inactive_workspace #888888 #222222
urgent_workspace #ffffff #900000
}
}
}}

詳しくは [http://i3wm.org/docs/userguide.html#_configuring_i3bar Configuring i3bar] を見て下さい。

==== i3bar の代替 ====

旧来の[[デスクトップ環境]]に入っているようなパネルを使いたいというユーザーもいるかもしれません。起動時に i3 の中でパネルアプリケーションを起動することで他のパネルを使うことができます。

[[Xfce#パネル|XFCE パネル]]の場合、次の行を {{ic|~/.config/i3/config}} のどこかに追加してください:

exec --no-startup-id xfce4-panel --disable-wm-check

{{Note|[[デスクトップ環境]]固有のパネル機能は基本的に動作しません (例: ワークスペースやセッションを管理するウィジェット)、ただし i3 の機能がそれによって影響を受けることはないはずです。}}

{{ic|~/.config/i3/config}} の {{ic|<nowiki>bar{ }</nowiki>}} セクションをコメントアウトすることで i3bar は無効にできます。
もしくは以下を使ってください:

{{hc|~/.config/i3/config|
# bar toggle, hide or show
bindsym $mod+m bar mode toggle
}}

この方法では好きなようにバーを表示したり隠したりできます。

=== i3status ===

デフォルトの設定ファイルをホームディレクトリにコピーしてください:

$ cp /etc/i3status.conf ~/.config/i3status/config

デフォルトの設定では定義されていないプラグインがあり、いくつかの設定はあなたのシステムでは無効かもしれません。
そのためシステムに応じて設定を更新する必要があります。詳しくは {{ic|man 1 i3status}} を見て下さい。

==== i3status の代替 ====

* {{App|[[conky]]|拡張性の高いシステムモニター。i3bar で使用する場合は [http://i3wm.org/docs/user-contributed/conky-i3bar.html このチュートリアル] を見て下さい。|https://github.com/brndnmtthws/conky|{{Pkg|conky}}}}
* {{App|i3blocks|シェルスクリプトで拡張することができます。クリックイベントや割り込み、ブロックごとによるリフレッシュ間隔の定義などを管理可能。|https://github.com/vivien/i3blocks|{{AUR|i3blocks}}}}
* {{App|i3phtatus|PHP で書かれた i3status の代替。簡単に拡張できます。|https://github.com/mwgg/i3phtatus}}
* {{App|goi3bar|Go で書かれた i3status の代替。コンポーネントを自由にアップデートすることができます。|https://github.com/denbeigh2000/goi3bar}}
* {{App|i3pystatus|デフォルトで多数のプラグインと設定オプションがある拡張可能な Python 3 ステータスバー。|https://github.com/enkore/i3pystatus i3pystatus|{{AUR|i3pystatus-git}}}}
* {{App|i3situation|もうひとつの Python 3 ステータスバージェネレータ。|https://github.com/HarveyHunt/i3situation|{{Aur|i3situation-git}}}}
* {{App|j4status|C で書かれており、プラグインで設定ができる、ステータスラインを提供します。追加プラグインは {{Aur|j4status-plugins-git}} に入っています。|http://j4status.j4tools.org/|{{Aur|j4status-git}}}}

==== i3status のラッパー ====

* {{App|[[en2:h2status|h2status]]|i3status の Bash ラッパー、カスタム json エントリを入力として、非同期のステータスバーの更新だけでなくクリックイベントの処理が可能。|https://wiki.archlinux.org/index.php/H2status|{{Aur|h2status}}}}
* {{App|i3cat|[[go]] ベースのラッパーで外部の複数のソースからの入力を繋げることができます。クリックイベントの処理、ユーザーが定義した信号を子プロセスに転送することが可能。|http://vincent-petithory.github.io/i3cat/|{{AUR|i3cat-git}}}}
* {{App|py3status|Python による拡張可能な i3status ラッパー。|https://github.com/ultrabug/py3status|{{Aur|py3status}}}}

==== ステータスバーにアイコンフォント ====

''i3bar'' には XBM アイコンサポートの[[#パッチ|パッチ]]をあてることができますが、代わりにアイコンフォントを使うこともできます。

* {{App|ttf-font-awesome|CSS でカスタマイズできるスケーラブルなベクターアイコン。それぞれの記号の Unicode を記した [http://fortawesome.github.io/Font-Awesome/cheatsheet/ チートシート] があります。|http://fortawesome.github.io/Font-Awesome/|{{AUR|ttf-font-awesome}}}}
* {{App|ttf-font-icons|Awesome と Ionicons の重複をなくしてサイズを合わせたミックス。DejaVu Sans と Awesome が重複しないようにします。|http://kageurufu.net/icons.pdf|{{AUR|ttf-font-icons}}}}

フォントを混ぜ合わせるには、設定ファイルにフォントのフォールバックを定義してください、以下のように {{ic|,}} でフォントを区切ります:
{{hc|~/.config/i3/config|2=
bar {
...
font pango:DejaVu Sans Mono, Icons 8
...
}
}}

[https://developer.gnome.org/pango/stable/pango-Fonts.html#pango-font-description-from-string pango syntax] に従って、カンマで区切ったフォントファミリーのリストを記述してそれから一番後ろにサイズをひとつだけ指定してください。
各フォントにサイズを設定するのは最後のフォントを除いて無視される原因となります。

最後に、アイコングラフをフォーマット文字列にして {{ic|~/.config/i3status/config}} に入力します。入力するために、上でリンクしているチートシートを見てユニコード番号を使います。入力方法はテキストエディタによって異なります。例えば "ハート" アイコン (ユニコード番号 f004) を入力するには:

* 様々な GUI のテキストエディタ (例: [[gedit]] や Leafpad) とターミナル (例: GNOME Terminal, xfce4-terminal): {{ic|ctrl+shift+u}}, {{ic|f004}}, {{ic|Enter}}
* [[Emacs]]: {{ic|ctrl+x}}, {{ic|8}}, {{ic|Enter}}, {{ic|f004}}, {{ic|Enter}}
* [[Vim]] (挿入モード): {{ic|Ctrl+v}}, {{ic|uf004}}
* [[urxvt]]: {{ic|Ctrl+Shift}} を押して、{{ic|f004}} を入力

=== ターミナルエミュレータ ===

デフォルトでは {{ic|$mod+Return}} を押すとターミナルを呼び出すスクリプトの {{ic|i3-sensible-terminal}} が起動します。ターミナルを呼び出す順番については {{ic|man i3-sensible-terminal}} を見て下さい。

他のターミナルを起動するには、{{ic|~/.config/i3/config}} の次の行を変更してください:

bindsym $mod+Return exec i3-sensible-terminal

または、{{ic|$TERMINAL}} 変数を[[環境変数#ユーザーごと|ローカルで定義]]してください:

$ export TERMINAL=''yourterminal''

== Tips and tricks ==

=== 高度なウィンドウナビゲーション ===

[http://www.slackword.net/?p=657 i3 window Navigation Tips] を見て下さい。

=== Jump to open window ===

*{{App|quickswitch-i3|i3 でウィンドウを素早く切り替え・確認するための Python ユーティリティ。|https://github.com/proxypoke/quickswitch-for-i3|{{Aur|quickswitch-i3}}}}
*{{App|i3-wm-scripts|正規表現にマッチする名前を持ったウィンドウを検索してジャンプ。|https://github.com/yiuin/i3-wm-scripts||}}
*{{App|winmenupy|クライアントのリストと一緒に dmenu を起動、ワークスペースの後にソートされます。クライアントを選択するとそのウィンドウにジャンプ。|https://github.com/ziberna/i3-py/blob/master/examples/winmenu.py||}}
*{{App|rofi|スクラッチパッドウィンドウを検索してジャンプして開く。|https://davedavenport.github.io/rofi/|{{Pkg|rofi}}}}

=== Jump to urgent window ===

{{ic|.i3/config}} に次を追加: [https://faq.i3wm.org/question/853/how-to-jump-to-urgent-workspace/]

bindsym $mod+x [urgent=latest] focus

=== ウィンドウレイアウトの保存と復元 ===

バージョン 4.8 から、''i3'' ワークスペースレイアウトの保存・復元が可能になっています。これを行うには、次のパッケージが必要です: [[公式リポジトリ]]から {{Pkg|perl-anyevent-i3}} と {{Pkg|perl-json-xs}}。

{{note| This section only provides quick tutorial on how to save the current window layout of a single workspace and how to restore it for later use. Refer to the [http://i3wm.org/docs/layout-saving.html official documentation] for more details}}

==== Save the current window layout of a single workspace ====

To save the current window layout, follow these steps:

# First, execute various commands to open windows in a preferred workspace and resize them if needed. Make sure to write down each executed command for each window.
# Now, in a new workspace, open a terminal and run the following: {{bc|i3-save-tree --workspace N > ~/.i3/workspace_N.json}} where N is the number of the preferred workspace. This will save the current layout of workspace N to the file {{ic|~/.i3/workspace_N.json}}.
# The newly created file needs to be edited, however this may be done with the following commands: {{bc|<nowiki>tail -n +2 ~/.i3/workspace_N.json | fgrep -v '// splitv' | sed 's|//||g' > ~/.i3/workspace_N.json</nowiki>}}

==== Restore the window layout of the workspace ====

There are two ways to restore the layout of the workspace: by writing a script, or by editing {{ic|~/.i3/config}} to automatically load the layout. In this section only the first case will be considered, refer to the [http://i3wm.org/docs/layout-saving.html#_restoring_the_layout official documentation] for the second case.

To restore the saved layout in the previous section, write a file named {{ic|load_layout.sh}} with the following contents:

* The starting lines:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"
}}

where M is the number of the workspace in which you would like to load the previously saved layout and N is the number of workspace saved in the previous section.
* And the commands used in the previous section to get the preferred windows, but enclosed in parentheses and with an ampersand appended before the last parentheses.

For example, if the saved layout contained three {{ic|uxterm}} windows:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash

# First we append the saved layout of worspace N to workspace M
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"

# And finally we fill the containers with the programs they had
(uxterm &)
(uxterm &)
(uxterm &)
}}

Then set the file as executable:

chmod u+x ~/load_layout.sh

And finally, the layout of worskpace N can be loaded onto to workspace M by running:

~/load_layout.sh

{{tip|Adding {{ic|bindsym $mod+g exec ~/load_layout.sh}} to {{ic|~/.i3/config}} and restarting i3 will bind Mod+g to run the above script.}}

{{note|If the above script does not work properly, refer to the [http://i3wm.org/docs/layout-saving.html#_editing_layout_files official documentation]. The ''swallows'' sections of {{ic|~/.i3/workspace_N.json}} needs to be manually edited.}}

=== スクラッチパッドコンテナ ===

デフォルトでは、[http://i3wm.org/docs/userguide.html#_scratchpad スクラッチパッド] は一つのウィンドウしか含んでいません。しかしながら、コンテナをスクラッチパッドにすることが可能です。

新しいコンテナを作成して (例えば、{{ic|Mod+Enter}})、コンテナを分割し ({{ic|Mod+v}}) 別のコンテナを作成します。親にフォーカスして ({{ic|Mod+a}})、反対方向に分割し ({{ic|Mod+h}})、もう一度作成します。

最初のコンテナにフォーカスして (必要なら親にもフォーカス)、ウィンドウをフロートさせ ({{ic|Mod+Shift+Space}})、スクラッチパッドに移動します ({{ic|Mod+Shift+-}})。これで自由にコンテナを分割できます。

{{Note|フロートしているウィンドウでコンテナのサイズを個別に変更することはできません。ウィンドウをフロートさせる前にコンテナのサイズを変えて下さい。}}

{{Tip|ターミナルアプリケーションしか使わない場合は、代わりに [[tmux]] などのマルチプレクサを使っても良いでしょう。}}

マルチスクラッチパッドについては [https://faq.i3wm.org/question/138/multiple-scratchpad/i3] も参照してください。

=== スクリーンセーバーと電源管理 ===

With [[電源管理#xss-lock]] you can register a screenlocker for your i3 session.

Alternatively, ''xautolock'' can lock the screen after awakening from sleep or hibernation with the {{ic|-lockaftersleep}} option. The {{ic|-time}} option locks the screen after a given time period.

xautolock -time 10 -locker "i3lock -i 'background_image.png'" -lockaftersleep &

See also [[DPMS]].

=== シャットダウン, 再起動, 画面ロック ===

シャットダウン、再起動、画面ロックのキーコンビネーションを {{ic|~/.config/i3/config}} に追加することができます。以下の例では[[systemd#電源管理|電源管理]]コマンドを実行する権限がないユーザーに権限を与えるために {{Pkg|polkit}} をインストールする必要があります。

{{bc|
set $Locker i3lock && sleep 1

set $mode_system System (l) lock, (e) logout, (s) suspend, (h) hibernate, (r) reboot, (Shift+s) shutdown
mode "$mode_system" {
bindsym l exec --no-startup-id $Locker, mode "default"
bindsym e exec --no-startup-id i3-msg exit, mode "default"
bindsym s exec --no-startup-id $Locker && systemctl suspend, mode "default"
bindsym h exec --no-startup-id $Locker && systemctl hibernate, mode "default"
bindsym r exec --no-startup-id systemctl reboot, mode "default"
bindsym Shift+s exec --no-startup-id systemctl poweroff -i, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}

bindsym $mod+Pause mode "$mode_system"
}}

追加したら {{ic|$mod+pause}} を押すことでプロンプトが表示されます。より複雑な動作の為には、スクリプトに分離し、mode の中で参照してください。[https://gist.github.com/anonymous/c8cd0a59bf4acb273068]

{{Note|1=<br>
* {{ic|sleep 1}} は小さなディレイを追加することで、サスペンドにより起こりうる競合状態を防ぎます。[https://bugs.launchpad.net/ubuntu/+source/unity-2d/+bug/830348]
* {{ic|systemctl poweroff}} への {{ic|-i}} 引数は、たとえ他のユーザーがログインしていたり (これは {{Pkg|polkit}} を必要とします)、''logind'' が (誤って) そのように認識していてもシャットダウンを行います。[https://bugs.freedesktop.org/show_bug.cgi?id=62676]
}}

他の画面ロッカーについては、[[アプリケーション一覧/セキュリティ#スクリーンロック]]を参照。

===External displays manual management===

Thanks to [[xrandr]] there are many ways to easily manage systems displays. The below example integrates it in the i3 config file, and behave as the Power Management section above.

Here a laptop with both VGA and HDMI outputs will use a menu selection to switch them On/Off:

## Manual management of external displays
# Set the shortcuts and what they do
set $mode_display Ext Screen (v) VGA ON, (h) HDMI ON, (x) VGA OFF, (y) HDMI OFF
mode "$mode_display" {
bindsym v exec --no-startup-id xrandr --output VGA1 --auto --right-of LVDS1, mode "default"
bindsym h exec --no-startup-id xrandr --output HDMI1 --auto --right-of LVDS1, mode "default"
bindsym x exec --no-startup-id xrandr --output VGA1 --auto --off, mode "default"
bindsym y exec --no-startup-id xrandr --output HDMI1 --auto --off, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}
# Declare here the shortcut to bring the display selection menu
bindsym $mod+x mode "$mode_display"

Any window that is still open in a switched Off display will automatically come back to the remaining active display.

The simplest way to determine names of your devices is to plug the device you wish to use and run:

$ xrandr --query

which will output the available, recognized devices and their in-system names to set your config file appropriately.

Refer to the [[xrandr]] page or man page for the complete list of available options, the [http://i3wm.org/docs/userguide.html i3 userguide] and/or the [https://www.reddit.com/r/i3wm i3 FAQ on reddit] for more info.

=== タブまたはスタックによるウェブブラウジング ===

タブの管理はブラウザの仕事ではなく、ウィンドウマネージャの仕事だとして、故意にタブを実装していないウェブブラウザというのが存在します。

[[uzbl]] など、タブのないウェブブラウザを i3 で管理するには、次の行を {{ic|~/.config/i3/config}} に追加して下さい:

for_window [class="Uzbl-core"] focus child, layout stacking, focus

これはスタックのウェブブラウジング用で、ウィンドウは縦に表示されます。タブブラウジングと違って、たとえブラウザのウィンドウを大量に開いていても、ウィンドウのタイトルを全て見ることができます。

水平方向のタブブラウジングの方が良い場合は ('タブ')、次を使って下さい:

for_window [class="Uzbl-core"] focus child, layout tabbed, focus

=== ワークスペース変数 ===

i3 ではワークスペースを複数定義するので、ワークスペース変数を指定すると便利です。例えば [https://github.com/dkeg/bloat2.0/blob/master/i3config#L55]:

set $WS1 term
set $WS2 web
set $WS3 misc
set $WS4 media
set $WS5 code

次にワークスペースの名前を対応する変数で置き換えます:

bindsym $mod+1 workspace $WS1
...
bindsym $mod+Shift+1 move container to workspace $WS1

詳しくは [http://i3wm.org/docs/userguide.html#_changing_named_workspaces_moving_to_workspaces Changing named workspaces] を見て下さい。

=== フロートするダイアログを正しく扱う ===

デフォルトではダイアログはフロートモードで開かれることになっていますが [http://i3wm.org/docs/userguide.html#_floating]、ダイアログはタイルモードで開いてしまうこともあります。この挙動を変更するには {{pkg|xorg-xprop}} でダイアログの {{ic|WM_WINDOW_ROLE}} をチェックして適切なルールを {{ic|~/.i3/config}} に追加してください:

for_window [window_role="pop-up"] floating enable
for_window [window_role="task_dialog"] floating enable

また、タイトルルールと正規表現を使うこともできます:

for_window [title="Preferences$"] floating enable

または {{ic|WM_CLASS}}:

for_window [class="(?i)mplayer"] floating enable

=== ネットワークのダウンロード・アップロード速度をステータスバーに表示 ===

上流の [http://code.stapelberg.de/git/i3status/tree/contrib/measure-net-speed.bash スクリプト] を編集します。

* システムに応じて両方のネットワークカードをリネームしてください ({{ic|ip addr}} を使ってください)
* {{ic|/sys/devices}} にあるそれらを見つけて適切に置き換えます:
$ find /sys/devices -name ''network_interface''

{{Tip|PCI の位置に依存しない為に {{ic|/sys/class/net/''interface''/statistics/}} を使います。}}

スクリプトを適切な場所 (例: {{ic|~/.config/i3}}) に保存して、ステータスプログラムから指してください。

== パッチ ==

上流にマージされてないパッチがあてられたパッケージが [[AUR]] には存在します:

* {{App|i3bar-icons-git|i3bar で XBM アイコンを表示|https://github.com/ashinkarov/i3-extras|{{AUR|i3bar-icons-git}}}}
* {{App|i3-smart-border|スマートボーダー|https://github.com/ashinkarov/i3-extras|{{AUR|i3-smart-border}}}}
* {{App|i3-wm-iconpatch|タイトルバーアイコンのサポート|https://github.com/ashinkarov/i3-extras|{{AUR|i3-wm-iconpatch}}}}

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

=== 一般 ===

多くの場合、バグは開発版である {{AUR|i3-git}} と {{AUR|i3status-git}} で修正されているため上流では開発版を使ってエラーが再現できるかどうか訊いてきます。 [http://i3wm.org/docs/debugging.html] [[デバッグ - トレースを取得#一般]]も見てください。

=== i3 メッセージバーのボタンが動作しない ===

{{ic|i3-nagbar}} の "Edit config" などのボタンは {{ic|i3-sensible-terminal}} を呼び出します。[[#ターミナルエミュレータ|ターミナルエミュレータ]]が i3 によって認識されていることを確認してください。

=== タイル化されたターミナルで行の折り返しがおかしい ===

i3 v4.3 以上ではタイル配置したウィンドウのサイズ増加ヒントは無視されます [https://www.mail-archive.com/i3-discuss@i3.zekjur.net/msg00709.html]。これによってターミナルで行が早いところで折り返されてしまうなどの問題が生じます。解決方法としては、問題のウィンドウをフロートさせてから、もう一度タイル化してください。

=== マウスカーソルが待機状態のままになる ===

起動通知をサポートしていないスクリプやアプリケーションを起動すると、マウスカーソルは60秒間の間、ビジー/砂時計状態になります。

特定のアプリケーションでこの問題を解決するには、{{ic|--no-startup-id}} パラメータを使って下さい、例えば:
exec --no-startup-id ~/script
bindsym $mod+d exec --no-startup-id dmenu_run

このアニメーションを全てのアプリケーションで無効にするには、[[カーソルテーマ]]を見て下さい。

=== キーバインドが反応しない ===

標準のキーバインド (キーを押して実行) を使っている場合、[[スクリーンショットの取得#scrot|scrot]] などのツールが動作しないことがあります。そのようなときは、{{ic|--release}} でキーをリリースしてからコマンドを実行してください:

bindsym --release Print exec --no-startup-id scrot '%Y-%m-%d$
bindsym --release Shift+Print exec --no-startup-id scrot '%Y$

[http://i3wm.org/docs/userguide.html#keybindings] を参照。

=== ティアリング ===

i3 は [http://bugs.i3wm.org/report/ticket/661 ダブルバッファをちゃんと実装していない] ためにティアリングやちらつきが発生することがあります。問題を修正したいときは、[[Xorg#コンポジット|コンポジットマネージャ]]を使ってみて下さい。

=== トレイアイコンが表示されない ===

デフォルトの {{ic|tray_output primary}} ディレクティブでは ''xrandr'' でプライマリ出力を設定する必要があります。明示的に出力を指定するか、ディレクティブを削除してください [https://github.com/i3/i3/issues/1144]。詳しくは [[Xrandr]] を参照。i3 のバージョン 4.12 から、i3-config-wizard によって作成されるデフォルト設定ではディレクティブが追加されないようになりました。

== 参照 ==

* [http://i3wm.org 公式ウェブサイト]
* [http://www.funtoo.org/I3_Tiling_Window_Manager funtoo Wiki]
* [http://code.stapelberg.de/git/i3 i3 ソースコード]
* [https://github.com/ashinkarov/i3-extras i3-extras] - Collection of scripts and patches
* [https://github.com/acrisci/i3ipc-glib i3ipc-glib] - i3 拡張のためのライブラリ
* [https://github.com/veelenga/i3ipc-ruby i3ipc-ruby] - An improved library for i3 extensions in Ruby
* [http://www.j4tools.org/ j4tools] - non-official tools designed to work with i3

'''Arch Linux フォーラム'''
* [https://bbs.archlinux.org/viewtopic.php?id=99064 The i3 thread] - A general discussion about i3
* [https://bbs.archlinux.org/viewtopic.php?id=103369 i3 desktop screenshots and config sharing]

'''スクリーンキャスト'''
* [http://www.youtube.com/watch?v=Wx0eNaGzAZU i3 window manager v4.1 screencast]
* [https://www.youtube.com/watch?v=j1I63wGcvU4&index=1&list=PL5ze0DjYv5DbCv9vNEzFmP6sU7ZmkGzcf i3 window manager v4.1X screencasts]

I3

2016-06-23T16:31:17Z

Colajam93: 翻訳

{{DISPLAYTITLE:i3}}
[[Category:タイル型ウィンドウマネージャ]]
[[Category:動的ウィンドウマネージャ]]
[[en:i3]]
[[ko:I3]]
[[ru:I3]]
[[zh-CN:I3]]
{{Related articles start}}
{{Related|デスクトップ環境}}
{{Related|ディスプレイマネージャ}}
{{Related|ファイルマネージャの機能}}
{{Related|ウィンドウマネージャ}}
{{Related|タイル型ウィンドウマネージャの比較}}
{{Related|クリップボード}}
{{Related|自動起動#グラフィカル}}
{{Related articles end}}

[http://i3wm.org/ i3] は [[wmii]] にインスパイアされて開発された動的[[Wikipedia:ja:タイル型ウィンドウマネージャ|タイル型ウィンドウマネージャ]]で、主に開発者や上級ユーザーをターゲットにしています。

i3 が公表している目標は、わかりやすいドキュメント、適切なマルチモニタサポート、ウィンドウのツリー構造、[[vim]] のような様々なモードなどです。

== インストール ==

[[公式リポジトリ]]から {{Grp|i3}} [[Pacman#パッケージグループのインストール|パッケージグループ]]を[[インストール]]してください。このグループにはウィンドウマネージャの {{Pkg|i3-wm}} と、[[Wikipedia:ja:標準ストリーム#標準出力 (stdout)|標準出力]]によってステータスラインに書き込みを行う {{Pkg|i3status}}、そして画面ロッカーの {{Pkg|i3lock}} が含まれています。

追加のパッケージは [[Arch User Repository]] から利用可能です。例は [[#パッチ|パッチ]] セクションを見てください。

=== ディスプレイマネージャ ===

{{Pkg|i3-wm}} はウィンドウマネージャを起動する [[Xsession]] として {{ic|i3.desktop}} を含んでいます。
{{ic|i3-with-shmlog.desktop}} はログを有効にします (デバッグに役立ちます)。
{{AUR|i3-gnome}} は {{ic|i3}} を [[GNOME]] に統合します。

=== xinitrc ===

[[xinitrc]] を編集して、次の行を追加してください:

exec i3

i3 からの出力を記録したいときは、代わりに次の行を追加してください:

exec i3 -V >> ~/.config/i3/i3log-$(date +'%F-%k-%M-%S') 2>&1

キーのマッピングに問題が起こるときは (例: セミコロンの {{ic|;}})、{{Pkg|xorg-xev}} を使うか、または[[特別なキーボードキー]]を見て下さい。

$ xev | grep -A2 --line-buffered '^KeyRelease' | sed -n '/keycode /s/^.*keycode $[0-9]*$.* (.*, $.*$).*$/\1 \2/p'

== 使用方法 ==

詳しい情報は [http://i3wm.org/docs 公式のドキュメント]、すなわち [http://i3wm.org/docs/userguide.html i3 User’s Guide] を見て下さい。

=== キーバインド ===

i3 では修飾キー ({{ic|$mod}} と表記されます) を使ってコマンドを呼び出します。デフォルトでは {{ic|Alt}} (Mod1) ですが、{{ic|Super}} (Mod4) も良く使われます。大抵のキーボードでは Super は Windows アイコンが印されたキーになります。Apple キーボードなら Command キーです。

デフォルトのキーバインドについては [http://i3wm.org/docs/refcard.html i3 リファレンスカード] や [http://i3wm.org/docs/userguide.html#_using_i3 Using i3] を見て下さい。新しくショートカットを追加する方法は [http://i3wm.org/docs/userguide.html#keybindings Keyboard bindings] に載っています。

Qwerty 以外のキーボード配列を使っている場合は[[#設定ウィザードとキーボードレイアウト|設定ウィザードとキーボードレイアウト]]に書かれているように設定ウィザードを迂回すると良いでしょう。

=== コンテナ ===

i3 はコンテナを基本単位としたツリー構造でウィンドウを管理します。この構造は縦や横に分岐していきます。デフォルトではコンテナはタイル状に並べられますが、タブでまとめたり積み重ねるレイアウトに設定したり、フロートさせることもできます (ダイアログウィンドウのように)。フローティングウィンドウは常に一番上に表示されます。

詳しくは [http://i3wm.org/docs/userguide.html#_tree i3 Tree] や [http://www.youtube.com/watch?v=AWA8Pl57UBY Containers and the tree data structure] を見て下さい。

=== アプリケーションランチャー ===

i3 はアプリケーションランチャーとして [[dmenu]] を使っており、デフォルトでは {{ic|$mod+d}} で呼び出せます。dmenu の代わりに、透過機能や xft フォントのサポートなどが搭載されている AUR の {{AUR|dmenu2}} を使うこともできます。

{{Pkg|i3-wm}} には ''dmenu'' の [[Wikipedia:ja:Perl|Perl]] ラッパーである ''i3-dmenu-desktop'' が含まれており、[[デスクトップエントリ]]を利用してインストールされている全てのアプリケーションのリストを作成します。また、{{AUR|j4-dmenu-desktop-git}} パッケージを使うこともできます。こちらは ''i3-dmenu-desktop'' とほぼ同様に使える上に、高速に動作します [https://github.com/enkore/j4-dmenu-desktop/blob/master/README.md]。

== 設定 ==

詳しくは [http://i3wm.org/docs/userguide.html#configuring Configuring i3] を参照。この記事では ''i3'' の設定ファイルは {{ic|~/.config}} に置くことにします (''i3-config-wizard'' では {{ic|~/.i3/config}} に作成されます)。

=== 設定ウィザードとキーボードレイアウト ===

''i3'' を最初に起動したとき、設定ウィザードの ''i3-config-wizard'' が実行されます。このツールは {{ic|/etc/i3/config.keycodes}} にあるテンプレート設定ファイルを書き換えることで {{ic|~/.i3/config}} を作成します。デフォルトテンプレートには以下の2つの変更が加えられます:

# ウィザードはデフォルトの修飾キーを何にするかユーザーに尋ねます。{{ic|set $mod Mod1}} のような行がテンプレートに追加されます。
# ユーザーの現在のキーボードレイアウトにあわせて ''bindcode'' 行をすべて ''bindsym'' 行で置き換えます。

後者が実行されることで、4つのナビゲーションショートカット {{ic|j}}, {{ic|k}}, {{ic|l}} と Qwerty キーボードの"セミコロン"が正しいキーシムにマッピングされます。例えば [[Dvorak]] キーボードなら {{ic|h}}, {{ic|t}}, {{ic|n}}, {{ic|s}} になります。ただし副作用として他のキーシムのマッピングが変更されるため Dvorak ユーザーはむしろ混乱してしまうかもしれません。"再起動"は {{ic|$mod1+r}} ではなく {{ic|$mod1+p}} に、"横に分割"は {{ic|$mod1+h}} ではなく {{ic|$mod1+d}} にバインドされます。チュートリアルに記載されているバインドと同じ、覚えやすいキーバインドを使いたい場合は {{ic|/etc/i3/config}} を {{ic|~/.config/i3/config}} (または {{ic|~/.i3/config}}) にコピーしてください。

キーボードレイアウトを頻繁に変更するユーザーなどに対応するために、キーコードによる設定も可能です。

=== カラースキーム ===

設定ファイルを使ってウィンドウ装飾の色をカスタマイズすることができますが、構文のためにテーマを作成したり共有するのは現実的ではありません。ユーザーが様々なテーマを作るのを楽にさせるプロジェクトが複数存在します。

* {{App|i3-style|JSON オブジェクトで保存されたテーマによって所定の設定を変更します。テーマは何度もカラースキームを調整・修正できるように作られています。|https://github.com/acrisci/i3-style|{{Aur|nodejs-i3-style}}}}
* {{App|j4-make-config|あなたの設定をテーマのコレクションや個人用の設定パーツ (たとえばホスト用の設定) と組み合わせます。テーマの簡単な変更や、柔軟でダイナミックな設定のカスタマイズを可能にします。|https://github.com/okraits/j4-make-config|{{Aur|j4-make-config-git}}}}

=== i3bar ===

i3bar はワークスペースの情報を表示するほかに、次のセクションで説明している、i3status などに入力を行うこともできます。例:

{{hc|~/.config/i3/config|2=
bar {
output LVDS1
status_command i3status
position top
mode hide
workspace_buttons yes
tray_output none

font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1

colors {
background #000000
statusline #ffffff

focused_workspace #ffffff #285577
active_workspace #ffffff #333333
inactive_workspace #888888 #222222
urgent_workspace #ffffff #900000
}
}
}}

詳しくは [http://i3wm.org/docs/userguide.html#_configuring_i3bar Configuring i3bar] を見て下さい。

==== i3bar の代替 ====

旧来の[[デスクトップ環境]]に入っているようなパネルを使いたいというユーザーもいるかもしれません。起動時に i3 の中でパネルアプリケーションを起動することで他のパネルを使うことができます。

[[Xfce#パネル|XFCE パネル]]の場合、次の行を {{ic|~/.config/i3/config}} のどこかに追加してください:

exec --no-startup-id xfce4-panel --disable-wm-check

{{Note|[[デスクトップ環境]]固有のパネル機能は基本的に動作しません (例: ワークスペースやセッションを管理するウィジェット)、ただし i3 の機能がそれによって影響を受けることはないはずです。}}

{{ic|~/.config/i3/config}} の {{ic|<nowiki>bar{ }</nowiki>}} セクションをコメントアウトすることで i3bar は無効にできます。
もしくは以下を使ってください:

{{hc|~/.config/i3/config|
# bar toggle, hide or show
bindsym $mod+m bar mode toggle
}}

この方法では好きなようにバーを表示したり隠したりできます。

=== i3status ===

デフォルトの設定ファイルをホームディレクトリにコピーしてください:

$ cp /etc/i3status.conf ~/.config/i3status/config

デフォルトの設定では定義されていないプラグインがあり、いくつかの設定あなたのシステムでは無効かもしれません。
そのためシステムに応じて設定を更新する必要があります。詳しくは {{ic|man 1 i3status}} を見て下さい。

==== i3status の代替 ====

* {{App|[[conky]]|拡張性の高いシステムモニター。i3bar で使用する場合は [http://i3wm.org/docs/user-contributed/conky-i3bar.html このチュートリアル] を見て下さい。|https://github.com/brndnmtthws/conky|{{Pkg|conky}}}}
* {{App|i3blocks|シェルスクリプトで拡張することができます。クリックイベントや割り込み、ブロックごとによるリフレッシュ間隔の定義などを管理可能。|https://github.com/vivien/i3blocks|{{AUR|i3blocks}}}}
* {{App|i3phtatus|PHP で書かれた i3status の代替。簡単に拡張できます。|https://github.com/mwgg/i3phtatus}}
* {{App|goi3bar|Go で書かれた i3status の代替。コンポーネントを自由にアップデートすることができます。|https://github.com/denbeigh2000/goi3bar}}
* {{App|i3pystatus|デフォルトで多数のプラグインと設定オプションがある拡張可能な Python 3 ステータスバー。|https://github.com/enkore/i3pystatus i3pystatus|{{AUR|i3pystatus-git}}}}
* {{App|i3situation|もうひとつの Python 3 ステータスバージェネレータ。|https://github.com/HarveyHunt/i3situation|{{Aur|i3situation-git}}}}
* {{App|j4status|C で書かれており、プラグインで設定ができる、ステータスラインを提供します。追加プラグインは {{Aur|j4status-plugins-git}} に入っています。|http://j4status.j4tools.org/|{{Aur|j4status-git}}}}

==== i3status のラッパー ====

* {{App|[[en2:h2status|h2status]]|i3status の Bash ラッパー、カスタム json エントリを入力として、非同期のステータスバーの更新だけでなくクリックイベントの処理が可能。|https://wiki.archlinux.org/index.php/H2status|{{Aur|h2status}}}}
* {{App|i3cat|[[go]] ベースのラッパーで外部の複数のソースからの入力を繋げることができます。クリックイベントの処理、ユーザーが定義した信号を子プロセスに転送することが可能。|http://vincent-petithory.github.io/i3cat/|{{AUR|i3cat-git}}}}
* {{App|py3status|Python による拡張可能な i3status ラッパー。|https://github.com/ultrabug/py3status|{{Aur|py3status}}}}

==== ステータスバーにアイコンフォント ====

''i3bar'' には XBM アイコンサポートの[[#パッチ|パッチ]]をあてることができますが、代わりにアイコンフォントを使うこともできます。

* {{App|ttf-font-awesome|CSS でカスタマイズできるスケーラブルなベクターアイコン。それぞれの記号の Unicode を記した [http://fortawesome.github.io/Font-Awesome/cheatsheet/ チートシート] があります。|http://fortawesome.github.io/Font-Awesome/|{{AUR|ttf-font-awesome}}}}
* {{App|ttf-font-icons|Awesome と Ionicons の重複をなくしてサイズを合わせたミックス。DejaVu Sans と Awesome が重複しないようにします。|http://kageurufu.net/icons.pdf|{{AUR|ttf-font-icons}}}}

フォントを混ぜ合わせるには、設定ファイルにフォントのフォールバックを定義してください、以下のように {{ic|,}} でフォントを区切ります:
{{hc|~/.config/i3/config|2=
bar {
...
font pango:DejaVu Sans Mono, Icons 8
...
}
}}

[https://developer.gnome.org/pango/stable/pango-Fonts.html#pango-font-description-from-string pango syntax] に従って、カンマで区切ったフォントファミリーのリストを記述してそれから一番後ろにサイズをひとつだけ指定してください。
各フォントにサイズを設定するのは最後のフォントを除いて無視される原因となります。

最後に、アイコングラフをフォーマット文字列にして {{ic|~/.config/i3status/config}} に入力します。入力するために、上でリンクしているチートシートを見てユニコード番号を使います。入力方法はテキストエディタによって異なります。例えば "ハート" アイコン (ユニコード番号 f004) を入力するには:

* 様々な GUI のテキストエディタ (例: [[gedit]] や Leafpad) とターミナル (例: GNOME Terminal, xfce4-terminal): {{ic|ctrl+shift+u}}, {{ic|f004}}, {{ic|Enter}}
* [[Emacs]]: {{ic|ctrl+x}}, {{ic|8}}, {{ic|Enter}}, {{ic|f004}}, {{ic|Enter}}
* [[Vim]] (挿入モード): {{ic|Ctrl+v}}, {{ic|uf004}}
* [[urxvt]]: {{ic|Ctrl+Shift}} を押して、{{ic|f004}} を入力

=== ターミナルエミュレータ ===

デフォルトでは {{ic|$mod+Return}} を押すとターミナルを呼び出すスクリプトの {{ic|i3-sensible-terminal}} が起動します。ターミナルを呼び出す順番については {{ic|man i3-sensible-terminal}} を見て下さい。

他のターミナルを起動するには、{{ic|~/.config/i3/config}} の次の行を変更してください:

bindsym $mod+Return exec i3-sensible-terminal

または、{{ic|$TERMINAL}} 変数を[[環境変数#ユーザーごと|ローカルで定義]]してください:

$ export TERMINAL=''yourterminal''

== Tips and tricks ==

=== 高度なウィンドウナビゲーション ===

[http://www.slackword.net/?p=657 i3 window Navigation Tips] を見て下さい。

=== Jump to open window ===

*{{App|quickswitch-i3|i3 でウィンドウを素早く切り替え・確認するための Python ユーティリティ。|https://github.com/proxypoke/quickswitch-for-i3|{{Aur|quickswitch-i3}}}}
*{{App|i3-wm-scripts|正規表現にマッチする名前を持ったウィンドウを検索してジャンプ。|https://github.com/yiuin/i3-wm-scripts||}}
*{{App|winmenupy|クライアントのリストと一緒に dmenu を起動、ワークスペースの後にソートされます。クライアントを選択するとそのウィンドウにジャンプ。|https://github.com/ziberna/i3-py/blob/master/examples/winmenu.py||}}
*{{App|rofi|スクラッチパッドウィンドウを検索してジャンプして開く。|https://davedavenport.github.io/rofi/|{{Pkg|rofi}}}}

=== Jump to urgent window ===

{{ic|.i3/config}} に次を追加: [https://faq.i3wm.org/question/853/how-to-jump-to-urgent-workspace/]

bindsym $mod+x [urgent=latest] focus

=== ウィンドウレイアウトの保存と復元 ===

バージョン 4.8 から、''i3'' ワークスペースレイアウトの保存・復元が可能になっています。これを行うには、次のパッケージが必要です: [[公式リポジトリ]]から {{Pkg|perl-anyevent-i3}} と {{Pkg|perl-json-xs}}。

{{note| This section only provides quick tutorial on how to save the current window layout of a single workspace and how to restore it for later use. Refer to the [http://i3wm.org/docs/layout-saving.html official documentation] for more details}}

==== Save the current window layout of a single workspace ====

To save the current window layout, follow these steps:

# First, execute various commands to open windows in a preferred workspace and resize them if needed. Make sure to write down each executed command for each window.
# Now, in a new workspace, open a terminal and run the following: {{bc|i3-save-tree --workspace N > ~/.i3/workspace_N.json}} where N is the number of the preferred workspace. This will save the current layout of workspace N to the file {{ic|~/.i3/workspace_N.json}}.
# The newly created file needs to be edited, however this may be done with the following commands: {{bc|<nowiki>tail -n +2 ~/.i3/workspace_N.json | fgrep -v '// splitv' | sed 's|//||g' > ~/.i3/workspace_N.json</nowiki>}}

==== Restore the window layout of the workspace ====

There are two ways to restore the layout of the workspace: by writing a script, or by editing {{ic|~/.i3/config}} to automatically load the layout. In this section only the first case will be considered, refer to the [http://i3wm.org/docs/layout-saving.html#_restoring_the_layout official documentation] for the second case.

To restore the saved layout in the previous section, write a file named {{ic|load_layout.sh}} with the following contents:

* The starting lines:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"
}}

where M is the number of the workspace in which you would like to load the previously saved layout and N is the number of workspace saved in the previous section.
* And the commands used in the previous section to get the preferred windows, but enclosed in parentheses and with an ampersand appended before the last parentheses.

For example, if the saved layout contained three {{ic|uxterm}} windows:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash

# First we append the saved layout of worspace N to workspace M
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"

# And finally we fill the containers with the programs they had
(uxterm &)
(uxterm &)
(uxterm &)
}}

Then set the file as executable:

chmod u+x ~/load_layout.sh

And finally, the layout of worskpace N can be loaded onto to workspace M by running:

~/load_layout.sh

{{tip|Adding {{ic|bindsym $mod+g exec ~/load_layout.sh}} to {{ic|~/.i3/config}} and restarting i3 will bind Mod+g to run the above script.}}

{{note|If the above script does not work properly, refer to the [http://i3wm.org/docs/layout-saving.html#_editing_layout_files official documentation]. The ''swallows'' sections of {{ic|~/.i3/workspace_N.json}} needs to be manually edited.}}

=== スクラッチパッドコンテナ ===

デフォルトでは、[http://i3wm.org/docs/userguide.html#_scratchpad スクラッチパッド] は一つのウィンドウしか含んでいません。しかしながら、コンテナをスクラッチパッドにすることが可能です。

新しいコンテナを作成して (例えば、{{ic|Mod+Enter}})、コンテナを分割し ({{ic|Mod+v}}) 別のコンテナを作成します。親にフォーカスして ({{ic|Mod+a}})、反対方向に分割し ({{ic|Mod+h}})、もう一度作成します。

最初のコンテナにフォーカスして (必要なら親にもフォーカス)、ウィンドウをフロートさせ ({{ic|Mod+Shift+Space}})、スクラッチパッドに移動します ({{ic|Mod+Shift+-}})。これで自由にコンテナを分割できます。

{{Note|フロートしているウィンドウでコンテナのサイズを個別に変更することはできません。ウィンドウをフロートさせる前にコンテナのサイズを変えて下さい。}}

{{Tip|ターミナルアプリケーションしか使わない場合は、代わりに [[tmux]] などのマルチプレクサを使っても良いでしょう。}}

マルチスクラッチパッドについては [https://faq.i3wm.org/question/138/multiple-scratchpad/i3] も参照してください。

=== スクリーンセーバーと電源管理 ===

With [[電源管理#xss-lock]] you can register a screenlocker for your i3 session.

Alternatively, ''xautolock'' can lock the screen after awakening from sleep or hibernation with the {{ic|-lockaftersleep}} option. The {{ic|-time}} option locks the screen after a given time period.

xautolock -time 10 -locker "i3lock -i 'background_image.png'" -lockaftersleep &

See also [[DPMS]].

=== シャットダウン, 再起動, 画面ロック ===

シャットダウン、再起動、画面ロックのキーコンビネーションを {{ic|~/.config/i3/config}} に追加することができます。以下の例では[[systemd#電源管理|電源管理]]コマンドを実行する権限がないユーザーに権限を与えるために {{Pkg|polkit}} をインストールする必要があります。

{{bc|
set $Locker i3lock && sleep 1

set $mode_system System (l) lock, (e) logout, (s) suspend, (h) hibernate, (r) reboot, (Shift+s) shutdown
mode "$mode_system" {
bindsym l exec --no-startup-id $Locker, mode "default"
bindsym e exec --no-startup-id i3-msg exit, mode "default"
bindsym s exec --no-startup-id $Locker && systemctl suspend, mode "default"
bindsym h exec --no-startup-id $Locker && systemctl hibernate, mode "default"
bindsym r exec --no-startup-id systemctl reboot, mode "default"
bindsym Shift+s exec --no-startup-id systemctl poweroff -i, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}

bindsym $mod+Pause mode "$mode_system"
}}

追加したら {{ic|$mod+pause}} を押すことでプロンプトが表示されます。より複雑な動作の為には、スクリプトに分離し、mode の中で参照してください。[https://gist.github.com/anonymous/c8cd0a59bf4acb273068]

{{Note|1=<br>
* {{ic|sleep 1}} は小さなディレイを追加することで、サスペンドにより起こりうる競合状態を防ぎます。[https://bugs.launchpad.net/ubuntu/+source/unity-2d/+bug/830348]
* {{ic|systemctl poweroff}} への {{ic|-i}} 引数は、たとえ他のユーザーがログインしていたり (これは {{Pkg|polkit}} を必要とします)、''logind'' が (誤って) そのように認識していてもシャットダウンを行います。[https://bugs.freedesktop.org/show_bug.cgi?id=62676]
}}

他の画面ロッカーについては、[[アプリケーション一覧/セキュリティ#スクリーンロック]]を参照。

===External displays manual management===

Thanks to [[xrandr]] there are many ways to easily manage systems displays. The below example integrates it in the i3 config file, and behave as the Power Management section above.

Here a laptop with both VGA and HDMI outputs will use a menu selection to switch them On/Off:

## Manual management of external displays
# Set the shortcuts and what they do
set $mode_display Ext Screen (v) VGA ON, (h) HDMI ON, (x) VGA OFF, (y) HDMI OFF
mode "$mode_display" {
bindsym v exec --no-startup-id xrandr --output VGA1 --auto --right-of LVDS1, mode "default"
bindsym h exec --no-startup-id xrandr --output HDMI1 --auto --right-of LVDS1, mode "default"
bindsym x exec --no-startup-id xrandr --output VGA1 --auto --off, mode "default"
bindsym y exec --no-startup-id xrandr --output HDMI1 --auto --off, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}
# Declare here the shortcut to bring the display selection menu
bindsym $mod+x mode "$mode_display"

Any window that is still open in a switched Off display will automatically come back to the remaining active display.

The simplest way to determine names of your devices is to plug the device you wish to use and run:

$ xrandr --query

which will output the available, recognized devices and their in-system names to set your config file appropriately.

Refer to the [[xrandr]] page or man page for the complete list of available options, the [http://i3wm.org/docs/userguide.html i3 userguide] and/or the [https://www.reddit.com/r/i3wm i3 FAQ on reddit] for more info.

=== タブまたはスタックによるウェブブラウジング ===

タブの管理はブラウザの仕事ではなく、ウィンドウマネージャの仕事だとして、故意にタブを実装していないウェブブラウザというのが存在します。

[[uzbl]] など、タブのないウェブブラウザを i3 で管理するには、次の行を {{ic|~/.config/i3/config}} に追加して下さい:

for_window [class="Uzbl-core"] focus child, layout stacking, focus

これはスタックのウェブブラウジング用で、ウィンドウは縦に表示されます。タブブラウジングと違って、たとえブラウザのウィンドウを大量に開いていても、ウィンドウのタイトルを全て見ることができます。

水平方向のタブブラウジングの方が良い場合は ('タブ')、次を使って下さい:

for_window [class="Uzbl-core"] focus child, layout tabbed, focus

=== ワークスペース変数 ===

i3 ではワークスペースを複数定義するので、ワークスペース変数を指定すると便利です。例えば [https://github.com/dkeg/bloat2.0/blob/master/i3config#L55]:

set $WS1 term
set $WS2 web
set $WS3 misc
set $WS4 media
set $WS5 code

次にワークスペースの名前を対応する変数で置き換えます:

bindsym $mod+1 workspace $WS1
...
bindsym $mod+Shift+1 move container to workspace $WS1

詳しくは [http://i3wm.org/docs/userguide.html#_changing_named_workspaces_moving_to_workspaces Changing named workspaces] を見て下さい。

=== フロートするダイアログを正しく扱う ===

デフォルトではダイアログはフロートモードで開かれることになっていますが [http://i3wm.org/docs/userguide.html#_floating]、ダイアログはタイルモードで開いてしまうこともあります。この挙動を変更するには {{pkg|xorg-xprop}} でダイアログの {{ic|WM_WINDOW_ROLE}} をチェックして適切なルールを {{ic|~/.i3/config}} に追加してください:

for_window [window_role="pop-up"] floating enable
for_window [window_role="task_dialog"] floating enable

また、タイトルルールと正規表現を使うこともできます:

for_window [title="Preferences$"] floating enable

または {{ic|WM_CLASS}}:

for_window [class="(?i)mplayer"] floating enable

=== ネットワークのダウンロード・アップロード速度をステータスバーに表示 ===

上流の [http://code.stapelberg.de/git/i3status/tree/contrib/measure-net-speed.bash スクリプト] を編集します。

* システムに応じて両方のネットワークカードをリネームしてください ({{ic|ip addr}} を使ってください)
* {{ic|/sys/devices}} にあるそれらを見つけて適切に置き換えます:
$ find /sys/devices -name ''network_interface''

{{Tip|PCI の位置に依存しない為に {{ic|/sys/class/net/''interface''/statistics/}} を使います。}}

スクリプトを適切な場所 (例: {{ic|~/.config/i3}}) に保存して、ステータスプログラムから指してください。

== パッチ ==

上流にマージされてないパッチがあてられたパッケージが [[AUR]] には存在します:

* {{App|i3bar-icons-git|i3bar で XBM アイコンを表示|https://github.com/ashinkarov/i3-extras|{{AUR|i3bar-icons-git}}}}
* {{App|i3-smart-border|スマートボーダー|https://github.com/ashinkarov/i3-extras|{{AUR|i3-smart-border}}}}
* {{App|i3-wm-iconpatch|タイトルバーアイコンのサポート|https://github.com/ashinkarov/i3-extras|{{AUR|i3-wm-iconpatch}}}}

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

=== 一般 ===

多くの場合、バグは開発版である {{AUR|i3-git}} と {{AUR|i3status-git}} で修正されているため上流では開発版を使ってエラーが再現できるかどうか訊いてきます。 [http://i3wm.org/docs/debugging.html] [[デバッグ - トレースを取得#一般]]も見てください。

=== i3 メッセージバーのボタンが動作しない ===

{{ic|i3-nagbar}} の "Edit config" などのボタンは {{ic|i3-sensible-terminal}} を呼び出します。[[#ターミナルエミュレータ|ターミナルエミュレータ]]が i3 によって認識されていることを確認してください。

=== タイル化されたターミナルで行の折り返しがおかしい ===

i3 v4.3 以上ではタイル配置したウィンドウのサイズ増加ヒントは無視されます [https://www.mail-archive.com/i3-discuss@i3.zekjur.net/msg00709.html]。これによってターミナルで行が早いところで折り返されてしまうなどの問題が生じます。解決方法としては、問題のウィンドウをフロートさせてから、もう一度タイル化してください。

=== マウスカーソルが待機状態のままになる ===

起動通知をサポートしていないスクリプやアプリケーションを起動すると、マウスカーソルは60秒間の間、ビジー/砂時計状態になります。

特定のアプリケーションでこの問題を解決するには、{{ic|--no-startup-id}} パラメータを使って下さい、例えば:
exec --no-startup-id ~/script
bindsym $mod+d exec --no-startup-id dmenu_run

このアニメーションを全てのアプリケーションで無効にするには、[[カーソルテーマ]]を見て下さい。

=== キーバインドが反応しない ===

標準のキーバインド (キーを押して実行) を使っている場合、[[スクリーンショットの取得#scrot|scrot]] などのツールが動作しないことがあります。そのようなときは、{{ic|--release}} でキーをリリースしてからコマンドを実行してください:

bindsym --release Print exec --no-startup-id scrot '%Y-%m-%d$
bindsym --release Shift+Print exec --no-startup-id scrot '%Y$

[http://i3wm.org/docs/userguide.html#keybindings] を参照。

=== ティアリング ===

i3 は [http://bugs.i3wm.org/report/ticket/661 ダブルバッファをちゃんと実装していない] ためにティアリングやちらつきが発生することがあります。問題を修正したいときは、[[Xorg#コンポジット|コンポジットマネージャ]]を使ってみて下さい。

=== トレイアイコンが表示されない ===

デフォルトの {{ic|tray_output primary}} ディレクティブでは ''xrandr'' でプライマリ出力を設定する必要があります。明示的に出力を指定するか、ディレクティブを削除してください [https://github.com/i3/i3/issues/1144]。詳しくは [[Xrandr]] を参照。i3 のバージョン 4.12 から、i3-config-wizard によって作成されるデフォルト設定ではディレクティブが追加されないようになりました。

== 参照 ==

* [http://i3wm.org 公式ウェブサイト]
* [http://www.funtoo.org/I3_Tiling_Window_Manager funtoo Wiki]
* [http://code.stapelberg.de/git/i3 i3 ソースコード]
* [https://github.com/ashinkarov/i3-extras i3-extras] - Collection of scripts and patches
* [https://github.com/acrisci/i3ipc-glib i3ipc-glib] - i3 拡張のためのライブラリ
* [https://github.com/veelenga/i3ipc-ruby i3ipc-ruby] - An improved library for i3 extensions in Ruby
* [http://www.j4tools.org/ j4tools] - non-official tools designed to work with i3

'''Arch Linux フォーラム'''
* [https://bbs.archlinux.org/viewtopic.php?id=99064 The i3 thread] - A general discussion about i3
* [https://bbs.archlinux.org/viewtopic.php?id=103369 i3 desktop screenshots and config sharing]

'''スクリーンキャスト'''
* [http://www.youtube.com/watch?v=Wx0eNaGzAZU i3 window manager v4.1 screencast]
* [https://www.youtube.com/watch?v=j1I63wGcvU4&index=1&list=PL5ze0DjYv5DbCv9vNEzFmP6sU7ZmkGzcf i3 window manager v4.1X screencasts]

I3

2016-06-23T16:09:31Z

Colajam93: 翻訳

{{DISPLAYTITLE:i3}}
[[Category:タイル型ウィンドウマネージャ]]
[[Category:動的ウィンドウマネージャ]]
[[en:i3]]
[[ko:I3]]
[[ru:I3]]
[[zh-CN:I3]]
{{Related articles start}}
{{Related|デスクトップ環境}}
{{Related|ディスプレイマネージャ}}
{{Related|ファイルマネージャの機能}}
{{Related|ウィンドウマネージャ}}
{{Related|タイル型ウィンドウマネージャの比較}}
{{Related|クリップボード}}
{{Related|自動起動#グラフィカル}}
{{Related articles end}}

[http://i3wm.org/ i3] は [[wmii]] にインスパイアされて開発された動的[[Wikipedia:ja:タイル型ウィンドウマネージャ|タイル型ウィンドウマネージャ]]で、主に開発者や上級ユーザーをターゲットにしています。

i3 が公表している目標は、わかりやすいドキュメント、適切なマルチモニタサポート、ウィンドウのツリー構造、[[vim]] のような様々なモードなどです。

== インストール ==

[[公式リポジトリ]]から {{Grp|i3}} [[Pacman#パッケージグループのインストール|パッケージグループ]]を[[インストール]]してください。このグループにはウィンドウマネージャの {{Pkg|i3-wm}} と、[[Wikipedia:ja:標準ストリーム#標準出力 (stdout)|標準出力]]によってステータスラインに書き込みを行う {{Pkg|i3status}}、そして画面ロッカーの {{Pkg|i3lock}} が含まれています。

追加のパッケージは [[Arch User Repository]] から利用可能です。例は [[#パッチ|パッチ]] セクションを見てください。

=== ディスプレイマネージャ ===

{{Pkg|i3-wm}} はウィンドウマネージャを起動する [[Xsession]] として {{ic|i3.desktop}} を含んでいます。
{{ic|i3-with-shmlog.desktop}} はログを有効にします (デバッグに役立ちます)。
{{AUR|i3-gnome}} は {{ic|i3}} を [[GNOME]] に統合します。

=== xinitrc ===

[[xinitrc]] を編集して、次の行を追加してください:

exec i3

i3 からの出力を記録したいときは、代わりに次の行を追加してください:

exec i3 -V >> ~/.config/i3/i3log-$(date +'%F-%k-%M-%S') 2>&1

キーのマッピングに問題が起こるときは (例: セミコロンの {{ic|;}})、{{Pkg|xorg-xev}} を使うか、または[[特別なキーボードキー]]を見て下さい。

$ xev | grep -A2 --line-buffered '^KeyRelease' | sed -n '/keycode /s/^.*keycode $[0-9]*$.* (.*, $.*$).*$/\1 \2/p'

== 使用方法 ==

詳しい情報は [http://i3wm.org/docs 公式のドキュメント]、すなわち [http://i3wm.org/docs/userguide.html i3 User’s Guide] を見て下さい。

=== キーバインド ===

i3 では修飾キー ({{ic|$mod}} と表記されます) を使ってコマンドを呼び出します。デフォルトでは {{ic|Alt}} (Mod1) ですが、{{ic|Super}} (Mod4) も良く使われます。大抵のキーボードでは Super は Windows アイコンが印されたキーになります。Apple キーボードなら Command キーです。

デフォルトのキーバインドについては [http://i3wm.org/docs/refcard.html i3 リファレンスカード] や [http://i3wm.org/docs/userguide.html#_using_i3 Using i3] を見て下さい。新しくショートカットを追加する方法は [http://i3wm.org/docs/userguide.html#keybindings Keyboard bindings] に載っています。

Qwerty 以外のキーボード配列を使っている場合は[[#設定ウィザードとキーボードレイアウト|設定ウィザードとキーボードレイアウト]]に書かれているように設定ウィザードを迂回すると良いでしょう。

=== コンテナ ===

i3 はコンテナを基本単位としたツリー構造でウィンドウを管理します。この構造は縦や横に分岐していきます。デフォルトではコンテナはタイル状に並べられますが、タブでまとめたり積み重ねるレイアウトに設定したり、フロートさせることもできます (ダイアログウィンドウのように)。フローティングウィンドウは常に一番上に表示されます。

詳しくは [http://i3wm.org/docs/userguide.html#_tree i3 Tree] や [http://www.youtube.com/watch?v=AWA8Pl57UBY Containers and the tree data structure] を見て下さい。

=== アプリケーションランチャー ===

i3 はアプリケーションランチャーとして [[dmenu]] を使っており、デフォルトでは {{ic|$mod+d}} で呼び出せます。dmenu の代わりに、透過機能や xft フォントのサポートなどが搭載されている AUR の {{AUR|dmenu2}} を使うこともできます。

{{Pkg|i3-wm}} には ''dmenu'' の [[Wikipedia:ja:Perl|Perl]] ラッパーである ''i3-dmenu-desktop'' が含まれており、[[デスクトップエントリ]]を利用してインストールされている全てのアプリケーションのリストを作成します。また、{{AUR|j4-dmenu-desktop-git}} パッケージを使うこともできます。こちらは ''i3-dmenu-desktop'' とほぼ同様に使える上に、高速に動作します [https://github.com/enkore/j4-dmenu-desktop/blob/master/README.md]。

== 設定 ==

詳しくは [http://i3wm.org/docs/userguide.html#configuring Configuring i3] を参照。この記事では ''i3'' の設定ファイルは {{ic|~/.config}} に置くことにします (''i3-config-wizard'' では {{ic|~/.i3/config}} に作成されます)。

=== 設定ウィザードとキーボードレイアウト ===

''i3'' を最初に起動したとき、設定ウィザードの ''i3-config-wizard'' が実行されます。このツールは {{ic|/etc/i3/config.keycodes}} にあるテンプレート設定ファイルを書き換えることで {{ic|~/.i3/config}} を作成します。デフォルトテンプレートには以下の2つの変更が加えられます:

# ウィザードはデフォルトの修飾キーを何にするかユーザーに尋ねます。{{ic|set $mod Mod1}} のような行がテンプレートに追加されます。
# ユーザーの現在のキーボードレイアウトにあわせて ''bindcode'' 行をすべて ''bindsym'' 行で置き換えます。

後者が実行されることで、4つのナビゲーションショートカット {{ic|j}}, {{ic|k}}, {{ic|l}} と Qwerty キーボードの"セミコロン"が正しいキーシムにマッピングされます。例えば [[Dvorak]] キーボードなら {{ic|h}}, {{ic|t}}, {{ic|n}}, {{ic|s}} になります。ただし副作用として他のキーシムのマッピングが変更されるため Dvorak ユーザーはむしろ混乱してしまうかもしれません。"再起動"は {{ic|$mod1+r}} ではなく {{ic|$mod1+p}} に、"横に分割"は {{ic|$mod1+h}} ではなく {{ic|$mod1+d}} にバインドされます。チュートリアルに記載されているバインドと同じ、覚えやすいキーバインドを使いたい場合は {{ic|/etc/i3/config}} を {{ic|~/.config/i3/config}} (または {{ic|~/.i3/config}}) にコピーしてください。

キーボードレイアウトを頻繁に変更するユーザーなどに対応するために、キーコードによる設定も可能です。

=== カラースキーム ===

設定ファイルを使ってウィンドウ装飾の色をカスタマイズすることができますが、構文のためにテーマを作成したり共有するのは現実的ではありません。ユーザーが様々なテーマを作るのを楽にさせるプロジェクトが複数存在します。

* {{App|i3-style|JSON オブジェクトで保存されたテーマによって所定の設定を変更します。テーマは何度もカラースキームを調整・修正できるように作られています。|https://github.com/acrisci/i3-style|{{Aur|nodejs-i3-style}}}}
* {{App|j4-make-config|あなたの設定をテーマのコレクションや個人用の設定パーツ (たとえばホスト用の設定) と組み合わせます。テーマの簡単な変更や、柔軟でダイナミックな設定のカスタマイズを可能にします。|https://github.com/okraits/j4-make-config|{{Aur|j4-make-config-git}}}}

=== i3bar ===

i3bar はワークスペースの情報を表示するほかに、次のセクションで説明している、i3status などに入力を行うこともできます。例:

{{hc|~/.config/i3/config|2=
bar {
output LVDS1
status_command i3status
position top
mode hide
workspace_buttons yes
tray_output none

font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1

colors {
background #000000
statusline #ffffff

focused_workspace #ffffff #285577
active_workspace #ffffff #333333
inactive_workspace #888888 #222222
urgent_workspace #ffffff #900000
}
}
}}

詳しくは [http://i3wm.org/docs/userguide.html#_configuring_i3bar Configuring i3bar] を見て下さい。

==== i3bar の代替 ====

旧来の[[デスクトップ環境]]に入っているようなパネルを使いたいというユーザーもいるかもしれません。起動時に i3 の中でパネルアプリケーションを起動することで他のパネルを使うことができます。

[[Xfce#パネル|XFCE パネル]]の場合、次の行を {{ic|~/.config/i3/config}} のどこかに追加してください:

exec --no-startup-id xfce4-panel --disable-wm-check

{{Note|[[デスクトップ環境]]固有のパネル機能は基本的に動作しません (例: ワークスペースやセッションを管理するウィジェット)、ただし i3 の機能がそれによって影響を受けることはないはずです。}}

{{ic|~/.config/i3/config}} の {{ic|<nowiki>bar{ }</nowiki>}} セクションをコメントアウトすることで i3bar は無効にできます。
もしくは以下を使ってください:

{{hc|~/.config/i3/config|
# bar toggle, hide or show
bindsym $mod+m bar mode toggle
}}

この方法では好きなようにバーを表示したり隠したりできます。

=== i3status ===

デフォルトの設定ファイルをホームディレクトリにコピーしてください:

$ cp /etc/i3status.conf ~/.config/i3status/config

デフォルトの設定では定義されていないプラグインがあり、いくつかの設定あなたのシステムでは無効かもしれません。
そのためシステムに応じて設定を更新する必要があります。詳しくは {{ic|man 1 i3status}} を見て下さい。

==== i3status の代替 ====

* {{App|[[conky]]|拡張性の高いシステムモニター。i3bar で使用する場合は [http://i3wm.org/docs/user-contributed/conky-i3bar.html このチュートリアル] を見て下さい。|https://github.com/brndnmtthws/conky|{{Pkg|conky}}}}
* {{App|i3blocks|シェルスクリプトで拡張することができます。クリックイベントや割り込み、ブロックごとによるリフレッシュ間隔の定義などを管理可能。|https://github.com/vivien/i3blocks|{{AUR|i3blocks}}}}
* {{App|i3phtatus|PHP で書かれた i3status の代替。簡単に拡張できます。|https://github.com/mwgg/i3phtatus}}
* {{App|goi3bar|Go で書かれた i3status の代替。コンポーネントを自由にアップデートすることができます。|https://github.com/denbeigh2000/goi3bar}}
* {{App|i3pystatus|デフォルトで多数のプラグインと設定オプションがある拡張可能な Python 3 ステータスバー。|https://github.com/enkore/i3pystatus i3pystatus|{{AUR|i3pystatus-git}}}}
* {{App|i3situation|もうひとつの Python 3 ステータスバージェネレータ。|https://github.com/HarveyHunt/i3situation|{{Aur|i3situation-git}}}}
* {{App|j4status|C で書かれており、プラグインで設定ができる、ステータスラインを提供します。追加プラグインは {{Aur|j4status-plugins-git}} に入っています。|http://j4status.j4tools.org/|{{Aur|j4status-git}}}}

==== i3status のラッパー ====

* {{App|[[en2:h2status|h2status]]|i3status の Bash ラッパー、カスタム json エントリを入力として、非同期のステータスバーの更新だけでなくクリックイベントの処理が可能。|https://wiki.archlinux.org/index.php/H2status|{{Aur|h2status}}}}
* {{App|i3cat|[[go]] ベースのラッパーで外部の複数のソースからの入力を繋げることができます。クリックイベントの処理、ユーザーが定義した信号を子プロセスに転送することが可能。|http://vincent-petithory.github.io/i3cat/|{{AUR|i3cat-git}}}}
* {{App|py3status|Python による拡張可能な i3status ラッパー。|https://github.com/ultrabug/py3status|{{Aur|py3status}}}}

==== ステータスバーにアイコンフォント ====

''i3bar'' には XBM アイコンサポートの[[#パッチ|パッチ]]をあてることができますが、代わりにアイコンフォントを使うこともできます。

* {{App|ttf-font-awesome|CSS でカスタマイズできるスケーラブルなベクターアイコン。それぞれの記号の Unicode を記した [http://fortawesome.github.io/Font-Awesome/cheatsheet/ チートシート] があります。|http://fortawesome.github.io/Font-Awesome/|{{AUR|ttf-font-awesome}}}}
* {{App|ttf-font-icons|Awesome と Ionicons の重複をなくしてサイズを合わせたミックス。DejaVu Sans と Awesome が重複しないようにします。|http://kageurufu.net/icons.pdf|{{AUR|ttf-font-icons}}}}

フォントを混ぜ合わせるには、設定ファイルにフォントのフォールバックを定義してください、以下のように {{ic|,}} でフォントを区切ります:
{{hc|~/.config/i3/config|2=
bar {
...
font pango:DejaVu Sans Mono, Icons 8
...
}
}}

[https://developer.gnome.org/pango/stable/pango-Fonts.html#pango-font-description-from-string pango syntax] に従って、カンマで区切ったフォントファミリーのリストを記述してそれから一番後ろにサイズをひとつだけ指定してください。
各フォントにサイズを設定するのは最後のフォントを除いて無視される原因となります。

最後に、アイコングラフをフォーマット文字列にして {{ic|~/.config/i3status/config}} に入力します。入力するために、上でリンクしているチートシートを見てユニコード番号を使います。入力方法はテキストエディタによって異なります。例えば "ハート" アイコン (ユニコード番号 f004) を入力するには:

* 様々な GUI のテキストエディタ (例: [[gedit]] や Leafpad) とターミナル (例: GNOME Terminal, xfce4-terminal): {{ic|ctrl+shift+u}}, {{ic|f004}}, {{ic|Enter}}
* [[Emacs]]: {{ic|ctrl+x}}, {{ic|8}}, {{ic|Enter}}, {{ic|f004}}, {{ic|Enter}}
* [[Vim]] (挿入モード): {{ic|Ctrl+v}}, {{ic|uf004}}
* [[urxvt]]: {{ic|Ctrl+Shift}} を押して、{{ic|f004}} を入力

=== ターミナルエミュレータ ===

デフォルトでは {{ic|$mod+Return}} を押すとターミナルを呼び出すスクリプトの {{ic|i3-sensible-terminal}} が起動します。ターミナルを呼び出す順番については {{ic|man i3-sensible-terminal}} を見て下さい。

他のターミナルを起動するには、{{ic|~/.config/i3/config}} の次の行を変更してください:

bindsym $mod+Return exec i3-sensible-terminal

または、{{ic|$TERMINAL}} 変数を[[環境変数#ユーザーごと|ローカルで定義]]してください:

$ export TERMINAL=''yourterminal''

== Tips and tricks ==

=== 高度なウィンドウナビゲーション ===

[http://www.slackword.net/?p=657 i3 window Navigation Tips] を見て下さい。

=== Jump to open window ===

*{{App|quickswitch-i3|i3 でウィンドウを素早く切り替え・確認するための Python ユーティリティ。|https://github.com/proxypoke/quickswitch-for-i3|{{Aur|quickswitch-i3}}}}
*{{App|i3-wm-scripts|正規表現にマッチする名前を持ったウィンドウを検索してジャンプ。|https://github.com/yiuin/i3-wm-scripts||}}
*{{App|winmenupy|クライアントのリストと一緒に dmenu を起動、ワークスペースの後にソートされます。クライアントを選択するとそのウィンドウにジャンプ。|https://github.com/ziberna/i3-py/blob/master/examples/winmenu.py||}}
*{{App|rofi|スクラッチパッドウィンドウを検索してジャンプして開く。|https://davedavenport.github.io/rofi/|{{Pkg|rofi}}}}

=== Jump to urgent window ===

{{ic|.i3/config}} に次を追加: [https://faq.i3wm.org/question/853/how-to-jump-to-urgent-workspace/]

bindsym $mod+x [urgent=latest] focus

=== ウィンドウレイアウトの保存と復元 ===

バージョン 4.8 から、''i3'' ワークスペースレイアウトの保存・復元が可能になっています。これを行うには、次のパッケージが必要です: [[公式リポジトリ]]から {{Pkg|perl-anyevent-i3}} と {{Pkg|perl-json-xs}}。

{{note| This section only provides quick tutorial on how to save the current window layout of a single workspace and how to restore it for later use. Refer to the [http://i3wm.org/docs/layout-saving.html official documentation] for more details}}

==== Save the current window layout of a single workspace ====

To save the current window layout, follow these steps:

# First, execute various commands to open windows in a preferred workspace and resize them if needed. Make sure to write down each executed command for each window.
# Now, in a new workspace, open a terminal and run the following: {{bc|i3-save-tree --workspace N > ~/.i3/workspace_N.json}} where N is the number of the preferred workspace. This will save the current layout of workspace N to the file {{ic|~/.i3/workspace_N.json}}.
# The newly created file needs to be edited, however this may be done with the following commands: {{bc|<nowiki>tail -n +2 ~/.i3/workspace_N.json | fgrep -v '// splitv' | sed 's|//||g' > ~/.i3/workspace_N.json</nowiki>}}

==== Restore the window layout of the workspace ====

There are two ways to restore the layout of the workspace: by writing a script, or by editing {{ic|~/.i3/config}} to automatically load the layout. In this section only the first case will be considered, refer to the [http://i3wm.org/docs/layout-saving.html#_restoring_the_layout official documentation] for the second case.

To restore the saved layout in the previous section, write a file named {{ic|load_layout.sh}} with the following contents:

* The starting lines:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"
}}

where M is the number of the workspace in which you would like to load the previously saved layout and N is the number of workspace saved in the previous section.
* And the commands used in the previous section to get the preferred windows, but enclosed in parentheses and with an ampersand appended before the last parentheses.

For example, if the saved layout contained three {{ic|uxterm}} windows:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash

# First we append the saved layout of worspace N to workspace M
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"

# And finally we fill the containers with the programs they had
(uxterm &)
(uxterm &)
(uxterm &)
}}

Then set the file as executable:

chmod u+x ~/load_layout.sh

And finally, the layout of worskpace N can be loaded onto to workspace M by running:

~/load_layout.sh

{{tip|Adding {{ic|bindsym $mod+g exec ~/load_layout.sh}} to {{ic|~/.i3/config}} and restarting i3 will bind Mod+g to run the above script.}}

{{note|If the above script does not work properly, refer to the [http://i3wm.org/docs/layout-saving.html#_editing_layout_files official documentation]. The ''swallows'' sections of {{ic|~/.i3/workspace_N.json}} needs to be manually edited.}}

=== スクラッチパッドコンテナ ===

デフォルトでは、[http://i3wm.org/docs/userguide.html#_scratchpad スクラッチパッド] は一つのウィンドウしか含んでいません。しかしながら、コンテナをスクラッチパッドにすることが可能です。

新しいコンテナを作成して (例えば、{{ic|Mod+Enter}})、コンテナを分割し ({{ic|Mod+v}}) 別のコンテナを作成します。親にフォーカスして ({{ic|Mod+a}})、反対方向に分割し ({{ic|Mod+h}})、もう一度作成します。

最初のコンテナにフォーカスして (必要なら親にもフォーカス)、ウィンドウをフロートさせ ({{ic|Mod+Shift+Space}})、スクラッチパッドに移動します ({{ic|Mod+Shift+-}})。これで自由にコンテナを分割できます。

{{Note|フロートしているウィンドウでコンテナのサイズを個別に変更することはできません。ウィンドウをフロートさせる前にコンテナのサイズを変えて下さい。}}

{{Tip|ターミナルアプリケーションしか使わない場合は、代わりに [[tmux]] などのマルチプレクサを使っても良いでしょう。}}

マルチスクラッチパッドについては [https://faq.i3wm.org/question/138/multiple-scratchpad/i3] も参照してください。

=== スクリーンセーバーと電源管理 ===

With [[電源管理#xss-lock]] you can register a screenlocker for your i3 session.

Alternatively, ''xautolock'' can lock the screen after awakening from sleep or hibernation with the {{ic|-lockaftersleep}} option. The {{ic|-time}} option locks the screen after a given time period.

xautolock -time 10 -locker "i3lock -i 'background_image.png'" -lockaftersleep &

See also [[DPMS]].

=== シャットダウン, 再起動, 画面ロック ===

シャットダウン、再起動、画面ロックのキーコンビネーションを {{ic|~/.config/i3/config}} に追加することができます。以下の例では[[systemd#電源管理|電源管理]]コマンドを実行する権限がないユーザーに権限を与えるために {{Pkg|polkit}} をインストールする必要があります。

{{bc|
set $Locker i3lock && sleep 1

set $mode_system System (l) lock, (e) logout, (s) suspend, (h) hibernate, (r) reboot, (Shift+s) shutdown
mode "$mode_system" {
bindsym l exec --no-startup-id $Locker, mode "default"
bindsym e exec --no-startup-id i3-msg exit, mode "default"
bindsym s exec --no-startup-id $Locker && systemctl suspend, mode "default"
bindsym h exec --no-startup-id $Locker && systemctl hibernate, mode "default"
bindsym r exec --no-startup-id systemctl reboot, mode "default"
bindsym Shift+s exec --no-startup-id systemctl poweroff -i, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}

bindsym $mod+Pause mode "$mode_system"
}}

Once completed, you will be presented with a prompt whenever you press {{ic|$mod+pause}}. For more complex behaviour, use a separate script, and refer to it in the mode. [https://gist.github.com/anonymous/c8cd0a59bf4acb273068]

{{Note|1=<br>
* {{ic|sleep 1}} adds a small delay to prevent possible race conditions with suspend [https://bugs.launchpad.net/ubuntu/+source/unity-2d/+bug/830348]
* The {{ic|-i}} argument for {{ic|systemctl poweroff}} causes a shutdown even if other users are logged-in (this requires {{Pkg|polkit}}), or when ''logind'' (wrongly) assumes so. [https://bugs.freedesktop.org/show_bug.cgi?id=62676]
}}

他の画面ロッカーについては、[[アプリケーション一覧/セキュリティ#スクリーンロック]]を参照。

===External displays manual management===

Thanks to [[xrandr]] there are many ways to easily manage systems displays. The below example integrates it in the i3 config file, and behave as the Power Management section above.

Here a laptop with both VGA and HDMI outputs will use a menu selection to switch them On/Off:

## Manual management of external displays
# Set the shortcuts and what they do
set $mode_display Ext Screen (v) VGA ON, (h) HDMI ON, (x) VGA OFF, (y) HDMI OFF
mode "$mode_display" {
bindsym v exec --no-startup-id xrandr --output VGA1 --auto --right-of LVDS1, mode "default"
bindsym h exec --no-startup-id xrandr --output HDMI1 --auto --right-of LVDS1, mode "default"
bindsym x exec --no-startup-id xrandr --output VGA1 --auto --off, mode "default"
bindsym y exec --no-startup-id xrandr --output HDMI1 --auto --off, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}
# Declare here the shortcut to bring the display selection menu
bindsym $mod+x mode "$mode_display"

Any window that is still open in a switched Off display will automatically come back to the remaining active display.

The simplest way to determine names of your devices is to plug the device you wish to use and run:

$ xrandr --query

which will output the available, recognized devices and their in-system names to set your config file appropriately.

Refer to the [[xrandr]] page or man page for the complete list of available options, the [http://i3wm.org/docs/userguide.html i3 userguide] and/or the [https://www.reddit.com/r/i3wm i3 FAQ on reddit] for more info.

=== タブまたはスタックによるウェブブラウジング ===

タブの管理はブラウザの仕事ではなく、ウィンドウマネージャの仕事だとして、故意にタブを実装していないウェブブラウザというのが存在します。

[[uzbl]] など、タブのないウェブブラウザを i3 で管理するには、次の行を {{ic|~/.config/i3/config}} に追加して下さい:

for_window [class="Uzbl-core"] focus child, layout stacking, focus

これはスタックのウェブブラウジング用で、ウィンドウは縦に表示されます。タブブラウジングと違って、たとえブラウザのウィンドウを大量に開いていても、ウィンドウのタイトルを全て見ることができます。

水平方向のタブブラウジングの方が良い場合は ('タブ')、次を使って下さい:

for_window [class="Uzbl-core"] focus child, layout tabbed, focus

=== ワークスペース変数 ===

i3 ではワークスペースを複数定義するので、ワークスペース変数を指定すると便利です。例えば [https://github.com/dkeg/bloat2.0/blob/master/i3config#L55]:

set $WS1 term
set $WS2 web
set $WS3 misc
set $WS4 media
set $WS5 code

次にワークスペースの名前を対応する変数で置き換えます:

bindsym $mod+1 workspace $WS1
...
bindsym $mod+Shift+1 move container to workspace $WS1

詳しくは [http://i3wm.org/docs/userguide.html#_changing_named_workspaces_moving_to_workspaces Changing named workspaces] を見て下さい。

=== フロートするダイアログを正しく扱う ===

デフォルトではダイアログはフロートモードで開かれることになっていますが [http://i3wm.org/docs/userguide.html#_floating]、ダイアログはタイルモードで開いてしまうこともあります。この挙動を変更するには {{pkg|xorg-xprop}} でダイアログの {{ic|WM_WINDOW_ROLE}} をチェックして適切なルールを {{ic|~/.i3/config}} に追加してください:

for_window [window_role="pop-up"] floating enable
for_window [window_role="task_dialog"] floating enable

また、タイトルルールと正規表現を使うこともできます:

for_window [title="Preferences$"] floating enable

または {{ic|WM_CLASS}}:

for_window [class="(?i)mplayer"] floating enable

=== ネットワークのダウンロード・アップロード速度をステータスバーに表示 ===

上流の [http://code.stapelberg.de/git/i3status/tree/contrib/measure-net-speed.bash スクリプト] を編集します。

* システムに応じて両方のネットワークカードをリネームしてください ({{ic|ip addr}} を使ってください)
* {{ic|/sys/devices}} にあるそれらを見つけて適切に置き換えます:
$ find /sys/devices -name ''network_interface''

{{Tip|PCI の位置に依存しない為に {{ic|/sys/class/net/''interface''/statistics/}} を使います。}}

スクリプトを適切な場所 (例: {{ic|~/.config/i3}}) に保存して、ステータスプログラムから指してください。

== パッチ ==

上流にマージされてないパッチがあてられたパッケージが [[AUR]] には存在します:

* {{App|i3bar-icons-git|i3bar で XBM アイコンを表示|https://github.com/ashinkarov/i3-extras|{{AUR|i3bar-icons-git}}}}
* {{App|i3-smart-border|スマートボーダー|https://github.com/ashinkarov/i3-extras|{{AUR|i3-smart-border}}}}
* {{App|i3-wm-iconpatch|タイトルバーアイコンのサポート|https://github.com/ashinkarov/i3-extras|{{AUR|i3-wm-iconpatch}}}}

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

=== 一般 ===

多くの場合、バグは開発版である {{AUR|i3-git}} と {{AUR|i3status-git}} で修正されているため上流では開発版を使ってエラーが再現できるかどうか訊いてきます。 [http://i3wm.org/docs/debugging.html] [[デバッグ - トレースを取得#一般]]も見てください。

=== i3 メッセージバーのボタンが動作しない ===

{{ic|i3-nagbar}} の "Edit config" などのボタンは {{ic|i3-sensible-terminal}} を呼び出します。[[#ターミナルエミュレータ|ターミナルエミュレータ]]が i3 によって認識されていることを確認してください。

=== タイル化されたターミナルで行の折り返しがおかしい ===

i3 v4.3 以上ではタイル配置したウィンドウのサイズ増加ヒントは無視されます [https://www.mail-archive.com/i3-discuss@i3.zekjur.net/msg00709.html]。これによってターミナルで行が早いところで折り返されてしまうなどの問題が生じます。解決方法としては、問題のウィンドウをフロートさせてから、もう一度タイル化してください。

=== マウスカーソルが待機状態のままになる ===

起動通知をサポートしていないスクリプやアプリケーションを起動すると、マウスカーソルは60秒間の間、ビジー/砂時計状態になります。

特定のアプリケーションでこの問題を解決するには、{{ic|--no-startup-id}} パラメータを使って下さい、例えば:
exec --no-startup-id ~/script
bindsym $mod+d exec --no-startup-id dmenu_run

このアニメーションを全てのアプリケーションで無効にするには、[[カーソルテーマ]]を見て下さい。

=== キーバインドが反応しない ===

標準のキーバインド (キーを押して実行) を使っている場合、[[スクリーンショットの取得#scrot|scrot]] などのツールが動作しないことがあります。そのようなときは、{{ic|--release}} でキーをリリースしてからコマンドを実行してください:

bindsym --release Print exec --no-startup-id scrot '%Y-%m-%d$
bindsym --release Shift+Print exec --no-startup-id scrot '%Y$

[http://i3wm.org/docs/userguide.html#keybindings] を参照。

=== ティアリング ===

i3 は [http://bugs.i3wm.org/report/ticket/661 ダブルバッファをちゃんと実装していない] ためにティアリングやちらつきが発生することがあります。問題を修正したいときは、[[Xorg#コンポジット|コンポジットマネージャ]]を使ってみて下さい。

=== トレイアイコンが表示されない ===

デフォルトの {{ic|tray_output primary}} ディレクティブでは ''xrandr'' でプライマリ出力を設定する必要があります。明示的に出力を指定するか、ディレクティブを削除してください [https://github.com/i3/i3/issues/1144]。詳しくは [[Xrandr]] を参照。i3 のバージョン 4.12 から、i3-config-wizard によって作成されるデフォルト設定ではディレクティブが追加されないようになりました。

== 参照 ==

* [http://i3wm.org 公式ウェブサイト]
* [http://www.funtoo.org/I3_Tiling_Window_Manager funtoo Wiki]
* [http://code.stapelberg.de/git/i3 i3 ソースコード]
* [https://github.com/ashinkarov/i3-extras i3-extras] - Collection of scripts and patches
* [https://github.com/acrisci/i3ipc-glib i3ipc-glib] - i3 拡張のためのライブラリ
* [https://github.com/veelenga/i3ipc-ruby i3ipc-ruby] - An improved library for i3 extensions in Ruby
* [http://www.j4tools.org/ j4tools] - non-official tools designed to work with i3

'''Arch Linux フォーラム'''
* [https://bbs.archlinux.org/viewtopic.php?id=99064 The i3 thread] - A general discussion about i3
* [https://bbs.archlinux.org/viewtopic.php?id=103369 i3 desktop screenshots and config sharing]

'''スクリーンキャスト'''
* [http://www.youtube.com/watch?v=Wx0eNaGzAZU i3 window manager v4.1 screencast]
* [https://www.youtube.com/watch?v=j1I63wGcvU4&index=1&list=PL5ze0DjYv5DbCv9vNEzFmP6sU7ZmkGzcf i3 window manager v4.1X screencasts]

I3

2016-06-23T15:48:22Z

Colajam93: 英語と同期(未翻訳を含む)

{{DISPLAYTITLE:i3}}
[[Category:タイル型ウィンドウマネージャ]]
[[Category:動的ウィンドウマネージャ]]
[[en:i3]]
[[ko:I3]]
[[ru:I3]]
[[zh-CN:I3]]
{{Related articles start}}
{{Related|デスクトップ環境}}
{{Related|ディスプレイマネージャ}}
{{Related|ファイルマネージャの機能}}
{{Related|ウィンドウマネージャ}}
{{Related|タイル型ウィンドウマネージャの比較}}
{{Related|クリップボード}}
{{Related|自動起動#グラフィカル}}
{{Related articles end}}

[http://i3wm.org/ i3] は [[wmii]] にインスパイアされて開発された動的[[Wikipedia:ja:タイル型ウィンドウマネージャ|タイル型ウィンドウマネージャ]]で、主に開発者や上級ユーザーをターゲットにしています。

i3 が公表している目標は、わかりやすいドキュメント、適切なマルチモニタサポート、ウィンドウのツリー構造、[[vim]] のような様々なモードなどです。

== インストール ==

[[公式リポジトリ]]から {{Grp|i3}} [[Pacman#パッケージグループのインストール|パッケージグループ]]を[[インストール]]してください。このグループにはウィンドウマネージャの {{Pkg|i3-wm}} と、[[Wikipedia:ja:標準ストリーム#標準出力 (stdout)|標準出力]]によってステータスラインに書き込みを行う {{Pkg|i3status}}、そして画面ロッカーの {{Pkg|i3lock}} が含まれています。

追加のパッケージは [[Arch User Repository]] から利用可能です。例は [[#パッチ|パッチ]] セクションを見てください。

=== ディスプレイマネージャ ===

{{Pkg|i3-wm}} はウィンドウマネージャを起動する [[Xsession]] として {{ic|i3.desktop}} を含んでいます。
{{ic|i3-with-shmlog.desktop}} はログを有効にします (デバッグに役立ちます)。
{{AUR|i3-gnome}} は {{ic|i3}} を [[GNOME]] に統合します。

=== xinitrc ===

[[xinitrc]] を編集して、次の行を追加してください:

exec i3

i3 からの出力を記録したいときは、代わりに次の行を追加してください:

exec i3 -V >> ~/.config/i3/i3log-$(date +'%F-%k-%M-%S') 2>&1

キーのマッピングに問題が起こるときは (例: セミコロンの {{ic|;}})、{{Pkg|xorg-xev}} を使うか、または[[特別なキーボードキー]]を見て下さい。

$ xev | grep -A2 --line-buffered '^KeyRelease' | sed -n '/keycode /s/^.*keycode $[0-9]*$.* (.*, $.*$).*$/\1 \2/p'

== 使用方法 ==

詳しい情報は [http://i3wm.org/docs 公式のドキュメント]、すなわち [http://i3wm.org/docs/userguide.html i3 User’s Guide] を見て下さい。

=== キーバインド ===

i3 では修飾キー ({{ic|$mod}} と表記されます) を使ってコマンドを呼び出します。デフォルトでは {{ic|Alt}} (Mod1) ですが、{{ic|Super}} (Mod4) も良く使われます。大抵のキーボードでは Super は Windows アイコンが印されたキーになります。Apple キーボードなら Command キーです。

デフォルトのキーバインドについては [http://i3wm.org/docs/refcard.html i3 リファレンスカード] や [http://i3wm.org/docs/userguide.html#_using_i3 Using i3] を見て下さい。新しくショートカットを追加する方法は [http://i3wm.org/docs/userguide.html#keybindings Keyboard bindings] に載っています。

Qwerty 以外のキーボード配列を使っている場合は[[#設定ウィザードとキーボードレイアウト|設定ウィザードとキーボードレイアウト]]に書かれているように設定ウィザードを迂回すると良いでしょう。

=== コンテナ ===

i3 はコンテナを基本単位としたツリー構造でウィンドウを管理します。この構造は縦や横に分岐していきます。デフォルトではコンテナはタイル状に並べられますが、タブでまとめたり積み重ねるレイアウトに設定したり、フロートさせることもできます (ダイアログウィンドウのように)。フローティングウィンドウは常に一番上に表示されます。

詳しくは [http://i3wm.org/docs/userguide.html#_tree i3 Tree] や [http://www.youtube.com/watch?v=AWA8Pl57UBY Containers and the tree data structure] を見て下さい。

=== アプリケーションランチャー ===

i3 はアプリケーションランチャーとして [[dmenu]] を使っており、デフォルトでは {{ic|$mod+d}} で呼び出せます。dmenu の代わりに、透過機能や xft フォントのサポートなどが搭載されている AUR の {{AUR|dmenu2}} を使うこともできます。

{{Pkg|i3-wm}} には ''dmenu'' の [[Wikipedia:ja:Perl|Perl]] ラッパーである ''i3-dmenu-desktop'' が含まれており、[[デスクトップエントリ]]を利用してインストールされている全てのアプリケーションのリストを作成します。また、{{AUR|j4-dmenu-desktop-git}} パッケージを使うこともできます。こちらは ''i3-dmenu-desktop'' とほぼ同様に使える上に、高速に動作します [https://github.com/enkore/j4-dmenu-desktop/blob/master/README.md]。

== 設定 ==

詳しくは [http://i3wm.org/docs/userguide.html#configuring Configuring i3] を参照。この記事では ''i3'' の設定ファイルは {{ic|~/.config}} に置くことにします (''i3-config-wizard'' では {{ic|~/.i3/config}} に作成されます)。

=== 設定ウィザードとキーボードレイアウト ===

''i3'' を最初に起動したとき、設定ウィザードの ''i3-config-wizard'' が実行されます。このツールは {{ic|/etc/i3/config.keycodes}} にあるテンプレート設定ファイルを書き換えることで {{ic|~/.i3/config}} を作成します。デフォルトテンプレートには以下の2つの変更が加えられます:

# ウィザードはデフォルトの修飾キーを何にするかユーザーに尋ねます。{{ic|set $mod Mod1}} のような行がテンプレートに追加されます。
# ユーザーの現在のキーボードレイアウトにあわせて ''bindcode'' 行をすべて ''bindsym'' 行で置き換えます。

後者が実行されることで、4つのナビゲーションショートカット {{ic|j}}, {{ic|k}}, {{ic|l}} と Qwerty キーボードの"セミコロン"が正しいキーシムにマッピングされます。例えば [[Dvorak]] キーボードなら {{ic|h}}, {{ic|t}}, {{ic|n}}, {{ic|s}} になります。ただし副作用として他のキーシムのマッピングが変更されるため Dvorak ユーザーはむしろ混乱してしまうかもしれません。"再起動"は {{ic|$mod1+r}} ではなく {{ic|$mod1+p}} に、"横に分割"は {{ic|$mod1+h}} ではなく {{ic|$mod1+d}} にバインドされます。チュートリアルに記載されているバインドと同じ、覚えやすいキーバインドを使いたい場合は {{ic|/etc/i3/config}} を {{ic|~/.config/i3/config}} (または {{ic|~/.i3/config}}) にコピーしてください。

キーボードレイアウトを頻繁に変更するユーザーなどに対応するために、キーコードによる設定も可能です。

=== カラースキーム ===

設定ファイルを使ってウィンドウ装飾の色をカスタマイズすることができますが、構文のためにテーマを作成したり共有するのは現実的ではありません。ユーザーが様々なテーマを作るのを楽にさせるプロジェクトが複数存在します。

* {{App|i3-style|JSON オブジェクトで保存されたテーマによって所定の設定を変更します。テーマは何度もカラースキームを調整・修正できるように作られています。|https://github.com/acrisci/i3-style|{{Aur|nodejs-i3-style}}}}
* {{App|j4-make-config|あなたの設定をテーマのコレクションや個人用の設定パーツ (たとえばホスト用の設定) と組み合わせます。テーマの簡単な変更や、柔軟でダイナミックな設定のカスタマイズを可能にします。|https://github.com/okraits/j4-make-config|{{Aur|j4-make-config-git}}}}

=== i3bar ===

i3bar はワークスペースの情報を表示するほかに、次のセクションで説明している、i3status などに入力を行うこともできます。例:

{{hc|~/.config/i3/config|2=
bar {
output LVDS1
status_command i3status
position top
mode hide
workspace_buttons yes
tray_output none

font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1

colors {
background #000000
statusline #ffffff

focused_workspace #ffffff #285577
active_workspace #ffffff #333333
inactive_workspace #888888 #222222
urgent_workspace #ffffff #900000
}
}
}}

詳しくは [http://i3wm.org/docs/userguide.html#_configuring_i3bar Configuring i3bar] を見て下さい。

==== i3bar の代替 ====

旧来の[[デスクトップ環境]]に入っているようなパネルを使いたいというユーザーもいるかもしれません。起動時に i3 の中でパネルアプリケーションを起動することで他のパネルを使うことができます。

[[Xfce#パネル|XFCE パネル]]の場合、次の行を {{ic|~/.config/i3/config}} のどこかに追加してください:

exec --no-startup-id xfce4-panel --disable-wm-check

{{Note|[[デスクトップ環境]]固有のパネル機能は基本的に動作しません (例: ワークスペースやセッションを管理するウィジェット)、ただし i3 の機能がそれによって影響を受けることはないはずです。}}

{{ic|~/.config/i3/config}} の {{ic|<nowiki>bar{ }</nowiki>}} セクションをコメントアウトすることで i3bar は無効にできます。
もしくは以下を使ってください:

{{hc|~/.config/i3/config|
# bar toggle, hide or show
bindsym $mod+m bar mode toggle
}}

この方法では好きなようにバーを表示したり隠したりできます。

=== i3status ===

デフォルトの設定ファイルをホームディレクトリにコピーしてください:

$ cp /etc/i3status.conf ~/.config/i3status/config

デフォルトの設定では定義されていないプラグインがあり、いくつかの設定あなたのシステムでは無効かもしれません。
そのためシステムに応じて設定を更新する必要があります。詳しくは {{ic|man 1 i3status}} を見て下さい。

==== i3status の代替 ====

* {{App|[[conky]]|拡張性の高いシステムモニター。i3bar で使用する場合は [http://i3wm.org/docs/user-contributed/conky-i3bar.html このチュートリアル] を見て下さい。|https://github.com/brndnmtthws/conky|{{Pkg|conky}}}}
* {{App|i3blocks|シェルスクリプトで拡張することができます。クリックイベントや割り込み、ブロックごとによるリフレッシュ間隔の定義などを管理可能。|https://github.com/vivien/i3blocks|{{AUR|i3blocks}}}}
* {{App|i3phtatus|PHP で書かれた i3status の代替。簡単に拡張できます。|https://github.com/mwgg/i3phtatus}}
* {{App|goi3bar|Go で書かれた i3status の代替。コンポーネントを自由にアップデートすることができます。|https://github.com/denbeigh2000/goi3bar}}
* {{App|i3pystatus|デフォルトで多数のプラグインと設定オプションがある拡張可能な Python 3 ステータスバー。|https://github.com/enkore/i3pystatus i3pystatus|{{AUR|i3pystatus-git}}}}
* {{App|i3situation|もうひとつの Python 3 ステータスバージェネレータ。|https://github.com/HarveyHunt/i3situation|{{Aur|i3situation-git}}}}
* {{App|j4status|C で書かれており、プラグインで設定ができる、ステータスラインを提供します。追加プラグインは {{Aur|j4status-plugins-git}} に入っています。|http://j4status.j4tools.org/|{{Aur|j4status-git}}}}

==== i3status のラッパー ====

* {{App|[[en2:h2status|h2status]]|i3status の Bash ラッパー、カスタム json エントリを入力として、非同期のステータスバーの更新だけでなくクリックイベントの処理が可能。|https://wiki.archlinux.org/index.php/H2status|{{Aur|h2status}}}}
* {{App|i3cat|[[go]] ベースのラッパーで外部の複数のソースからの入力を繋げることができます。クリックイベントの処理、ユーザーが定義した信号を子プロセスに転送することが可能。|http://vincent-petithory.github.io/i3cat/|{{AUR|i3cat-git}}}}
* {{App|py3status|Python による拡張可能な i3status ラッパー。|https://github.com/ultrabug/py3status|{{Aur|py3status}}}}

==== ステータスバーにアイコンフォント ====

''i3bar'' には XBM アイコンサポートの[[#パッチ|パッチ]]をあてることができますが、代わりにアイコンフォントを使うこともできます。

* {{App|ttf-font-awesome|CSS でカスタマイズできるスケーラブルなベクターアイコン。それぞれの記号の Unicode を記した [http://fortawesome.github.io/Font-Awesome/cheatsheet/ チートシート] があります。|http://fortawesome.github.io/Font-Awesome/|{{AUR|ttf-font-awesome}}}}
* {{App|ttf-font-icons|Awesome と Ionicons の重複をなくしてサイズを合わせたミックス。DejaVu Sans と Awesome が重複しないようにします。|http://kageurufu.net/icons.pdf|{{AUR|ttf-font-icons}}}}

フォントを混ぜ合わせるには、設定ファイルにフォントのフォールバックを定義してください、以下のように {{ic|,}} でフォントを区切ります:
{{hc|~/.config/i3/config|2=
bar {
...
font pango:DejaVu Sans Mono, Icons 8
...
}
}}

[https://developer.gnome.org/pango/stable/pango-Fonts.html#pango-font-description-from-string pango syntax] に従って、カンマで区切ったフォントファミリーのリストを記述してそれから一番後ろにサイズをひとつだけ指定してください。
各フォントにサイズを設定するのは最後のフォントを除いて無視される原因となります。

最後に、アイコングラフをフォーマット文字列にして {{ic|~/.config/i3status/config}} に入力します。入力するために、上でリンクしているチートシートを見てユニコード番号を使います。入力方法はテキストエディタによって異なります。例えば "ハート" アイコン (ユニコード番号 f004) を入力するには:

* 様々な GUI のテキストエディタ (例: [[gedit]] や Leafpad) とターミナル (例: GNOME Terminal, xfce4-terminal): {{ic|ctrl+shift+u}}, {{ic|f004}}, {{ic|Enter}}
* [[Emacs]]: {{ic|ctrl+x}}, {{ic|8}}, {{ic|Enter}}, {{ic|f004}}, {{ic|Enter}}
* [[Vim]] (挿入モード): {{ic|Ctrl+v}}, {{ic|uf004}}
* [[urxvt]]: {{ic|Ctrl+Shift}} を押して、{{ic|f004}} を入力

=== ターミナルエミュレータ ===

デフォルトでは {{ic|$mod+Return}} を押すとターミナルを呼び出すスクリプトの {{ic|i3-sensible-terminal}} が起動します。ターミナルを呼び出す順番については {{ic|man i3-sensible-terminal}} を見て下さい。

他のターミナルを起動するには、{{ic|~/.config/i3/config}} の次の行を変更してください:

bindsym $mod+Return exec i3-sensible-terminal

または、{{ic|$TERMINAL}} 変数を[[環境変数#ユーザーごと|ローカルで定義]]してください:

$ export TERMINAL=''yourterminal''

== Tips and tricks ==

=== 高度なウィンドウナビゲーション ===

[http://www.slackword.net/?p=657 i3 window Navigation Tips] を見て下さい。

=== Jump to open window ===

*{{App|quickswitch-i3|i3 でウィンドウを素早く切り替え・確認するための Python ユーティリティ。|https://github.com/proxypoke/quickswitch-for-i3|{{Aur|quickswitch-i3}}}}
*{{App|i3-wm-scripts|正規表現にマッチする名前を持ったウィンドウを検索してジャンプ。|https://github.com/yiuin/i3-wm-scripts||}}
*{{App|winmenupy|クライアントのリストと一緒に dmenu を起動、ワークスペースの後にソートされます。クライアントを選択するとそのウィンドウにジャンプ。|https://github.com/ziberna/i3-py/blob/master/examples/winmenu.py||}}
*{{App|rofi|スクラッチパッドウィンドウを検索してジャンプして開く。|https://davedavenport.github.io/rofi/|{{Pkg|rofi}}}}

=== Jump to urgent window ===

{{ic|.i3/config}} に次を追加: [https://faq.i3wm.org/question/853/how-to-jump-to-urgent-workspace/]

bindsym $mod+x [urgent=latest] focus

=== ウィンドウレイアウトの保存と復元 ===

バージョン 4.8 から、''i3'' ワークスペースレイアウトの保存・復元が可能になっています。これを行うには、次のパッケージが必要です: [[公式リポジトリ]]から {{Pkg|perl-anyevent-i3}} と {{Pkg|perl-json-xs}}。

{{note| This section only provides quick tutorial on how to save the current window layout of a single workspace and how to restore it for later use. Refer to the [http://i3wm.org/docs/layout-saving.html official documentation] for more details}}

==== Save the current window layout of a single workspace ====

To save the current window layout, follow these steps:

# First, execute various commands to open windows in a preferred workspace and resize them if needed. Make sure to write down each executed command for each window.
# Now, in a new workspace, open a terminal and run the following: {{bc|i3-save-tree --workspace N > ~/.i3/workspace_N.json}} where N is the number of the preferred workspace. This will save the current layout of workspace N to the file {{ic|~/.i3/workspace_N.json}}.
# The newly created file needs to be edited, however this may be done with the following commands: {{bc|<nowiki>tail -n +2 ~/.i3/workspace_N.json | fgrep -v '// splitv' | sed 's|//||g' > ~/.i3/workspace_N.json</nowiki>}}

==== Restore the window layout of the workspace ====

There are two ways to restore the layout of the workspace: by writing a script, or by editing {{ic|~/.i3/config}} to automatically load the layout. In this section only the first case will be considered, refer to the [http://i3wm.org/docs/layout-saving.html#_restoring_the_layout official documentation] for the second case.

To restore the saved layout in the previous section, write a file named {{ic|load_layout.sh}} with the following contents:

* The starting lines:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"
}}

where M is the number of the workspace in which you would like to load the previously saved layout and N is the number of workspace saved in the previous section.
* And the commands used in the previous section to get the preferred windows, but enclosed in parentheses and with an ampersand appended before the last parentheses.

For example, if the saved layout contained three {{ic|uxterm}} windows:

{{hc|head=~/load_layout.sh|output=
#!/bin/bash

# First we append the saved layout of worspace N to workspace M
i3-msg "workspace M; append_layout ~/.i3/workspace_N.json"

# And finally we fill the containers with the programs they had
(uxterm &)
(uxterm &)
(uxterm &)
}}

Then set the file as executable:

chmod u+x ~/load_layout.sh

And finally, the layout of worskpace N can be loaded onto to workspace M by running:

~/load_layout.sh

{{tip|Adding {{ic|bindsym $mod+g exec ~/load_layout.sh}} to {{ic|~/.i3/config}} and restarting i3 will bind Mod+g to run the above script.}}

{{note|If the above script does not work properly, refer to the [http://i3wm.org/docs/layout-saving.html#_editing_layout_files official documentation]. The ''swallows'' sections of {{ic|~/.i3/workspace_N.json}} needs to be manually edited.}}

=== スクラッチパッドコンテナ ===

デフォルトでは、[http://i3wm.org/docs/userguide.html#_scratchpad スクラッチパッド] は一つのウィンドウしか含んでいません。しかしながら、コンテナをスクラッチパッドにすることが可能です。

新しいコンテナを作成して (例えば、{{ic|Mod+Enter}})、コンテナを分割し ({{ic|Mod+v}}) 別のコンテナを作成します。親にフォーカスして ({{ic|Mod+a}})、反対方向に分割し ({{ic|Mod+h}})、もう一度作成します。

最初のコンテナにフォーカスして (必要なら親にもフォーカス)、ウィンドウをフロートさせ ({{ic|Mod+Shift+Space}})、スクラッチパッドに移動します ({{ic|Mod+Shift+-}})。これで自由にコンテナを分割できます。

{{Note|フロートしているウィンドウでコンテナのサイズを個別に変更することはできません。ウィンドウをフロートさせる前にコンテナのサイズを変えて下さい。}}

{{Tip|ターミナルアプリケーションしか使わない場合は、代わりに [[tmux]] などのマルチプレクサを使っても良いでしょう。}}

マルチスクラッチパッドについては [https://faq.i3wm.org/question/138/multiple-scratchpad/i3] も参照してください。

=== スクリーンセーバーと電源管理 ===

With [[電源管理#xss-lock]] you can register a screenlocker for your i3 session.

Alternatively, ''xautolock'' can lock the screen after awakening from sleep or hibernation with the {{ic|-lockaftersleep}} option. The {{ic|-time}} option locks the screen after a given time period.

xautolock -time 10 -locker "i3lock -i 'background_image.png'" -lockaftersleep &

See also [[DPMS]].

=== シャットダウン, 再起動, 画面ロック ===

シャットダウン、再起動、画面ロックのキーコンビネーションを {{ic|~/.config/i3/config}} に追加することができます。以下の例では[[systemd#電源管理|電源管理]]コマンドを実行する権限がないユーザーに権限を与えるために {{Pkg|polkit}} をインストールする必要があります。

{{bc|
set $Locker i3lock && sleep 1

set $mode_system System (l) lock, (e) logout, (s) suspend, (h) hibernate, (r) reboot, (Shift+s) shutdown
mode "$mode_system" {
bindsym l exec --no-startup-id $Locker, mode "default"
bindsym e exec --no-startup-id i3-msg exit, mode "default"
bindsym s exec --no-startup-id $Locker && systemctl suspend, mode "default"
bindsym h exec --no-startup-id $Locker && systemctl hibernate, mode "default"
bindsym r exec --no-startup-id systemctl reboot, mode "default"
bindsym Shift+s exec --no-startup-id systemctl poweroff -i, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}

bindsym $mod+Pause mode "$mode_system"
}}

Once completed, you will be presented with a prompt whenever you press {{ic|$mod+pause}}. For more complex behaviour, use a separate script, and refer to it in the mode. [https://gist.github.com/anonymous/c8cd0a59bf4acb273068]

{{Note|1=<br>
* {{ic|sleep 1}} adds a small delay to prevent possible race conditions with suspend [https://bugs.launchpad.net/ubuntu/+source/unity-2d/+bug/830348]
* The {{ic|-i}} argument for {{ic|systemctl poweroff}} causes a shutdown even if other users are logged-in (this requires {{Pkg|polkit}}), or when ''logind'' (wrongly) assumes so. [https://bugs.freedesktop.org/show_bug.cgi?id=62676]
}}

他の画面ロッカーについては、[[アプリケーション一覧/セキュリティ#スクリーンロック]]を参照。

===External displays manual management===

Thanks to [[xrandr]] there are many ways to easily manage systems displays. The below example integrates it in the i3 config file, and behave as the Power Management section above.

Here a laptop with both VGA and HDMI outputs will use a menu selection to switch them On/Off:

## Manual management of external displays
# Set the shortcuts and what they do
set $mode_display Ext Screen (v) VGA ON, (h) HDMI ON, (x) VGA OFF, (y) HDMI OFF
mode "$mode_display" {
bindsym v exec --no-startup-id xrandr --output VGA1 --auto --right-of LVDS1, mode "default"
bindsym h exec --no-startup-id xrandr --output HDMI1 --auto --right-of LVDS1, mode "default"
bindsym x exec --no-startup-id xrandr --output VGA1 --auto --off, mode "default"
bindsym y exec --no-startup-id xrandr --output HDMI1 --auto --off, mode "default"

# back to normal: Enter or Escape
bindsym Return mode "default"
bindsym Escape mode "default"
}
# Declare here the shortcut to bring the display selection menu
bindsym $mod+x mode "$mode_display"

Any window that is still open in a switched Off display will automatically come back to the remaining active display.

The simplest way to determine names of your devices is to plug the device you wish to use and run:

$ xrandr --query

which will output the available, recognized devices and their in-system names to set your config file appropriately.

Refer to the [[xrandr]] page or man page for the complete list of available options, the [http://i3wm.org/docs/userguide.html i3 userguide] and/or the [https://www.reddit.com/r/i3wm i3 FAQ on reddit] for more info.

=== タブまたはスタックによるウェブブラウジング ===

タブの管理はブラウザの仕事ではなく、ウィンドウマネージャの仕事だとして、故意にタブを実装していないウェブブラウザというのが存在します。

[[uzbl]] など、タブのないウェブブラウザを i3 で管理するには、次の行を {{ic|~/.config/i3/config}} に追加して下さい:

for_window [class="Uzbl-core"] focus child, layout stacking, focus

これはスタックのウェブブラウジング用で、ウィンドウは縦に表示されます。タブブラウジングと違って、たとえブラウザのウィンドウを大量に開いていても、ウィンドウのタイトルを全て見ることができます。

水平方向のタブブラウジングの方が良い場合は ('タブ')、次を使って下さい:

for_window [class="Uzbl-core"] focus child, layout tabbed, focus

=== ワークスペース変数 ===

i3 ではワークスペースを複数定義するので、ワークスペース変数を指定すると便利です。例えば [https://github.com/dkeg/bloat2.0/blob/master/i3config#L55]:

set $WS1 term
set $WS2 web
set $WS3 misc
set $WS4 media
set $WS5 code

次にワークスペースの名前を対応する変数で置き換えます:

bindsym $mod+1 workspace $WS1
...
bindsym $mod+Shift+1 move container to workspace $WS1

詳しくは [http://i3wm.org/docs/userguide.html#_changing_named_workspaces_moving_to_workspaces Changing named workspaces] を見て下さい。

=== フロートするダイアログを正しく扱う ===

デフォルトではダイアログはフロートモードで開かれることになっていますが [http://i3wm.org/docs/userguide.html#_floating]、ダイアログはタイルモードで開いてしまうこともあります。この挙動を変更するには {{pkg|xorg-xprop}} でダイアログの {{ic|WM_WINDOW_ROLE}} をチェックして適切なルールを {{ic|~/.i3/config}} に追加してください:

for_window [window_role="pop-up"] floating enable
for_window [window_role="task_dialog"] floating enable

また、タイトルルールと正規表現を使うこともできます:

for_window [title="Preferences$"] floating enable

または {{ic|WM_CLASS}}:

for_window [class="(?i)mplayer"] floating enable

=== Network Download/Upload speed on statusbar ===

You might adapt this upstream [http://code.stapelberg.de/git/i3status/tree/contrib/measure-net-speed.bash script]. For that,

* rename both network cards according to your system (use {{ic|ip addr}})
* find them on {{ic|/sys/devices}} then replace them appropriately:
$ find /sys/devices -name ''network_interface''

{{Tip|Use {{ic|/sys/class/net/''interface''/statistics/}} to not depend on PCI location.}}

Now, just save the script in a suitable place (for example {{ic|~/.config/i3}}) and point your status program to it.

== パッチ ==

上流にマージされてないパッチがあてられたパッケージが [[AUR]] には存在します:

* {{App|i3bar-icons-git|i3bar で XBM アイコンを表示|https://github.com/ashinkarov/i3-extras|{{AUR|i3bar-icons-git}}}}
* {{App|i3-smart-border|スマートボーダー|https://github.com/ashinkarov/i3-extras|{{AUR|i3-smart-border}}}}
* {{App|i3-wm-iconpatch|タイトルバーアイコンのサポート|https://github.com/ashinkarov/i3-extras|{{AUR|i3-wm-iconpatch}}}}

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

=== 一般 ===

多くの場合、バグは開発版である {{AUR|i3-git}} と {{AUR|i3status-git}} で修正されているため上流では開発版を使ってエラーが再現できるかどうか訊いてきます。 [http://i3wm.org/docs/debugging.html] [[デバッグ - トレースを取得#一般]]も見てください。

=== i3 メッセージバーのボタンが動作しない ===

{{ic|i3-nagbar}} の "Edit config" などのボタンは {{ic|i3-sensible-terminal}} を呼び出します。[[#ターミナルエミュレータ|ターミナルエミュレータ]]が i3 によって認識されていることを確認してください。

=== タイル化されたターミナルで行の折り返しがおかしい ===

i3 v4.3 以上ではタイル配置したウィンドウのサイズ増加ヒントは無視されます [https://www.mail-archive.com/i3-discuss@i3.zekjur.net/msg00709.html]。これによってターミナルで行が早いところで折り返されてしまうなどの問題が生じます。解決方法としては、問題のウィンドウをフロートさせてから、もう一度タイル化してください。

=== マウスカーソルが待機状態のままになる ===

起動通知をサポートしていないスクリプやアプリケーションを起動すると、マウスカーソルは60秒間の間、ビジー/砂時計状態になります。

特定のアプリケーションでこの問題を解決するには、{{ic|--no-startup-id}} パラメータを使って下さい、例えば:
exec --no-startup-id ~/script
bindsym $mod+d exec --no-startup-id dmenu_run

このアニメーションを全てのアプリケーションで無効にするには、[[カーソルテーマ]]を見て下さい。

=== キーバインドが反応しない ===

標準のキーバインド (キーを押して実行) を使っている場合、[[スクリーンショットの取得#scrot|scrot]] などのツールが動作しないことがあります。そのようなときは、{{ic|--release}} でキーをリリースしてからコマンドを実行してください:

bindsym --release Print exec --no-startup-id scrot '%Y-%m-%d$
bindsym --release Shift+Print exec --no-startup-id scrot '%Y$

[http://i3wm.org/docs/userguide.html#keybindings] を参照。

=== ティアリング ===

i3 は [http://bugs.i3wm.org/report/ticket/661 ダブルバッファをちゃんと実装していない] ためにティアリングやちらつきが発生することがあります。問題を修正したいときは、[[Xorg#コンポジット|コンポジットマネージャ]]を使ってみて下さい。

=== トレイアイコンが表示されない ===

デフォルトの {{ic|tray_output primary}} ディレクティブでは ''xrandr'' でプライマリ出力を設定する必要があります。明示的に出力を指定するか、ディレクティブを削除してください [https://github.com/i3/i3/issues/1144]。詳しくは [[Xrandr]] を参照。i3 のバージョン 4.12 から、i3-config-wizard によって作成されるデフォルト設定ではディレクティブが追加されないようになりました。

== 参照 ==

* [http://i3wm.org 公式ウェブサイト]
* [http://www.funtoo.org/I3_Tiling_Window_Manager funtoo Wiki]
* [http://code.stapelberg.de/git/i3 i3 ソースコード]
* [https://github.com/ashinkarov/i3-extras i3-extras] - Collection of scripts and patches
* [https://github.com/acrisci/i3ipc-glib i3ipc-glib] - i3 拡張のためのライブラリ
* [https://github.com/veelenga/i3ipc-ruby i3ipc-ruby] - An improved library for i3 extensions in Ruby
* [http://www.j4tools.org/ j4tools] - non-official tools designed to work with i3

'''Arch Linux フォーラム'''
* [https://bbs.archlinux.org/viewtopic.php?id=99064 The i3 thread] - A general discussion about i3
* [https://bbs.archlinux.org/viewtopic.php?id=103369 i3 desktop screenshots and config sharing]

'''スクリーンキャスト'''
* [http://www.youtube.com/watch?v=Wx0eNaGzAZU i3 window manager v4.1 screencast]
* [https://www.youtube.com/watch?v=j1I63wGcvU4&index=1&list=PL5ze0DjYv5DbCv9vNEzFmP6sU7ZmkGzcf i3 window manager v4.1X screencasts]

Certbot

2016-06-15T12:03:30Z

Colajam93: Let's EncryptクライアントからCertbotに置換

[[Category:ネットワーク]]
[[Category:セキュリティ]]
[[en:Let’s Encrypt]]
[https://letsencrypt.org/ Let’s Encrypt] はフリーかつ自動化されたオープンな認証局です。公式クライアントは '''Certbot''' と呼ばれており、コマンドラインから有効な SSL 証明書を取得できます。

{{Note|以前 ''Let’s Encrypt client'' と呼ばれていた公式クライアントは、現在 ''Certbot'' と呼ばれています。}}

== Certbot ==

''Certbot'' は公式のリファレンスクライアントです。Python で書かれており、証明書を取得するためのコマンドラインツールを提供します。

== インストール ==

{{Pkg|certbot}} パッケージを[[インストール]]してください。

手動で CSR 作成を行うミニマルなクライアントを {{AUR|acme-tiny}} でインストールすることができます。スクリプトで使用するのに適したクライアントとして {{AUR|simp_le-git}} や {{AUR|letsencrypt-cli}} も存在します。

公式クライアントを用いて発行された証明書はプラグインを使ってウェブサーバーに自動的に設定・インストールできます:
* [[Nginx]] 用の実験的なプラグインは {{Pkg|certbot-nginx}} パッケージに入っています。
* {{Pkg|certbot-apache}} パッケージも存在していますが、[[Apache HTTP Server]] を使っている場合の自動インストールは現在 Debian の派生ディストリビューションでしかサポートされていません。

== 設定 ==

証明を作成・インストールする方法は [https://certbot.eff.org/docs/ Certbot のドキュメント] を参照してください。証明書の作成方法がはっきりしたら、この wiki にも記載します。

=== 手動 ===

{{Note|この方法では、一時的にウェブサーバーを停止する必要があります。[[#Webroot]] の方法ではウェブサーバーを実行しながらでも認証が行えます。}}

ウェブサーバーのプラグインが存在しない場合、次のコマンドを使って下さい:
# certbot certonly --manual

上記のコマンドで自動的にドメインが認証されて秘密鍵と証明書のペアが作成されます。秘密鍵と証明書は {{ic|/etc/letsencrypt/live/''your.domain''/}} に保存されます。

上記のディレクトリに入っている秘密鍵と証明書を使用するように手動でウェブサーバーを設定します。

=== Webroot ===

webroot を使うことでウェブサーバー (例: Apache/nginx) を止めることなく証明書を取得・更新できます。

# certbot certonly --email ''email@example.com'' --webroot -w ''/path/to/html/'' -d ''your.domain''

サーバーの設定で {{ic|/etc/letsencrypt/live/''your.domain''/}} の証明書を使うようにしてください。

==== 自動更新 ====

{{ic|certbot certonly}} を実行するとき、Certbot はドメインと webroot ディレクトリを {{ic|/etc/letsencrypt/renewal}} に記録します。次回からは {{ic|certbot renew}} を実行することで証明書を自動更新することができます。

以下の {{ic|.service}} ファイルを作成することで完全に自動化することが可能です:

{{hc|1=/etc/systemd/system/certbot.service|
2=[Unit]
Description=Let's Encrypt renewal

[Service]
Type=oneshot
ExecStart=/usr/bin/certbot renew}}

[[systemd/タイマー|タイマー]]を追加する前に、サービスが正しく動作すること、何も入力が要求されないことを確認してください。

それから、タイマーを追加することで毎月証明書を更新できます。

{{hc|1=/etc/systemd/system/certbot.timer|
2=[Unit]
Description=Monthly renewal of Let's Encrypt's certificates

[Timer]
OnCalendar=monthly
Persistent=true

[Install]
WantedBy=timers.target}}

{{ic|certbot.timer}} を[[起動]]・[[有効化]]してください。また、証明書をいますぐ更新したい場合は {{ic|certbot.service}} を[[起動]]してください。

証明書を更新するたびにウェブサーバーを再起動させることもできます。{{ic|certbot.service}} ファイルに以下のどちらかの行を追加してください:

* Apache: {{ic|1=ExecStartPost=/usr/sbin/systemctl restart httpd.service}}
* nginx: {{ic|1=ExecStartPost=/usr/sbin/systemctl restart nginx.service}}

== 参照 ==

* [https://community.letsencrypt.org/t/list-of-client-implementations/2103 ACME クライアントの一覧]