summaryrefslogtreecommitdiff
path: root/doc/ja/weechat_faq.ja.asciidoc
blob: 9be3e18a917efc2d4f3975310092f39b9cc7e0fe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
= WeeChat FAQ (よくある質問)
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:toc:
:toc-title: 目次
:toc-placement: manual


翻訳者:

* Ryuunosuke Ayanokouzi <i38w7i3@yahoo.co.jp>, 2012-2014

[NOTE]
この文書は WeeChat バージョン 0.3.0 以上向けに書かれたものですが、
最新安定版の WeeChat に対しても利用できます。

toc::[]


[[general]]
== 一般

[[weechat_name]]
=== "WeeChat" という名前の由来は何ですか?

"Wee" は再帰的頭字語で、"Wee Enhanced Environment" の略です。
そのため、完全な名前は "Wee Enhanced Environment for Chat" です。

"Wee" はまた "とても小さい" を意味します。(もちろん、
その他の意味もありますが、それは WeeChat とは関係ありませんよ!)。

[[why_choose_weechat]]
=== WeeChat を選ぶ理由は何ですか? X-Chat や Irssi は最高なのに...

WeeChat は非常に軽く、革新的な機能を備えているからです。

こののページに関するより詳しい情報: https://weechat.org/about/features

[[compilation_install]]
== コンパイル / インストール

[[gui]]
=== WeeChat には多くの GUI があると聞きました。コンパイル/利用方法を教えてください。

いくつかのリモート GUI が利用可能です、機能のページに載っているリンクをご覧ください:
https://weechat.org/about/features

[[compile_git]]
=== git リポジトリをクローンした後に WeeChat をコンパイルできません。

WeeChat をコンパイルするには cmake を使うことが推奨されています。

autotools を使って (cmake を使わずに) コンパイルする場合、
最新の autoconf と automake を使ってください。

他には "開発パッケージ" をインストール方法があります。この場合、
インストールするのに必要なパッケージの数が減ります。このパッケージは git
リポジトリからほぼ毎日ビルドされます。このパッケージは厳密には git ベースではなく、
アップデートをインストールする場合には git をクローンする方法よりも不便であることに注意してください。

[[compile_osx]]
=== どうすれば OS X に WeeChat をインストールできますか?

http://brew.sh/[Homebrew] を使うことをお勧めします、ヘルプを見るには:

----
brew info weechat
----

以下のコマンドで WeeChat をインストールします:

----
brew install aspell
brew install weechat --with-aspell --with-curl --with-python --with-perl --with-ruby --with-lua --with-guile
----

[[lost]]
=== WeeChat を起動しました。でも何をすればいいかわかりません。

ヘルプを見るには、`/help` と入力してください。コマンドに関するヘルプを見るには、`/help command` と入力してください。
キーとコマンドはドキュメント内にリストアップされています。

新しいユーザはクイックスタートガイドを読むことをお勧めします:
https://weechat.org/doc

[[display]]
== 表示

[[charset]]
=== いくつかの文字が見えません。どうすれば良いですか。

これは良くある問題です。以下の内容をよく読んで、*全ての* 解決策をチェックしてください:

* weechat が libncursesw にリンクされていることの確認 (警告: 全てではありませんが、
  ほとんどのディストリビューションで必要です): `ldd /path/to/weechat`
* `/plugin` コマンドで "Charset" プラグインがロード済みであることの確認
  (ロードされていない場合、"weechat-plugins" パッケージが必要かもしれません) 。
* `/charset` コマンドの出力を確認 (core バッファ上で)。
  ターミナルの文字セットとして 'ISO-XXXXXX' 又は 'UTF-8' があるはずです。
  その他の値がある場合は、ロケールが間違っている可能性があります ($LANG を修正してください)。
* グローバルデコードを設定、例えば:
  `/set charset.default.decode "ISO-8859-15"`
* UTF-8 ロケールを使っている場合は:
** ターミナルで UTF-8 が使えることを確認 (UTF-8 対応のターミナルとしては
   rxvt-unicode を推奨)
** screen を使っている場合は、UTF-8 モードで起動されていることを確認
   (~/.screenrc に "`defutf8 on`" の記述があるか又は `screen -U` のようにして起動)。
* 'weechat.look.eat_newline_glitch' オプションが off であることを確認してください
  (このオプションは表示上のバグを引き起こす可能性があります)

[NOTE]
WeeChat は UTF-8 ロケールを推奨します。ISO 又はその他のロケールを使う場合、
*全ての* 設定 (ターミナル、screen、..) が ISO であり、
UTF-8 *でない* ことを確認してください。

[[bars_background]]
=== タイトルやステータスバー等の背景色が行末ではなくテキストの最後で終わってしまいます。

シェルの TERM 変数に間違った値が設定されている可能性があります
(ターミナルで `echo $TERM` の出力を確認してください)。

WeeChat を起動した場所に依存しますが、以下の値を持つはずです:

* WeeChat を screen を使わずにローカル又はリモートマシンで起動した場合、
  利用しているターミナルに依存します: 'xterm' 、'xterm-256color' 、'rxvt-unicode' 、
  'rxvt-256color' 、...
* WeeChat を screen 内で起動した場合、'screen' 又は 'screen-256color' 。

もし必要であれば、TERM 変数を修正してください: `export TERM="xxx"`

[[screen_weird_chars]]
=== weechat を screen/tmux の中で使っている場合、おかしなランダム文字列が表示されます。どうすれば直りますか。

シェルの TERM 変数に間違った値が設定されている可能性があります。
(ターミナル、*screen/tmux の外* で `echo $TERM` の出力を確認してください)。

例えば、'xterm-color' の場合、おかしな文字列が表示される可能性があります。'xterm'
と設定すればこのようなことは起こらないので (その他多くの値でも問題は起きません)、これを使ってください。

もし必要であれば、TERM 変数を修正してください: `export TERM="xxx"`

[[osx_display_broken]]
=== OS X 上で WeeChat をコンパイルした場合、"(null)" という文字列が至る所に表示されます。

ncursesw を自分でコンパイルした場合は、標準の (システムに元から存在する)
ncurses を使ってみてください。

さらに OS X では、Homebrew パッケージマネージャを使って
WeeChat をインストールすることをお勧めします。

[[buffer_vs_window]]
=== "バッファ" と "ウィンドウ" の違いは何ですか。

'バッファ' とは番号、名前、表示行、(とその他のデータ)
からなります。

'ウィンドウ' とはバッファを表示する画面領域です。
画面を複数のウィンドウに分割出来ます。

それぞれのウィンドウは 1 つのバッファの内容を表示します。バッファを隠す
(ウィンドウで表示させない) ことや 1 つ以上のウィンドウに表示させることも出来ます。

[[buffers_list]]
=== どうすれば左側にバッファリストを表示できますか。

'buffers.pl' スクリプトを使ってください:

----
/script install buffers.pl
----

バーのサイズを制限するには:

----
/set weechat.bar.buffers.size_max 15
----

バーの位置を下に移動するには:

----
/set weechat.bar.buffers.position bottom
----

[[customize_prefix]]
=== どうすればチャットエリア内のニックネームの最大長さを短く、又はニックネーム整列機能を無効化できますか。

チャットエリアのニックネームの最大長を短くするには:

----
/set weechat.look.prefix_align_max 15
----

ニックネーム整列を抑制するには:

----
/set weechat.look.prefix_align none
----

[[input_bar_size]]
=== コマンドラインの行数を増やすにはどうすればいいですか。

インプットバーの 'size' オプションには 1 (サイズ固定、デフォルト値)
以上の値又は動的なサイズの意味で 0 を設定できます。'size_max'
オプションではサイズの最大値を設定できます (0 = 制限なし)。

動的サイズを設定する例:

----
/set weechat.bar.input.size 0
----

サイズの最大値を 2 に設定:

----
/set weechat.bar.input.size_max 2
----

[[one_input_root_bar]]
=== 全てのウィンドウに対して入力バーの数を 1 つだけにすることができますか (画面分割されている場合)。

できます。"root" 型のバー (あなたのいるウィンドウを区別するためのアイテムを持つ)
を作成し、現在の入力バーを削除してください。

例えば:

----
/bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text
/bar del input
----

これに満足できない場合は、新しいバーを削除してください。
全てのバーに "input_text" アイテムが設定されていない場合は
WeeChat は自動的にデフォルトバー "input" を作成します:

----
/bar del rootinput
----

[[terminal_copy_paste]]
=== どうすればニックネームリストを選択せずにテキストだけをコピー/ペーストできますか。

WeeChat ≥ 1.0 では、最小限表示を使うことができます (デフォルトキー: key[alt-l])。

矩形選択のできるターミナルを使ってください (rxvt-unicode、
konsole、gnome-terminal、...)。通常、キーは key[ctrl-]key[alt-] マウス選択です。

別の解決策はニックネームリストを上か下かに移動することです、例えば:

----
/set weechat.bar.nicklist.position top
----

[[urls]]
=== どうすれば長い (一行以上に渡る) URL をクリックできますか。

WeeChat ≥ 1.0 では、最小限表示を使うことができます (デフォルトキー: key[alt-l])。

デフォルトでは、WeeChat はそれぞれの行の最初に時間とプレフィックス、
さらにチャットエリアを囲むようにオプションバーを表示します。url のクリックを簡単にするには、
ニックネームリストを上に移動して、ニックネーム整列機能を無効化する方法があります:

----
/set weechat.bar.nicklist.position top
/set weechat.look.prefix_align none
/set weechat.look.align_end_of_lines time
----

WeeChat ≥ 0.3.6 では、"eat_newline_glitch" オプションを有効化できます。
これを有効化すると、表示行の行末に改行文字が入らなくなります
(url 選択を邪魔しません)。

----
/set weechat.look.eat_newline_glitch on
----

[IMPORTANT]
このオプションには表示上の問題を引き起こす可能性があります。
表示上の問題が起きた場合はこのオプションを無効化してください。

別の解決策として、スクリプトを利用することもできます:

----
/script search url
----

[[change_locale_without_quit]]
=== WeeChat が出力するメッセージの言語を、再起動せずに変更したいです。このようなことは可能ですか。

WeeChat ≥ 1.0 では、再起動せずに変更できます:

----
/set env LANG ja_JP.UTF-8
/upgrade
----

古い WeeChat をお使いの場合は:

----
/script install shell.py
/shell setenv LANG=ja_JP.UTF-8
/upgrade
----

[[use_256_colors]]
=== どうすれば WeeChat で 256 色が使えますか。

256 色は WeeChat ≥ 0.3.4 でサポートされます。

最初に 'TERM' 環境変数が正しいことを確認してください、
お勧めの値は:

* screen の中: 'screen-256color'
* screen の外: 'xterm-256color' 、'rxvt-256color' 、'putty-256color' 、...

[NOTE]
これらの値を 'TERM' に設定するには、"ncurses-term"
パッケージをインストールする必要があるかもしれません。

screen を使っている場合は、以下の行を '~/.screenrc' に追加してください:

----
term screen-256color
----

'TERM' 変数が間違った値に設定された状態で WeeChat が起動完了している場合は、以下の
2 つのコマンドを使って変数の値を変更してください (WeeChat バージョン 1.0 以上で可能):

----
/set env TERM screen-256color
/upgrade
----

バージョン 0.3.4 では、新しい色を追加するには `/color` コマンドを使ってください。

バージョン 0.3.5 以上では、任意の色番号を利用できます (オプション:
色の別名を追加するには `/color` コマンドを使ってください)。

色管理に関するより詳しい情報はユーザーガイドを読んでください。

[[search_text]]
=== どうすればバッファ内の文字列を検索できますか (irssi の /lastlog の様に)。

デフォルトのキーは key[ctrl-r] です (コマンドは: `/input search_text`)。
ハイライト部分へのジャンプは: key[alt-p] / key[alt-n]

この機能に関するより詳しい情報はユーザーガイドを参照してください (デフォルトのキー割り当て)。

[[terminal_focus]]
=== どうすれば端末にフォーカスが合った時や外れた時にコマンドを実行できますか。

端末に特殊コードを送信してフォーカスイベントを必ず有効化してください。

*重要*:

* 現時点では、'xterm' を除いてこの機能をサポートする端末は*存在しない* ようです。
* screen および tmux ではこの機能を*使うことができません* 。

WeeChat の開始時にコードを送信するには:

----
/set weechat.startup.command_after_plugins "/print -stdout \033[?1004h\n"
----

さらに端末から送信される 2 種類の特殊キーシーケンスに対してコマンドを割り当ててください
(例に挙げた `/print` コマンドは適当なコマンドに書き換えてください):

----
/key bind meta2-I /print -core focus
/key bind meta2-O /print -core unfocus
----

[[key_bindings]]
== キー割り当て

[[meta_keys]]
=== いくつかのメタキーが (alt + key) が動きません。

xterm や uxterm 等のターミナルを利用している場合、いくつかのメタキーはデフォルトでは利用できません。
以下の行を '~/.Xresources' に追加してください:

* xterm の場合:
----
XTerm*metaSendsEscape: true
----
* uxterm の場合:
----
UXTerm*metaSendsEscape: true
----

このファイルを再読み込みするか (`xrdb -override ~/.Xresources`) 又は X を再起動してください。

[[customize_key_bindings]]
=== どうすればキー割り当てをカスタマイズできますか。

キー割り当ては `/key` コマンドでカスタマイズできます。

デフォルトキー key[alt-k] でキーコードを取り込み、これをコマンドラインに入力できます。

[[jump_to_buffer_11_or_higher]]
=== バッファ 11 番 (又はそれ以上の番号) にジャンプするキーは何ですか。

キー key[alt-j] の後に 2 桁の数字を入力します、例えば key[alt-j] その後に key[1]、
key[1] でバッファ 11 番にジャンプします。

これにキーを割り当てることが出来ます、例えば:

----
/key bind meta-q /buffer *11
----

デフォルトキー割り当てのリストはユーザーガイドを参照してください。

[[global_history]]
=== どうすればグローバルヒストリを (バッファヒストリの代わりに) 上下矢印キーで使えますか。

上下矢印キーをグローバルヒストリに割り当ててください (グローバルヒストリに対する
デフォルトのキーは key[ctrl-↑] と key[ctrl-↓] です。

例:

----
/key bind meta2-A /input history_global_previous
/key bind meta2-B /input history_global_next
----

[NOTE]
"meta2-A" と "meta2-B" キーはターミナルによって異なります。 キーコードを
見つけるには key[alt-k] の後にキー (上矢印又は下矢印) を押してください。

[[mouse]]
== マウス

[[mouse_not_working]]
=== マウスが少しも動きません。どうすれば良いですか。

マウスのサポートは WeeChat 0.3.6 以上からです。

最初にマウスを有効化してください:

----
/mouse enable
----

これでマウスが動かない場合は、シェルの TERM 変数を確認してください
(ターミナル内で `echo $TERM` の出力を見てください)。
ターミナルの種類によってはマウスがサポートされていない可能性があります。

マウスサポートをターミナルから確認するには:

----
$ printf '\033[?1002h'
----

ターミナルの最初の文字 (左上) をクリックしてください。" !!#!!" と見えるはずです。

ターミナルのマウスサポートを無効化するには:

----
$ printf '\033[?1002l'
----

[[mouse_coords]]
=== マウスの位置座標 X 又は Y が 94 (または 222) よりも大きい場合にマウス機能が正しく動きません。

一部のターミナルではマウスの位置座標を指定するために ISO 文字だけを使います、
このため X/Y が 94 (または 222) よりも大きい場合は正しく動きません。

マウスの位置座標を指定するのに UTF-8 座標をサポートしているターミナルを使ってください、
例えば rxvt-unicode 等です。

[[mouse_select_paste]]
=== WeeChat でマウスが利用可能な場合、ターミナルのテキストを選択したり、貼り付けるにはどうすれば良いですか。

WeeChat でマウスが利用可能な場合、key[shift] キーを押しながらターミナルをクリックして選択してください、
マウスが無効化されます (例えば iTerm 等の場合、key[shift] の代わりに key[alt] を使ってください)。

[[irc]]
== IRC

[[irc_ssl_connection]]
=== SSL を使うサーバへの接続中に問題が発生しました。どうすればいいですか。

Mac OS X をお使いの場合、必ず `curl-ca-bundle` をインストールして、WeeChat
で証明書へのパスを設定してください:

----
/set weechat.network.gnutls_ca_file "/usr/local/opt/curl-ca-bundle/share/ca-bundle.crt"
----

gnutls ハンドシェイクに関するエラーの場合、Diffie-Hellman キー
(デフォルトは 2048) のサイズを小さくすることを試してみてください:

----
/set irc.server.freenode.ssl_dhkey_size 1024
----

証明書に関するエラーの場合、"ssl_verify" を無効化してください
(接続の機密保護がより甘くなることに注意):

----
/set irc.server.freenode.ssl_verify off
----

[[irc_ssl_handshake_error]]
=== SSL を使うサーバへの接続中に、"TLS handshake failed" というエラーだけが表示されます。どうすれば良いですか。

異なる優先順位文字列を試してみてください (WeeChat 0.3.5 以上)、
"xxx" はサーバ名に書き換えてください。

----
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----

[[irc_ssl_freenode]]
=== どうすれば SSL を使って freenode サーバに接続できますか。

オプション 'weechat.network.gnutls_ca_file' に証明書ファイルへのパスを設定してください。

----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
----

[NOTE]
設定したファイルが自分のシステムに存在することを確認してください
(一般に "ca-certificates" パッケージで提供されます)。

サーバポート、SSL を設定の後に接続してください:

----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
----

[[irc_oauth]]
=== どうすれば "oauth" が必要なサーバに接続出来ますか?

'twitch' などの一部のサーバは接続するために oauth が必要です。

oauth を使うにはパスワードを "oauth:XXXX" のように指定してください。

以下のコマンドでサーバを作成し、接続することができます
(名前とアドレスは適当な値に変更してください):

----
/server add name irc.server.org -password=oauth:XXXX
/connect name
----

[[irc_sasl]]
=== どうすればチャンネル参加前にニックネーム認証を行うことができますか。

サーバで SASL を利用可能なら、nickserv 認証のコマンドを送信するよりも
SASL を利用する方が良いです。例えば:

----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----

If server does not support SASL, you can add a delay (between command and join
of channels):

----
/set irc.server.freenode.command_delay 5
----

[[ignore_vs_filter]]
=== /ignore と /filter コマンドの違いは何ですか。

`/ignore` コマンドは IRC コマンドです、このため IRC バッファ
(サーバとチャンネル) にのみ有効です。
これを使うことでニックネームやホストネームを基準にして、
あるサーバやチャンネルにいる一部のユーザを無視できます
(表示済みメッセージに対しては適用されません)。
マッチするメッセージは IRC プラグインによって表示される前に削除されます
(削除されたメッセージは見えません)。

`/filter` コマンドは core コマンドです、このため任意のバッファに対してこれを有効化できます。
バッファ内の行のプレフィックスと内容に対して付けられたタグや正規表現にマッチする行をフィルタできます。
フィルタされた行は隠されているだけで、削除はされていません、
フィルタを無効化すれば見えるようになります (デフォルトでは key[alt-=] でフィルタの有効無効の切り替えが出来ます)。

[[filter_irc_join_part_quit]]
=== どうすれば IRC チャンネルへの参加/退出/終了メッセージをフィルタできますか。

スマートフィルタを使う場合 (最近発言したユーザの参加/退出/終了メッセージは表示):

----
/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *
----

グローバルフィルタを使う場合 (*全ての* 参加/退出/終了メッセージを隠す):

----
/filter add joinquit * irc_join,irc_part,irc_quit *
----

[NOTE]
ヘルプを見るには: `/help filter` か `/help irc.look.smart_filter`

[[filter_irc_join_channel_messages]]
=== どうすれば IRC チャンネルに参加した際に表示される一部のメッセージをフィルタできますか。

WeeChat バージョン 0.4.1 以上の場合、'irc.look.display_join_message'
オプションを使って、チャンネル参加時に表示するメッセージの種類を選択できます
(より詳しい情報は `/help irc.look.display_join_message` を参照)。

メッセージを隠す (ただしバッファに残す) には、タグを使ってメッセージをフィルタしてください
(たとえばチャンネル作成日時を隠すには 'irc_329' タグを使ってください)。フィルタの書き方に関する情報は
`/help filter` を参照してください。

[[filter_voice_messages]]
=== どうすれば voice メッセージをフィルタできますか (例えば Bitlbee サーバ上で)。

voice メッセージをフィルタするのは簡単ではありません、なぜなら voice
モードの設定は同じ IRC メッセージの中で他のモード設定と同時に行われる可能性があるからです。

おそらく Bitlbee が voice を離席ユーザを表示するために利用するため、
voice メッセージでチャットエリアが溢れてしまうから、これをフィルタしたいのではないでしょうか。
この様な場合には、Bitlbee が離席状態を通知することを禁止し、WeeChat にニックネームリスト中に含まれる離席中のニックネームに対して特別な色を使わせることができます。

Bitlbee 3 以上の場合、以下のコマンドをチャンネル '&bitlbee' で入力:

----
channel set show_users online,away
----

Bitlbee の古いバージョンでは、以下のコマンドを '&bitlbee' で入力:

----
set away_devoice false
----

WeeChat で離席中のニックネームをチェックするには、
<<color_away_nicks,離席状態のニックネーム>> に関する質問を参照してください。

もし本当に voice メッセージをフィルタしたい場合は、以下のコマンドを使ってください、
ただしこれは完璧なものではありません (voice モードの変更が最初に指定されている場合のみ有効)。

----
/filter add hidevoices * irc_mode (\+|\-)v
----

[[color_away_nicks]]
=== どうすればニックネームリストから離席中のニックネームを確認できますか。

オプション 'irc.server_default.away_check' に正の値を設定してください
(離席状態確認のインターバルを分単位で)。

オプション 'irc.server_default.away_check_max_nicks'
を設定することで離席状態確認を小さなチャンネルのみに制限できます。

例えば、5 分間隔で離席状態確認を行い、25
人より多いチャンネルではこれを行わないようにするには:

----
/set irc.server_default.away_check 5
/set irc.server_default.away_check_max_nicks 25
----

[NOTE]
WeeChat 0.3.3 以下では、オプション名が 'irc.network.away_check' と
'irc.network.away_check_max_nicks' になっています。

[[highlight_notification]]
=== どうすればあるチャンネルで自分が呼ばれたら警告できますか。

バージョン 1.0 以上では、デフォルトトリガ "beep"
が設定されています。これはハイライトまたはプライベートメッセージを受け取った際に
'BEL' を端末に送信します。このため、端末 (または screen/tmux などのマルチプレクサ)
を設定して、'BEL' が発生した際にコマンドを実行させたり音を再生させることができます。

もしくは "beep" トリガにコマンドを追加することもできます:

----
/set trigger.trigger.beep.command "/print -beep;/exec -bg /path/to/command arguments"
----

古い WeeChat をお使いの場合、'beep.pl' や 'launcher.pl' 等のスクリプトを使ってください。

'launcher.pl' の場合、コマンドの設定が必要です:

----
/set plugins.var.perl.launcher.signal.weechat_highlight "/path/to/command arguments"
----

この問題に対するその他のスクリプトは:

----
/script search notify
----

[[irc_target_buffer]]
=== どうすればマージされたバッファ内であるコマンドを発行するターゲットバッファを変更できますか。

デフォルトのキーは key[ctrl-x] です (コマンドは: `/input switch_active_buffer`)。

[[plugins_scripts]]
== プラグイン / スクリプト

[[openbsd_plugins]]
=== OpenBSD と WeeChat を使っている場合、プラグインが 1 つもロードされません。

OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Linux では ".so")。

以下の様に設定してください:

----
/set weechat.plugin.extension ".so.0.0"
/plugin autoload
----

[[install_scripts]]
=== どうすればスクリプトをインストールできますか。スクリプトは他の IRC クライアントと互換性がありますか。

スクリプトをインストールしたり管理するにはコマンド `/script` を使ってください
(ヘルプは `/help script` で見ることができます)。

スクリプトは他の IRC クライアントのものと互換性がありません。

[[settings]]
== 設定

[[memory_usage]]
=== どうすれば WeeChat のメモリ使用量を節約できますか。

メモリ使用量を減らすには以下のヒントを試してください:

* 最新の安定版を使う
  (古いバージョンよりもメモリリークの可能性が減ると思われます)
* 使わないプラグインのロードを禁止する、例えば: aspell、fifo、
  logger、perl、python、ruby、lua、tcl、guile、xfer (DCC で使用)
* 本当に必要なスクリプトだけをロード
* SSL を*使わない*なら、証明書を読み込まないでください: オプション
  'weechat.network.gnutls_ca_file' に空文字列を設定してください。
* 'weechat.history.max_buffer_lines_number' オプションの値を減らすか、
  'weechat.history.max_buffer_lines_minutes' オプションに値を設定してください。
* 'weechat.history.max_commands' オプションの値を減らしてください。

[[cpu_usage]]
=== どうすれば WeeChat の CPU 負荷を低減できますか?

以下に挙げる <<memory_usage,memory>> に関するヒントに従ってください:

* "nicklist" バーを非表示にする: `/bar hide nicklist`
* ステータスバー時間に秒の表示を止める:
  `/set weechat.look.item_time_format "%H:%M"` (これはデフォルト値です)
* 'TZ' 変数を設定する (例: `export TZ="Europe/Paris"`)、こうすることで
  '/etc/localtime' ファイルへ頻繁にアクセスしないようになります。

[[development]]
== 開発

[[bug_task_patch]]
=== どのようにバグ報告、新機能のリクエスト、パッチ送信すればよいですか。

以下のページを参照してください: https://weechat.org/dev/support

[[gdb_error_threads]]
=== gdb で WeeChat を実行する場合、スレッドに関するエラーが発生します。

gdb で WeeChat を実行する場合、以下のエラーが出るかもしれません:

----
$ gdb /path/to/weechat
(gdb) run
[Thread debugging using libthread_db enabled]
Cannot find new threads: generic error
----

これを修正するには、以下のコマンドを使って gdb を実行してください
(システム上の libpthread と WeeChat へのパスを変更):

----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
(gdb) run
----

[[supported_os]]
=== WeeChat をサポートするプラットフォームのリストを教えてください。他のオペレーティングシステムへの移植予定はありますか。

完全なリストはこのページにあります: https://weechat.org/download

我々は可能な限り多くのプラットフォームに移植することに最善を尽くしています。
我々が持っていない OS で WeeChat をテストすることを歓迎します。

[[help_developers]]
=== どうすれば WeeChat 開発者を手伝えますか。

多くの課題があります (テスト、コード、ドキュメント作成、...)。

IRC かメールで連絡を取り、サポートページを確認してください:
https://weechat.org/dev/support

[[donate]]
=== WeeChat 開発者にお金か何かを贈りたいのですが。

開発補助のためお金を贈ることができます。
詳しいことは https://weechat.org/about/donate に載っています。