diff options
Diffstat (limited to 'doc/ja/weechat_user.ja.txt')
| -rw-r--r-- | doc/ja/weechat_user.ja.txt | 764 |
1 files changed, 382 insertions, 382 deletions
diff --git a/doc/ja/weechat_user.ja.txt b/doc/ja/weechat_user.ja.txt index 37f3452cb..20ce585a7 100644 --- a/doc/ja/weechat_user.ja.txt +++ b/doc/ja/weechat_user.ja.txt @@ -1,4 +1,4 @@ -= WeeChat ユーザーズガイド = += WeeChat ユーザーズガイド Sébastien Helleu <flashcode@flashtux.org> @@ -9,13 +9,13 @@ http://weechat.org/doc [[introduction]] -== イントロダクション == +== イントロダクション WeeChat (Wee Enhanced Environment for Chat) はフリーのチャットクライアントです。 高速で軽量、多くのオペレーティングシステムで動くように設計されています。 [[features]] -=== 特徴 === +=== 特徴 主な特徴: @@ -35,7 +35,7 @@ WeeChat (Wee Enhanced Environment for Chat) はフリーのチャットクライ WeeChat のホームページ: http://weechat.org/ [[pre-requisites]] -=== 事前に必要なもの === +=== 事前に必要なもの WeeChat をインストールするには、以下のものが必要です: @@ -45,10 +45,10 @@ WeeChat をインストールするには、以下のものが必要です: * ncurses ライブラリ [[install]] -== インストール方法 == +== インストール方法 [[binary_packages]] -=== バイナリパッケージ === +=== バイナリパッケージ 多くのディストリビューションではバイナリパッケージが利用できます。例えば: @@ -67,18 +67,18 @@ WeeChat をインストールするには、以下のものが必要です: インストール説明マニュアルを参照してください。 [[source_package]] -=== ソースパッケージ === +=== ソースパッケージ WeeChat は cmake または autotools を使ってコンパイルできます (cmake を使うことが推奨されています)。 [[dependencies]] -==== 依存関係 ==== +==== 依存関係 以下の表は WeeChat のコンパイルに必須または任意で必要なパッケージのリストです。 [width="100%",cols="5,^3,^3,13",options="header"] -|======================================== +|=== | パッケージ ^(1)^ | バージョン | 必須 | 機能 | cmake | | *yes* | ビルド (autotools でも可能ですが、cmake を推奨します) | libncursesw5-dev ^(2)^ | | *yes* | ncurses インターフェイス @@ -99,7 +99,7 @@ WeeChat は cmake または autotools を使ってコンパイルできます (c | source-highlight | | | 文書中のソースに対するシンタックスハイライト | xsltproc, docbook-xml, docbook-xsl | | | man ページのビルド -|======================================== +|=== [NOTE] ^(1)^ Debian GNU/Linux ディストリビューションにおけるパッケージ名です。 @@ -110,34 +110,34 @@ WeeChat は cmake または autotools を使ってコンパイルできます (c で正しく動きますが、バージョン 2.6 以下または 3.0 以上では正しく動きません)。 [[compile_with_cmake]] -==== cmake によるコンパイル ==== +==== cmake によるコンパイル * システムディレクトリにインストールする場合 ('root' 特権が必要です): ----------------------------------------- +---- $ mkdir build $ cd build $ cmake .. $ make % make install (as root) ----------------------------------------- +---- * 任意のディレクトリにインストールする場合: ----------------------------------------- +---- $ mkdir build $ cd build $ cmake .. -DPREFIX=/path/to/directory $ make $ make install ----------------------------------------- +---- cmake に対するオプションを指定するには、以下のフォーマットを使ってください: "-DOPTION=VALUE". よく利用されるオプションのリスト: [width="100%",cols="2m,2,5m,12",options="header"] -|======================================== +|=== | オプション | 値 | デフォルト値 | 説明 | CMAKE_BUILD_TYPE | `Debug`, `Release`, `RelWithDebInfo`, `MinSizeRel` | | @@ -232,22 +232,22 @@ cmake に対するオプションを指定するには、以下のフォーマ | ENABLE_XFER | `ON`, `OFF` | ON | <<xfer_plugin,Xfer プラグイン>>のコンパイル -|======================================== +|=== その他のオプションは以下のコマンドで確認してください: ----------------------------------------- +---- $ cmake -LA ----------------------------------------- +---- Curses インターフェイスを使う場合は以下のコマンドを使ってください: ----------------------------------------- +---- $ ccmake .. ----------------------------------------- +---- [[compile_with_autotools]] -==== autotools によるコンパイル ==== +==== autotools によるコンパイル [WARNING] cmake 以外を用いた WeeChat のビルドは公式にサポートされません。cmake @@ -256,50 +256,50 @@ autotools を用いてビルドする場合、cmake よりも多くの依存パ * システムディレクトリにインストールする場合 ('root' 特権が必要です): ----------------------------------------- +---- $ ./autogen.sh $ mkdir build $ cd build $ ../configure $ make % make install (as root) ----------------------------------------- +---- * 任意のディレクトリにインストールする場合: ----------------------------------------- +---- $ ./autogen.sh $ mkdir build $ cd build $ ../configure --prefix=/path/to/directory $ make $ make install ----------------------------------------- +---- 'configure' スクリプトに対してオプションを指定することができます、オプションを表示するには以下のコマンドを使ってください: ----------------------------------------- +---- $ ./configure --help ----------------------------------------- +---- [[git_sources]] -==== Git ソース ==== +==== Git ソース 警告: git ソースを用いる方法は上級者向けです。コンパイルに失敗したり、 不安定な可能性があります。警告しましたよ! git ソースを入手するには、以下のコマンドを使ってください: ----------------------------------------- +---- $ git clone git://git.sv.gnu.org/weechat.git ----------------------------------------- +---- その後は、ソースパッケージの説明に従ってください (<<source_package,ソースパッケージ>>を参照)。 [[report_crashes]] -==== クラッシュレポート ==== +==== クラッシュレポート WeeChat がクラッシュした場合、または WeeChat をクラッシュさせる操作を報告する場合、以下の手順に従ってください: @@ -309,45 +309,45 @@ WeeChat がクラッシュした場合、または WeeChat * gdb のインストール [[debug_info]] -==== デバッグ情報 ==== +==== デバッグ情報 cmake でコンパイルする場合: ----------------------------------------- +---- $ cmake .. -DCMAKE_BUILD_TYPE=Debug ----------------------------------------- +---- autotools でコンパイルする場合は、デバックはデフォルトで有効化されています(`--with-debug=1`)。 バイナリパッケージをインストールする場合は、'weechat-dbg' パッケージをインストールしてください。 [[core_files]] -==== Core ファイル ==== +==== Core ファイル 'core' ファイルを有効化するには、<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>> オプションを使ってください: ----------------------------------------- +---- /set weechat.startup.sys_rlimit "core:-1" ----------------------------------------- +---- WeeChat バージョン 0.3.8 以下または WeeChat の実行前に core ファイルを有効化したい場合には、`ulimit` コマンドを使ってください。 Linux で 'bash' シェルを使っている場合、以下の内容を `~/.bashrc` に追加してください: ----------------------------------------- +---- ulimit -c unlimited ----------------------------------------- +---- サイズを指定する場合は: ----------------------------------------- +---- ulimit -c 200000 ----------------------------------------- +---- [[gdb_backtrace]] -==== gdb でバックトレースを得る ==== +==== gdb でバックトレースを得る WeeChat がクラッシュすると、'core' または 'core.12345' ファイルが作られます ('12345' はプロセス番号です)。 @@ -357,9 +357,9 @@ WeeChat がインストールされているディレクトリでは*ありま 例えば、'weechat' が '/usr/bin/' にインストールされ、'core' ファイルが '/home/xxx/' にある場合、以下のコマンドで gdb を起動してください: ----------------------------------------- +---- gdb /usr/bin/weechat /home/xxx/core ----------------------------------------- +---- [NOTE] バイナリパッケージ 'weechat-dbg' をインストールした場合 (例えば Debian で)、WeeChat @@ -368,7 +368,7 @@ gdb /usr/bin/weechat /home/xxx/core gdb の中で `bt full` コマンドを実行するとバックトレースが表示されます。 以下のような出力が得られるはずです: ----------------------------------------- +---- (gdb) set logging file /tmp/crash.txt (gdb) set logging on Copying output to /tmp/crash.txt. @@ -395,7 +395,7 @@ Copying output to /tmp/crash.txt. write_fds = {fds_bits = {0 <repeats 16 times>}} except_fds = {fds_bits = {0 <repeats 16 times>}} max_fd = <value optimized out> ----------------------------------------- +---- このバックトレースを開発者に報告し、 クラッシュを引き起こした動作を伝えてください。 @@ -403,26 +403,26 @@ Copying output to /tmp/crash.txt. お手伝いに感謝します! [[debug_running_weechat]] -==== 起動した WeeChat のデバッグ ==== +==== 起動した WeeChat のデバッグ 起動している WeeChat をデバッグするには (例えば WeeChat がフリーズしているような場合)、gdb の引数にプロセス番号を与えて起動します ('12345' は weechat プロセスの PID に変更してください): ----------------------------------------- +---- gdb /usr/bin/weechat 12345 ----------------------------------------- +---- クラッシュが起きた場合と同様に、`bt full` コマンドを使ってください: ----------------------------------------- +---- (gdb) bt full ----------------------------------------- +---- [[usage]] -== 使い方 == +== 使い方 [[running_weechat]] -=== WeeChat の起動 === +=== WeeChat の起動 コマンドライン引数: @@ -430,9 +430,9 @@ include::cmdline_options.ja.txt[] WeeChat を起動させるには、以下コマンドを実行: ----------------------------------------- +---- $ weechat ----------------------------------------- +---- 初めて WeeChat を起動する場合、デフォルトのオプションで設定ファイルが作成されます。 このデフォルト設定ファイルは @@ -443,12 +443,12 @@ WeeChat 内で `/set` コマンドにパラメータを付けて設定します (<<weechat_commands,WeeChat コマンド>>を参照)。 [[screen_layout]] -=== スクリーンレイアウト === +=== スクリーンレイアウト WeeChat を起動したターミナルの例: // TRANSLATION MISSING -........................................ +.... ▼ bar "title" ┌───────────────────────────────────────────────────────────────────────────┐ │Welcome to #test, this is a test channel │ @@ -473,7 +473,7 @@ WeeChat を起動したターミナルの例: │[@Flashy(i)] hi peter!█ │ └───────────────────────────────────────────────────────────────────────────┘ ▲ bars "status" and "input" bar "nicklist" ▲ -........................................ +.... スクリーンは以下のエリアから成ります: @@ -490,7 +490,7 @@ WeeChat を起動したターミナルの例: 状態 ('status') バーは以下の初期値を持っています: [width="100%",cols="^3,^3,10",options="header"] -|======================================== +|=== | アイテム | 例 | 説明 | time | `[12:55]` | 時刻 | buffer_count | `[6]` | 開いているバッファの数 @@ -504,12 +504,12 @@ WeeChat を起動したターミナルの例: | hotlist | `[H: 4:#abc(2,5), 6]` | 変化のあったバッファのリスト (未読メッセージ) (例では、'#abc' に 2 個のハイライトと 5 個の未読メッセージ、6 番目のバッファに 1 個の未読メッセージがあることを意味します。) | completion | `abc(2) def(5)` | 補完候補の単語リスト、各単語に対して適応される補完候補の数を含む。 | scroll | `-MORE(50)-` | スクロール表示、最後の行が表示されてから追加された行数を含む。 -|======================================== +|=== 入力 ('input') バーは以下の初期値を持っています: [width="100%",cols="^3,^6,8",options="header"] -|======================================== +|=== | アイテム | 例 | 説明 | input_paste | `[Paste 7 lines ? [ctrl-Y] Yes [ctrl-N] No]` | 行をペーストする場合にユーザへ行われる質問 // TRANSLATION MISSING @@ -517,10 +517,10 @@ WeeChat を起動したターミナルの例: | away | `(away)` | 離席状態表示 | input_search | `[Search (~ str,msg)]` | 検索インジケータ ("`~`": 大文字小文字を区別しない、"`==`": 大文字小文字を区別する、"`str`": 検索文字列、"`regex`": 検索正規表現、"`msg`": メッセージ部分から検索、"`pre`": プレフィックス部分から検索、"`pre\|msg`": プレフィックス部分とメッセージ部分から検索) | input_text | `hi peter!` | 入力テキスト -|======================================== +|=== [[buffers_and_windows]] -=== バッファとウィンドウ === +=== バッファとウィンドウ 'バッファ' は番号、名前、表示された行 (とその他の情報) で構成されています。 @@ -541,7 +541,7 @@ WeeChat を起動したターミナルの例: 水平方向分割の例 (`/window splith`): // TRANSLATION MISSING -........................................ +.... ▼ window #2 (buffer #4) ┌───────────────────────────────────────────────────────────────────────────┐ │Welcome to #abc │ @@ -569,12 +569,12 @@ WeeChat を起動したターミナルの例: │[@Flashy] hi peter!█ │ └───────────────────────────────────────────────────────────────────────────┘ ▲ window #1 (buffer #3) -........................................ +.... 垂直方向分割の例 (`/window splitv`): // TRANSLATION MISSING -........................................ +.... ┌───────────────────────────────────────────────────────────────────────────┐ │Welcome to #test │Welcome to #abc │ │12:54:15 peter | hey! │@Flashy│12:55:12 Max | hi │@Flashy│ @@ -598,12 +598,12 @@ WeeChat を起動したターミナルの例: │[@Flashy] hi peter!█ │[@Flashy] │ └───────────────────────────────────────────────────────────────────────────┘ ▲ window #1 (buffer #3) ▲ window #2 (buffer #4) -........................................ +.... 垂直方向 + 水平方向分割の例: // TRANSLATION MISSING -........................................ +.... ▼ window #3 (buffer #5) ┌───────────────────────────────────────────────────────────────────────────┐ │Welcome to #test │Welcome to #def │ @@ -631,10 +631,10 @@ WeeChat を起動したターミナルの例: │[@Flashy] hi peter!█ │[@Flashy] │ └───────────────────────────────────────────────────────────────────────────┘ ▲ window #1 (buffer #3) ▲ window #2 (buffer #4) -........................................ +.... [[bars]] -=== バー === +=== バー 'バー' とは任意のテキストを含めることができるチャットエリア以外の場所です。 @@ -644,7 +644,7 @@ WeeChat を起動したターミナルの例: バーオプションのリスト: [width="100%",cols="2m,2,10",options="header"] -|======================================== +|=== | オプション名 | 値 | 説明 | type | `root`、`window` | @@ -708,10 +708,10 @@ WeeChat を起動したターミナルの例: | conditions | 文字列 | バーを表示する状態 (詳細は<<bar_conditions,状態>>を参照)。 -|======================================== +|=== [[bar_items]] -==== アイテム ==== +==== アイテム 'items' オプションはバーアイテムをコンマ (画面上のアイテム同士に間隔を空ける) または "+" (間隔を空けない) で区切った文字列。 @@ -724,11 +724,11 @@ WeeChat を起動したターミナルの例: アイテムを含むバーの例 "[time],buffer_number+:+buffer_plugin+.+buffer_name": -........................................ +.... ┌───────────────────────────────────────────────────────────────────────────┐ │[12:55] 3:irc/freenode.#weechat │ └───────────────────────────────────────────────────────────────────────────┘ -........................................ +.... 特殊構文を使うことで、バーアイテム: "@buffer:item" ("buffer" はバッファの完全な名前、"item" はバーアイテムの名前) @@ -740,12 +740,12 @@ WeeChat を起動したターミナルの例: 例: bitlbee のニックネームリストをルートバーに表示させる (バーが 'bitlist' で bitlbee サーバが 'bitlbee' の場合): ----------------------------------------- +---- /set weechat.bar.bitlist.items "@irc.bitlbee.&bitlbee:buffer_nicklist" ----------------------------------------- +---- [[bar_filling]] -==== フィリング ==== +==== フィリング フィリングタイプには 4 つの種類があります: @@ -764,7 +764,7 @@ WeeChat を起動したターミナルの例: 'nicklist' バーに対するフィリングの例: -........................................ +.... ┌──────────────────────────────────────────────────┐ │Welcome to #test, this is a test channel │ │12:54:15 peter | hey! │@carl │ @@ -818,10 +818,10 @@ WeeChat を起動したターミナルの例: │───────────────────────────────────────────────────────────────────────│ │ │ filling_top_bottom = columns_horizontal ▲ -........................................ +.... [[bar_conditions]] -==== 状態 ==== +==== 状態 'conditions' オプションはバーをウィンドウ内に表示するか否かを評価する文字列です (このオプションは 'window' 型のバーだけに有効です)。 @@ -848,19 +848,19 @@ WeeChat を起動したターミナルの例: ニックネームリストを持ち、ウィンドウ幅が 100 より大きい全てのバッファにニックネームリストバーを表示する例: ----------------------------------------- +---- /set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100" ----------------------------------------- +---- 上と同じだが、'&bitlbee' バッファでは常にニックネームリストを表示 (ウィンドウ幅が狭くても): ----------------------------------------- +---- /set weechat.bar.nicklist.conditions "${nicklist} && (${window.win_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)" ----------------------------------------- +---- [[notify_levels]] -=== 通知レベル === +=== 通知レベル バッファに表示された各メッセージには 4 つのレベルが設定されています。レベルの低いものから順に: @@ -877,43 +877,43 @@ WeeChat を起動したターミナルの例: デフォルトは 'all' です。 [width="50%",cols="3m,10",options="header"] -|======================================== +|=== | 通知レベル | ホットリストに追加されるメッセージのレベル | none | (無効) | highlight | 'highlight' + 'private' | message | 'highlight' + 'private' + 'message' | all | 'highlight' + 'private' + 'message' + 'low' -|======================================== +|=== 通知レベルはバッファグループに対して設定することも可能で、例えば irc サーバ "freenode" に含まれる全てのバッファに対して設定する場合: ----------------------------------------- +---- /set weechat.notify.irc.freenode message ----------------------------------------- +---- "#weechat" チャンネルだけに対して、通知レベルを 'highlight' に設定する場合: ----------------------------------------- +---- /set weechat.notify.irc.freenode.#weechat highlight ----------------------------------------- +---- `/buffer` コマンドで、あるバッファに対する通知レベルを設定できます: ----------------------------------------- +---- /buffer notify highlight ----------------------------------------- +---- [[key_bindings]] -=== デフォルトのキー割り当て === +=== デフォルトのキー割り当て // 'C-' = ctrl, 'A-' = alt, 'S-' = shift [[key_bindings_command_line]] -==== コマンドライン用のキー ==== +==== コマンドライン用のキー [width="100%",cols="^.^3,.^10,.^5",options="header"] -|======================================== +|=== | キー | 説明 | コマンド | @k(←) .2+| コマンドラインで前の文字に移動 .2+| `/input move_previous_char` | @k(C-)@k(b) @@ -958,13 +958,13 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定 | @k(A-)@k(k) | キー入力を奪って、コマンドラインにコード (キーが割り当てられていればコマンド) を入力 | `/input grab_key_command` | @k(A-)@k(r) | コマンドラインへの入力をすべて削除 | `/input delete_line` | @k(A-)@k(s) | aspell の有効無効を切り替え | `/mute aspell toggle` -|======================================== +|=== [[key_bindings_buffers_windows]] -==== バッファ / ウィンドウ用のキー ==== +==== バッファ / ウィンドウ用のキー [width="100%",cols="^.^3,.^10,.^5",options="header"] -|======================================== +|=== | キー | 説明 | コマンド | @k(C-)@k(l) | 全ウィンドウを再描画 | `/window refresh` | @k(C-)@k(s) , @k(C-)@k(u) | すべてのバッファに未読マークをセット | `/input set_unread` @@ -1014,16 +1014,16 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定 | @k(A-)@k(>) | バッファ訪問履歴で次のバッファに移動 | `/input jump_next_visited_buffer` | @k(A-)@k(/) | 最後に表示したバッファに移動 (バッファ移動前に表示していたウィンドウ) | `/input jump_last_buffer_displayed` | @k(A-)@k(=) | フィルタの有効無効を切り替え | `/filter toggle` -|======================================== +|=== [[key_bindings_search_context]] -==== "検索" モード用のキー ==== +==== "検索" モード用のキー 以下のキーは "検索" モード (バッファ内のテキスト検索用に @k(C-)@k(r) が押された状態) でのみ有効です。 [width="100%",cols="^.^3,.^10,.^5",options="header"] -|======================================== +|=== | キー | 説明 | コマンド | @k(C-)@k(r) | 検索タイプを切り替え: 文字列 (デフォルト)、正規表現 | `/input search_switch_regex` | @k(A-)@k(c) | 大文字小文字を区別して検索 | `/input search_switch_case` @@ -1033,15 +1033,15 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定 | @k(Enter) .3+| 検索を終了 .3+| `/input search_stop` | @k(C-)@k(j) | @k(C-)@k(m) -|======================================== +|=== [[key_bindings_cursor_context]] -==== "カーソル" モード用のキー ==== +==== "カーソル" モード用のキー 以下のキーは "カーソル" モード (スクリーン上でカーソルを自由に動かせる状態) でのみ有効です。 [width="100%",cols="^.^3,^.^3,.^10,.^8",options="header"] -|======================================== +|=== | キー | エリア | 説明 | コマンド | @k(↑) | - | カーソルを上の行に移動 | `/cursor move up` | @k(↓) | - | カーソルを下の行に移動 | `/cursor move down` @@ -1062,15 +1062,15 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定 | @k(Enter) .3+| - .3+| カーソルモードを終了 .3+| `/cursor stop` | @k(C-)@k(j) | @k(C-)@k(m) -|======================================== +|=== [[key_bindings_mouse_context]] -==== "マウス" モード用のキー ==== +==== "マウス" モード用のキー 以下のキーは "マウス" モード (マウスイベントが発生したとき) でのみ有効です。 [width="100%",cols="^.^3,^.^3,^.^3,.^10,.^8",options="header"] -|======================================== +|=== | ボタン^(1)^ | ジェスチャー| エリア| 説明 | コマンド | ◾◽◽ | - | チャット | ウィンドウに移動 | `/window ${_window_number}` | ◾◽◽ | 左 | チャット | 前のバッファに移動 | `/window ${_window_number};/buffer +1` @@ -1098,38 +1098,38 @@ irc サーバ "freenode" に含まれる全てのバッファに対して設定 | ⇑ | - | 任意のバー | バーを -20% スクロール | `/bar scroll ${_bar_name} ${_window_number} -20%` | ⇓ | - | 任意のバー | バーを +20% スクロール | `/bar scroll ${_bar_name} ${_window_number} +20%` | ◽◾◽ | - | 任意の場所 | この場所でカーソルモードを開始 | `/cursor go ${_x},${_y}` -|======================================== +|=== [NOTE] ^(1)^ "⇑" と "⇓" はホイールの上方向回転と下方向回転に対応します。 [[mouse]] -=== マウスサポート === +=== マウスサポート WeeChat はマウスクリックとマウスジェスチャーをサポートしています。 ローカル端末と screen/tmux の有無にかかわらず ssh 接続経由で利用可能です。 [[mouse_enable]] -==== マウスの有効化 ==== +==== マウスの有効化 起動時にマウスを有効化するには: ----------------------------------------- +---- /set weechat.look.mouse on ----------------------------------------- +---- マウスを有効化するには @k(A-)@k(m) を押すか、以下のコマンドを使います: ----------------------------------------- +---- /mouse enable ----------------------------------------- +---- キーにマウスの一時的な無効化を割り当てることができます。 例えば、 @k(A-)@k(x) キーにマウスを 10 秒間無効化する機能を割り当てるには: ----------------------------------------- +---- /key bind meta-x /mouse toggle 10 ----------------------------------------- +---- WeeChat でマウスが有効化されている場合、@k(-S-) 修飾キーで選択やクリックができます。これでマウスが無効化されている場合と同じ作業が行えます @@ -1139,7 +1139,7 @@ WeeChat でマウスが有効化されている場合、@k(-S-) マウスに関するトラブルがあれば 'WeeChat FAQ' を参照してください。 [[mouse_bind_events]] -==== コマンドに対してマウスイベントを割り当てる ==== +==== コマンドに対してマウスイベントを割り当てる WeeChat はデフォルトマウスイベントの多くを定義しています (<<key_bindings_mouse_context,"マウス" モード用のキー>>を参照)。 @@ -1153,17 +1153,17 @@ WeeChat はデフォルトマウスイベントの多くを定義しています 修飾キーリスト: [width="50%",cols="3m,4",options="header"] -|======================================== +|=== | 修飾キー | 説明 | ctrl | @k(-C-) キー | alt | @k(-A-) キー | ctrl-alt | @k(-C-) と @k(-A-) キー -|======================================== +|=== ボタン/ホイールのリスト: [width="50%",cols="3m,4",options="header"] -|======================================== +|=== | ボタン/ホイール | 説明 | button1 | 左ボタンクリック | button2 | 右ボタンクリック @@ -1171,12 +1171,12 @@ WeeChat はデフォルトマウスイベントの多くを定義しています | button4 ... button9 | その他のボタンクリック | wheelup | ホイール (上方向) | wheeldown | ホイール (下方向) -|======================================== +|=== ジェスチャーのリスト (ボタンのみ対応、ホイール未対応): [width="50%",cols="3m,4",options="header"] -|======================================== +|=== | ジェスチャー | 距離 | gesture-up | 3 ... 19 | gesture-up-long | ≥ 20 @@ -1186,16 +1186,16 @@ WeeChat はデフォルトマウスイベントの多くを定義しています | gesture-left-long | ≥ 40 | gesture-right | 3 ... 39 | gesture-right-long | ≥ 40 -|======================================== +|=== 未完了イベントのリスト (ボタンのみ、プラグイン/スクリプトで便利): [width="50%",cols="3m,4",options="header"] -|======================================== +|=== | イベント | 説明 | event-down | マウスボタンが押され、離されていない状態 | event-drag | マウスボタンが押された状態でマウスが動かされた -|======================================== +|=== イベントの表記例: @@ -1219,37 +1219,37 @@ WeeChat はデフォルトマウスイベントの多くを定義しています これにより対応するイベントを確認できます。 [[command_line]] -=== コマンドライン === +=== コマンドライン WeeChat コマンドライン (ウィンドウの一番下にあります) はコマンドの実行やバッファにテキストを送信するために利用します。 [[command_line_syntax]] -==== 文法 ==== +==== 文法 コマンドは "/" 文字で始まり、コマンドの名前を続けます。 例えば、すべてのオプションを表示するには: ----------------------------------------- +---- /set ----------------------------------------- +---- "/" が最初に無い場合、そのテキストはバッファに送信されます。例えば、'hello' というテキストをバッファに送信するには: ----------------------------------------- +---- hello ----------------------------------------- +---- "/" 文字から始まるテキストを送信したい場合、は 2 重に "/" をつけます。例えば、'/set' というテキストを現在のバッファに送信するには: ----------------------------------------- +---- //set ----------------------------------------- +---- [[command_line_colors]] -=== 色コード === +=== 色コード IRC 等のプラグインでは、以下の色コードと属性を利用できます (@k(C-)@k(c) の後に、オプションとともに以下のキーを押してください): @@ -1283,7 +1283,7 @@ IRC 等のプラグインでは、以下の色コードと属性を利用でき @k(C-)@k(c) , @k(c) 用の色コード: [width="50%",cols="^1m,3,3",options="header"] -|======================================== +|=== | コード | IRC | WeeChat (curses) | 00 | 白 | white | 01 | 黒 | black @@ -1301,21 +1301,21 @@ IRC 等のプラグインでは、以下の色コードと属性を利用でき | 13 | 明るい赤紫色 | lightmagenta | 14 | 灰色 | gray | 15 | 明るい灰色 | white -|======================================== +|=== 例: "こんにちは皆さん!" の "こんにちは" を太字の明るい青、"皆さん" を下線付きの明るい赤に表示したい場合: ----------------------------------------- +---- ^Cc12^Cbこんにちは^Cb^Cc04^Cu皆さん^Cu^Cc! ----------------------------------------- +---- [NOTE] irc プラグインでは、<<option_irc.color.mirc_remap,irc.color.mirc_remap>> を使ってこれらの色を別の色に対応付けることができます。 [[colors]] -=== 色 === +=== 色 WeeChat ではバーやチャットエリアにおけるテキスト表示に 256 個の色ペアを利用できます (この機能を利用するには WeeChat が実行されているターミナルが 256 色表示に対応している必要があります)。 @@ -1324,13 +1324,13 @@ WeeChat ではバーやチャットエリアにおけるテキスト表示に 25 で利用できる色と色ペアに以下の制限があります: [width="50%",cols="8,>2,>2",options="header"] -|======================================== +|=== | $TERM | 色 | ペア ^(1)^ | "rxvt-unicode", "xterm",... | 88 | 256 | "rxvt-256color", "xterm-256color",... | 256 | 32767 | "screen" | 8 | 64 | "screen-256color" | 256 | 32767 -|======================================== +|=== [NOTE] ^(1)^ 端末が 256 ペア以上の表示をサポートしていても、WeeChat @@ -1350,25 +1350,25 @@ WeeChat ではバーやチャットエリアにおけるテキスト表示に 25 screen を使っている場合、'~/.screenrc' に以下の内容を追加してください: ----------------------------------------- +---- term screen-256color ----------------------------------------- +---- 'TERM' 環境変数に間違った値が設定された状態で WeeChat を起動しても、あわてないでください! 'shell.py' スクリプトを使えば WeeChat を再起動せずに環境変数の値を変更できます。 ----------------------------------------- +---- /shell setenv TERM=screen-256color /upgrade ----------------------------------------- +---- [[colors_basic]] -==== 基本色 ==== +==== 基本色 WeeChat における基本色とは: [width="50%",cols="^3m,8",options="header"] -|======================================== +|=== | 名前 | 色 | default | デフォルトの端末色 (背景色を透過色とする) | black | 黒 @@ -1387,10 +1387,10 @@ WeeChat における基本色とは: | lightcyan | 明るい青緑色 | gray | 灰色 | white | 白 -|======================================== +|=== [[colors_extended]] -==== 拡張色 ==== +==== 拡張色 WeeChat はスクリーンに色が表示された時点で色ペアを動的に割り当てます (バッファとバーを表示する時点で)。 @@ -1403,31 +1403,31 @@ WeeChat はスクリーンに色が表示された時点で色ペアを動的に 例えば、バッファ中のに表示される時刻をオレンジ色にしたい場合、以下のようにしてください: ----------------------------------------- +---- /set weechat.color.chat_time 214 ----------------------------------------- +---- ステータスバーの色を非常に暗い緑色にしたい場合: ----------------------------------------- +---- /set weechat.bar.status.color_bg 22 ----------------------------------------- +---- [[colors_aliases]] -==== 別名 ==== +==== 別名 `/color alias` コマンドを使えば色の別名を追加できます。 追加後は任意の色関連オプションで別名を使えます。 例: ----------------------------------------- +---- /color alias 214 orange /set weechat.color.chat_delimiters orange ----------------------------------------- +---- [[colors_attributes]] -==== 属性 ==== +==== 属性 色に対していくつかの属性を付加することができます。1 つ以上の属性を色名又は色番号の前に付加できます: @@ -1442,51 +1442,51 @@ WeeChat はスクリーンに色が表示された時点で色ペアを動的に 例えば、自分自身のニックネームの表示色を白にして、下線を引きたい場合: ----------------------------------------- +---- /set weechat.color.chat_nick_self _white ----------------------------------------- +---- ステータスバーの時刻の表示色を橙色にして、下線を引いて、太字にしたい場合: ----------------------------------------- +---- /set weechat.color.status_time *_214 ----------------------------------------- +---- デフォルト端末色 (-1) に対して属性を設定したい場合、端末色番号の最大値よりも大きな値を利用してください。 例えば、WeeChat における色番号の最大値は 99999 です。 端末の表示色に太字の属性を付加する例: ----------------------------------------- +---- /set weechat.color.status_time *99999 ----------------------------------------- +---- [[options_and_commands]] -=== オプションとコマンド === +=== オプションとコマンド [[sec_options]] -==== 保護データのオプション (sec.conf) ==== +==== 保護データのオプション (sec.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | crypt | /set sec.crypt.* | 暗号化に関するオプション | data | <<command_weechat_secure,/secure>> | 保護データ -|======================================== +|=== オプション: include::autogen/user/sec_options.txt[] [[weechat_options]] -==== WeeChat オプション (weechat.conf) ==== +==== WeeChat オプション (weechat.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | debug | <<command_weechat_debug,/debug set>> + /set weechat.debug.* | core とプラグインのデバッグレベル (オプションをセクションに追加/削除出来ます) @@ -1509,19 +1509,19 @@ include::autogen/user/sec_options.txt[] | key_search | <<command_weechat_key,/key>> | 検索コンテキストのキー | key_cursor | <<command_weechat_key,/key>> | カーソルコンテキストのキー | key_mouse | <<command_weechat_key,/key>> | マウスコンテキストのキー -|======================================== +|=== オプション: include::autogen/user/weechat_options.txt[] [[weechat_commands]] -==== WeeChat コマンド ==== +==== WeeChat コマンド include::autogen/user/weechat_commands.txt[] [[plugins]] -== プラグイン == +== プラグイン プラグインとは動的ライブラリのことで、C 言語で書かれてコンパイルされています。 プラグインは WeeChat によって読み込まれます。 @@ -1542,16 +1542,16 @@ GNU/Linux の場合、プラグインファイルは ".so" という拡張子を プラグインをロード、アンロード、ロード済みプラグインを表示する例: ----------------------------------------- +---- /plugin load irc /plugin unload irc /plugin list ----------------------------------------- +---- デフォルトプラグインのリスト: [width="50%",cols="^1,5",options="header"] -|======================================== +|=== | プラグイン | 説明 | alias | コマンドの別名を定義 | aspell | コマンドラインのスペルチェック @@ -1569,54 +1569,54 @@ GNU/Linux の場合、プラグインファイルは ".so" という拡張子を | tcl | Tcl スクリプト API | guile | Guile (scheme) スクリプト API | xfer | ファイル転送とダイレクトチャット -|======================================== +|=== API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには、'WeeChat プラグイン API リファレンス' 又は 'WeeChat スクリプト製作ガイド' を参照してください。 [[alias_plugin]] -=== Alias プラグイン === +=== Alias プラグイン Alias プラグインを使うことで、コマンドの別名を定義できます (WeeChat だけでなく他のプラグインが提供するコマンドの別名を定義することもできます)。 [[alias_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/alias_commands.txt[] [[aspell_plugin]] -=== Aspell プラグイン === +=== Aspell プラグイン Aspell プラグインを使うことで、コマンドラインに入力した文字列のスペルチェックができます。 バッファごとに異なる言語に対するスペルチェックを実行できます。 [[aspell_options]] -==== オプション (aspell.conf) ==== +==== オプション (aspell.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | color | /set aspell.color.* | 色 | check | /set aspell.check.* | スペルチェックの操作コマンド | dict | <<command_aspell_aspell,/aspell setdict>> + /set aspell.dict.* | バッファが利用するディレクトリ (オプションをセクションに追加/削除出来ます) | option | /set aspell.option.* | <<aspell_speller_options,Speller オプション>> (オプションをセクションに追加/削除出来ます) -|======================================== +|=== オプション: include::autogen/user/aspell_options.txt[] [[aspell_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/aspell_commands.txt[] [[aspell_speller_options]] -==== Speller オプション ==== +==== Speller オプション Speller オプションは aspell 設定の "option" セクションにあるオプションを追加して定義します。 @@ -1624,18 +1624,18 @@ Speller オプションは aspell 設定の "option" ここで利用するオプション名は aspell 設定オプションと同じものです。 オプションのリストはシェルで以下のコマンドを実行することで確認できます: ----------------------------------------- +---- $ aspell config ----------------------------------------- +---- 例えば、"ignore-case" オプションを有効化するには: ----------------------------------------- +---- /set aspell.option.ignore-case "true" ----------------------------------------- +---- [[aspell_suggestions]] -==== 修正候補 ==== +==== 修正候補 "aspell_suggest" バーアイテム内に修正候補が表示されます。修正候補の数は 'aspell.check.suggestions' オプションで設定します。 @@ -1645,22 +1645,22 @@ $ aspell config 英語辞書 (`en`) を用いた修正候補の例: -........................................ +.... │[12:55] [6] [irc/freenode] 3:#test(+n){4} [print,prone,prune] │ │[@Flashy] prinr █ │ └─────────────────────────────────────────────────────────────────────────────────┘ -........................................ +.... 英語とフランス語辞書 (`en,fr`) を用いた修正候補の例: -........................................ +.... │[12:55] [6] [irc/freenode] 3:#test(+n){4} [print,prone,prune/prime,primer,primé] │ │[@Flashy] prinr █ │ └─────────────────────────────────────────────────────────────────────────────────┘ -........................................ +.... [[charset_plugin]] -=== Charset プラグイン === +=== Charset プラグイン Charset プラグインを使うことで、文字コードに従ってデータのデコードとエンコードができます。 @@ -1673,15 +1673,15 @@ Charset プラグインを使うことで、文字コードに従ってデータ Charset プラグインは WeeChat によって自動的にロードされるべきです。 プラグインがロードされていることを確認するには、以下のようにしてください: ----------------------------------------- +---- /charset ----------------------------------------- +---- コマンドが見つからない場合、以下のコマンドでプラグインをロードしてください: ----------------------------------------- +---- /plugin load charset ----------------------------------------- +---- プラグインが見つからない場合、文字コードサポートを有効化した状態で WeeChat を再コンパイルしてください。 @@ -1691,45 +1691,45 @@ Charset プラグインがロードされた場合、端末文字コードと内 例: -........................................ +.... charset: terminal: ISO-8859-15, internal: UTF-8 -........................................ +.... [[charset_options]] -==== オプション (charset.conf) ==== +==== オプション (charset.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | default | /set charset.default.* | デフォルトのデコード/エンコード文字セット | decode | <<command_charset_charset,/charset decode>> + /set charset.decode.* | バッファのデコード文字セット (オプションをセクションに追加/削除出来ます) | encode | <<command_charset_charset,/charset encode>> + /set charset.encode.* | バッファのエンコード文字セット (オプションをセクションに追加/削除出来ます) -|======================================== +|=== オプション: include::autogen/user/charset_options.txt[] [[charset_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/charset_commands.txt[] [[charset_set]] -==== 文字コードの設定 ==== +==== 文字コードの設定 グローバルデコード文字コードとエンコード文字コードを設定するには、`/set` コマンドを使ってください。 例: ----------------------------------------- +---- /set charset.default.decode ISO-8859-15 /set charset.default.encode ISO-8859-15 ----------------------------------------- +---- グローバルデコード文字コードが設定されていない場合 (例えば Charset プラグインを始めてロードした場合)、これは自動的に端末の文字コードか @@ -1743,33 +1743,33 @@ IRC サーバの文字コードを設定するには、サーババッファで 例: ----------------------------------------- +---- /charset ISO-8859-15 ----------------------------------------- +---- これは以下と等価です: ----------------------------------------- +---- /charset decode ISO-8859-15 /charset encode ISO-8859-15 ----------------------------------------- +---- IRC チャンネル (またはプライベートメッセージ) の文字コードを設定するには、 サーバの文字コード設定と同様のコマンドをチャンネル (またはプライベートメッセージ) バッファで使ってください。 すべての文字コード設定を確認するには、以下のコマンドを利用してください: ----------------------------------------- +---- /set charset.* ----------------------------------------- +---- [[charset_troubleshooting]] -==== トラブルシューティング ==== +==== トラブルシューティング 文字コードに関する問題があれば、'WeeChat FAQ' を参照してください。 [[fifo_plugin]] -=== Fifo プラグイン === +=== Fifo プラグイン 外部から WeeChat を操作するには、FIFO パイプにコマンドやテキストを書き込んでください ("plugins.var.fifo.fifo" オプションが有効化されている必要がありますが、デフォルトで有効化されているはずです)。 @@ -1779,43 +1779,43 @@ FIFO パイプは '~/.weechat/' の下にあり、'weechat_fifo_xxxx' FIFO パイプに書き込むコマンド/テキストの文法は以下の例の一つです: -........................................ +.... plugin.buffer *テキストまたはコマンド *テキストまたはコマンド -........................................ +.... 例: * IRC サーバ freenode のニックネームを "newnick" に変更する: ----------------------------------------- +---- $ echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo_12345 ----------------------------------------- +---- * IRC の #weechat チャンネルに対してテキストを送信: ----------------------------------------- +---- $ echo 'irc.freenode.#weechat *hello!' >~/.weechat/weechat_fifo_12345 ----------------------------------------- +---- * 現在のバッファに対してテキストを送信: ----------------------------------------- +---- $ echo '*hello!' >~/.weechat/weechat_fifo_12345 ----------------------------------------- +---- * Python スクリプトのアンロードとロードを行う 2 つのコマンドを送信 (複数のコマンドは "\n" で分割してください): ----------------------------------------- +---- $ echo -e '*/python unload\n*/python autoload' >~/.weechat/weechat_fifo_12345 ----------------------------------------- +---- 実行中の WeeChat すべてに対してコマンドを送信するスクリプトは以下のように書けます。例えば: [source,shell] ----------------------------------------- +---- #!/bin/sh if [ $# -eq 1 ]; then for fifo in ~/.weechat/weechat_fifo_* @@ -1823,16 +1823,16 @@ if [ $# -eq 1 ]; then echo -e "$1" >$fifo done fi ----------------------------------------- +---- このスクリプトを "auto_weechat_command" というファイル名で保存した場合、以下のように実行できます: ----------------------------------------- +---- $ ./auto_weechat_command 'irc.freenode.#weechat *hello' ----------------------------------------- +---- [[irc_plugin]] -=== IRC プラグイン === +=== IRC プラグイン IRC プラグインは IRC プロトコルに従って他の人と会話を行うために設計されています。 @@ -1840,28 +1840,28 @@ IRC プラグインは IRC プロトコルに従って他の人と会話を行 <<xfer_plugin,Xfer プラグイン>> を参照) を含む全ての IRC コマンドをサポートしています。 [[irc_command_line_options]] -==== コマンドラインオプション ==== +==== コマンドラインオプション 以下のように 1 つ以上の IRC サーバに対応する URL を引数として与えることができます: ----------------------------------------- +---- irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]] ----------------------------------------- +---- 'nono' というニックネームを使って 'irc.freenode.net' ホストのデフォルトポート (6667) で稼働中の IRC サーバ上の '#weechat' と '#toto' チャンネルに参加する例: ----------------------------------------- +---- $ weechat irc://nono@irc.freenode.net/#weechat,#toto ----------------------------------------- +---- [[irc_options]] -==== オプション (irc.conf) ==== +==== オプション (irc.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | look | /set irc.look.* | 外観 | color | /set irc.color.* | 色 @@ -1872,19 +1872,19 @@ $ weechat irc://nono@irc.freenode.net/#weechat,#toto | server_default | /set irc.server_default.* | サーバに対するデフォルト値 (サーバオプションが定義されていない場合に利用されます) | server | <<command_irc_server,/server>> + /set irc.server.* | サーバ -|======================================== +|=== オプション: include::autogen/user/irc_options.txt[] [[irc_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/irc_commands.txt[] [[irc_ssl_certificates]] -==== SSL 証明書 ==== +==== SSL 証明書 SSL を使って IRC サーバに接続する場合、WeeChat はデフォルトで接続が完全に信頼できるものかどうかを確認します。 @@ -1910,46 +1910,46 @@ irc.server.xxx.ssl_verify:: より前のバージョンでは信頼性の確認に成功していたものが失敗する場合もあります。 [[irc_connect_oftc_with_certificate]] -===== 最初の例: oftc に接続して、証明書を確認 ===== +===== 最初の例: oftc に接続して、証明書を確認 * シェルを使って証明書をインポート: ----------------------------------------- +---- $ mkdir -p ~/.weechat/ssl $ wget -O ~/.weechat/ssl/CAs.pem http://www.spi-inc.org/ca/spi-cacert.crt ----------------------------------------- +---- 注意: CAs.pem ファイル中で複数の証明書を連結することもできます。 * WeeChat で "oftc" サーバがすでに設定済みであれば: ----------------------------------------- +---- /connect oftc ----------------------------------------- +---- [[irc_connect_oftc_with_certfp]] -===== 2 番目の例: CertFP を使って oftc に接続 ===== +===== 2 番目の例: CertFP を使って oftc に接続 * シェルで証明書を作成: ----------------------------------------- +---- $ mkdir -p ~/.weechat/ssl $ cd ~/.weechat/ssl $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem ----------------------------------------- +---- * WeeChat で "oftc" サーバがすでに設定済みであれば: ----------------------------------------- +---- /set irc.server.oftc.ssl_cert "%h/ssl/nick.pem" /connect oftc /msg nickserv cert add ----------------------------------------- +---- より詳しい情報は http://www.oftc.net/oftc/NickServ/CertFP を確認してください。 [[irc_sasl_authentication]] -==== SASL 認証 ==== +==== SASL 認証 WeeChat は SASL 認証をサポートします、以下の認証メカニズムを利用できます: @@ -1967,16 +1967,16 @@ WeeChat は SASL 認証をサポートします、以下の認証メカニズム "dh-blowfish" メカニズムをデフォルトで全てのサーバに対して利用する場合: ----------------------------------------- +---- /set irc.server_default.sasl_mechanism dh-blowfish ----------------------------------------- +---- [NOTE] "dh-blowfish" メカニズムを利用する場合、"gcrypt" ライブラリが WeeChat のコンパイル時に必要です (<<dependencies,依存関係>> を参照)。 [[irc_tor_freenode]] -==== TOR/SASL を使って Freenode に接続する場合 ==== +==== TOR/SASL を使って Freenode に接続する場合 SSL に加えて、Freenode サーバは TOR (https://www.torproject.org/) 経由の接続をサポートしています。TOR とはバーチャルトンネルのネットワークで、 @@ -1988,47 +1988,47 @@ SSL に加えて、Freenode サーバは TOR (https://www.torproject.org/) 最初に、TOR をインストールしてください。Debian (とその派生ディストリビューション) の場合: ----------------------------------------- +---- $ sudo apt-get install tor ----------------------------------------- +---- WeeChat で TOR サービスを使った socks5 プロキシを作成してください (ホスト名/IP アドレス、ポート番号は TOR の設定に依存します): ----------------------------------------- +---- /proxy add tor socks5 127.0.0.1 9050 ----------------------------------------- +---- 次に新しいサーバを作成してください。例えば: ----------------------------------------- +---- /server add freenode-tor p4fsi4ockecnea7l.onion ----------------------------------------- +---- TOR プロキシを設定: ----------------------------------------- +---- /set irc.server.freenode-tor.proxy "tor" ----------------------------------------- +---- SASL 認証を設定: ----------------------------------------- +---- /set irc.server.freenode-tor.sasl_mechanism dh-blowfish /set irc.server.freenode-tor.sasl_username "your_nickname" /set irc.server.freenode-tor.sasl_password "your_password" ----------------------------------------- +---- 最後に、サーバに接続してください: ----------------------------------------- +---- /connect freenode-tor ----------------------------------------- +---- Freenode と TOR に関するより詳しい情報: http://freenode.net/irc_servers.shtml#tor [[irc_smart_filter_join_part_quit]] -==== 参加/退出/終了メッセージに対するスマートフィルタ ==== +==== 参加/退出/終了メッセージに対するスマートフィルタ チャンネル内での発言が過去 X 分間なかった場合に参加/退出/終了メッセージをフィルタリングするスマートフィルタが利用できます。 @@ -2036,78 +2036,78 @@ Freenode と TOR に関するより詳しい情報: http://freenode.net/irc_serv スマートフィルタはデフォルトで有効化されていますが、 バッファ内のメッセージを隠すにはフィルタを追加する必要があります。例えば: ----------------------------------------- +---- /filter add irc_smart * irc_smart_filter * ----------------------------------------- +---- 特定のチャンネルのみ、またはある名前で始まるチャンネルに対してフィルタを作成することもできます。 (`/help filter` を参照): ----------------------------------------- +---- /filter add irc_smart_weechat irc.freenode.#weechat irc_smart_filter * /filter add irc_smart_weechats irc.freenode.#weechat* irc_smart_filter * ----------------------------------------- +---- 以下のコマンドで参加メッセージだけ、又は退出/終了メッセージだけを隠すこともできます: ----------------------------------------- +---- /set irc.look.smart_filter_join on /set irc.look.smart_filter_quit on ----------------------------------------- +---- 遅延時間 (分単位) を設定することもできます: ----------------------------------------- +---- /set irc.look.smart_filter_delay 5 ----------------------------------------- +---- 過去 5 分間あるニックネームからの発言が無かった場合、 このニックネームに対する参加または退出/終了メッセージがチャンネルから隠されます。 [[irc_ctcp_replies]] -==== CTCP 応答 ==== +==== CTCP 応答 CTCP 応答をカスタマイズしたり、いくつかの CTCP 要求をブロック (無応答) することができます。 例えば、CTCP "VERSION" 要求に対する応答をカスタマイズするには、以下のコマンドを使ってください: ----------------------------------------- +---- /set irc.ctcp.version "I'm running WeeChat $version, it rocks!" ----------------------------------------- +---- CTCP "VERSION" 要求をブロックする (要求に対する応答を行わない) には、空文字列を設定してください: ----------------------------------------- +---- /set irc.ctcp.version "" ----------------------------------------- +---- 未定義の CTCP 要求に対する応答もカスタマイズできます。例えば CTCP "BLABLA" 要求に対する応答を以下のように設定できます: ----------------------------------------- +---- /set irc.ctcp.blabla "This is my answer to CTCP BLABLA" ----------------------------------------- +---- 特定のサーバに対して CTCP 応答をカスタマイズするには、CTCP 名の前に内部サーバ名をつけてください: ----------------------------------------- +---- /set irc.ctcp.freenode.version "WeeChat $version (for freenode)" ----------------------------------------- +---- 標準の CTCP 応答を復元するには、オプションを削除してください: ----------------------------------------- +---- /unset irc.ctcp.version ----------------------------------------- +---- 以下のコードを設定値に含めることが可能です。これらのコードは CTCP 応答時に自動的に WeeChat によって展開されます: [width="100%",cols="^2l,4,8",options="header"] -|======================================== +|=== | コード | 説明 | 値/例 | $clientinfo | サポートしている CTCP オプションのリスト | `ACTION DCC CLIENTINFO FINGER PING SOURCE TIME USERINFO VERSION` | $version | WeeChat バージョン | `0.4.0-dev` @@ -2120,7 +2120,7 @@ CTCP 応答時に自動的に WeeChat によって展開されます: | $time | 現在の日時 | `Sun, 16 Dec 2012 10:40:48 +0100` | $username | IRC サーバのユーザネーム | `ログイン名` | $realname | IRC サーバのリアルネーム | `John Doe` -|======================================== +|=== [NOTE] ^(1)^ git バージョンとは `git describe` コマンドの出力です。git リポジトリで @@ -2129,7 +2129,7 @@ WeeChat をコンパイルし、git がインストールされている場合 CTCP オプションが設定されていない (デフォルトの) 場合、CTCP 応答は以下のようになります: [width="100%",cols="^2,4,8",options="header"] -|======================================== +|=== | CTCP | 応答フォーマット | 例 | CLIENTINFO | `$clientinfo` | `ACTION DCC CLIENTINFO FINGER PING SOURCE TIME USERINFO VERSION` | FINGER | `WeeChat $versiongit` | `WeeChat 0.4.0-dev (git: v0.3.9-104-g7eb5cc4)` @@ -2137,10 +2137,10 @@ CTCP オプションが設定されていない (デフォルトの) 場合、CT | TIME | `$time` | `Sun, 16 Dec 2012 10:40:48 +0100` | USERINFO | `$username ($realname)` | `ログイン名 (John Doe)` | VERSION | `WeeChat $versiongit ($compilation)` | `WeeChat 0.4.0-dev (git: v0.3.9-104-g7eb5cc4) (Dec 16 2012)` -|======================================== +|=== [[irc_target_buffer]] -==== IRC メッセージのターゲットバッファ ==== +==== IRC メッセージのターゲットバッファ `irc.msgbuffer.*` オプションを使えば、IRC メッセージに対するターゲットバッファ (メッセージを表示するバッファ) をカスタマイズすることができます。 @@ -2166,7 +2166,7 @@ weechat:: カスタマイズできる一部の IRC メッセージ、別名のリストは以下です: [width="60%",cols="^1m,^3m,8",options="header"] -|======================================== +|=== | メッセージ | 別名 | 説明 | error | | エラー | invite | | チャンネルへの招待 @@ -2234,7 +2234,7 @@ weechat:: | 728 | quietlist | 発言禁止リスト | 729 | quietlist | 発言禁止リストの終了 | 901 | | ログインに成功 -|======================================== +|=== その他の数値コマンドも同様にカスタマイズできます。 @@ -2245,60 +2245,60 @@ weechat:: * `/whois` の結果をプライベートバッファに表示: ----------------------------------------- +---- /set irc.msgbuffer.whois private ----------------------------------------- +---- * whois に対する設定をデフォルトに戻す (サーババッファに表示): ----------------------------------------- +---- /unset irc.msgbuffer.whois ----------------------------------------- +---- * "freenode" サーバの場合、招待メッセージを現在のバッファに表示: ----------------------------------------- +---- /set irc.msgbuffer.freenode.invite current ----------------------------------------- +---- * "303" (ison) メッセージを WeeChat "core" バッファに表示: ----------------------------------------- +---- /set irc.msgbuffer.303 weechat ----------------------------------------- +---- [[logger_plugin]] -=== Logger プラグイン === +=== Logger プラグイン Logger プラグインを使うことで、バッファの内容をファイルに保存できます。 保存形式とその方法をオプションで設定できます。 [[logger_options]] -==== オプション (logger.conf) ==== +==== オプション (logger.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | look | /set logger.look.* | 外観 | color | /set logger.color.* | 色 | file | /set logger.file.* | ログファイルのオプション | level | /set logger.level.* | バッファのログレベル (オプションをセクションに追加/削除出来ます) | mask | /set logger.mask.* | バッファのファイル名マスク (オプションをセクションに追加/削除出来ます) -|======================================== +|=== オプション: include::autogen/user/logger_options.txt[] [[logger_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/logger_commands.txt[] [[logger_log_levels]] -==== ログレベル ==== +==== ログレベル ログ保存はそれぞれのバッファに対して設定されたログレベルに従って行われます。デフォルトのレベルは 9 (バッファに表示されたメッセージをすべて保存) です。 @@ -2322,64 +2322,64 @@ IRC プラグインに対しては以下のレベルが利用されます: * IRC チャンネル #weechat に対してレベル 3 を設定: ----------------------------------------- +---- /set logger.level.irc.freenode.#weechat 3 ----------------------------------------- +---- * freenode サーババッファに対してレベル 3 を設定: ----------------------------------------- +---- /set logger.level.irc.server.freenode 3 ----------------------------------------- +---- * freenode サーバの全てのチャンネルに対してレベル 3 を設定: ----------------------------------------- +---- /set logger.level.irc.freenode 3 ----------------------------------------- +---- * 全ての IRC バッファに対してレベル 2 を設定: ----------------------------------------- +---- /set logger.level.irc 2 ----------------------------------------- +---- [[logger_filenames_masks]] -==== ファイル名マスク ==== +==== ファイル名マスク バッファに対し個別にファイル名マスクを設定することができます、 ファイル名にはローカルバッファ変数が利用されます。現在のバッファに設定されたローカル変数を確認するには: ----------------------------------------- +---- /buffer localvar ----------------------------------------- +---- 例えば "irc.freenode.#weechat" バッファの場合、WeeChat は以下の順番でオプションに設定されたファイル名マスクを検索します: ----------------------------------------- +---- logger.mask.irc.freenode.#weechat logger.mask.irc.freenode logger.mask.irc logger.file.mask ----------------------------------------- +---- 特定の IRC サーバ ("logger.mask.irc.freenode") またはプラグイン ("logger.mask.irc") のグループに対して共通のマスクを適用できます。 [[logger_files_by_date]] -===== ログファイルに日付を利用する ===== +===== ログファイルに日付を利用する ログファイルに日付を使うには、マスクに日時/時間指定子を利用できます (フォーマットに関しては `man strftime` を参照してください)。例えば: ----------------------------------------- +---- /set logger.file.mask "%Y/%m/$plugin.$name.weechatlog" ----------------------------------------- +---- 以下のファイルが作成されます: -........................................ +.... ~/.weechat/ |--- logs/ |--- 2010/ @@ -2390,20 +2390,20 @@ logger.file.mask |--- 12/ | irc.server.freenode.weechatlog | irc.freenode.#weechat.weechatlog -........................................ +.... [[logger_irc_files_by_server_channel]] -===== IRC ログファイルにサーバとチャンネル名を利用する ===== +===== IRC ログファイルにサーバとチャンネル名を利用する IRC サーバ名を使ったディレクトリに、チャンネル名を使ったファイルを作成する場合: ----------------------------------------- +---- /set logger.mask.irc "irc/$server/$channel.weechatlog" ----------------------------------------- +---- 以下のファイルが作成されます: -........................................ +.... ~/.weechat/ |--- logs/ |--- irc/ @@ -2415,10 +2415,10 @@ IRC サーバ名を使ったディレクトリに、チャンネル名を使っ | oftc.weechatlog | #chan1.weechatlog | #chan2.weechatlog -........................................ +.... [[relay_plugin]] -=== Relay プラグイン === +=== Relay プラグイン Relay プラグインはネットワークを介して異なるプロトコルを用いてデータを中継するために利用します: @@ -2428,12 +2428,12 @@ Relay プラグインはネットワークを介して異なるプロトコル (例えば QWeeChat) を使う場合に利用されるプロトコル [[relay_options]] -==== オプション (relay.conf) ==== +==== オプション (relay.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | look | /set relay.look.* | 外観 | color | /set relay.color.* | 色 @@ -2441,30 +2441,30 @@ Relay プラグインはネットワークを介して異なるプロトコル | irc | /set relay.irc.* | 特定の irc プロトコルのオプション (irc プロキシ) | port | <<command_relay_relay,/relay add>> + /set relay.port.* | リレーに使うポート(irc や weechat プロトコル) (オプションをセクションに追加/削除出来ます) -|======================================== +|=== オプション: include::autogen/user/relay_options.txt[] [[relay_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/relay_commands.txt[] [[relay_password]] -==== パスワード ==== +==== パスワード 以下のコマンドを利用して、リレー用のパスワードを設定することを強くお勧めします: ----------------------------------------- +---- /set relay.network.password "mypass" ----------------------------------------- +---- このパスワードは 'irc' と 'weechat' プロトコルで利用されます。 [[relay_ssl]] -==== SSL ==== +==== SSL 証明書と秘密鍵を作り、プロトコル名の最初に "ssl." を付けることで SSL 経由でリレーを利用することができます。 @@ -2474,21 +2474,21 @@ SSL 経由でリレーを利用することができます。 以下のコマンドを使って証明書と秘密鍵ファイルを作成します: ----------------------------------------- +---- $ mkdir -p ~/.weechat/ssl $ cd ~/.weechat/ssl $ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem ----------------------------------------- +---- WeeChat が既に起動している場合、 以下のコマンドで証明書と秘密鍵を再読み込みできます: ----------------------------------------- +---- /relay sslcertkey ----------------------------------------- +---- [[relay_irc_proxy]] -==== IRC プロキシ ==== +==== IRC プロキシ Relay プラグインは IRC プロキシとしても使えます: Relay プラグインは IRC サーバのふりをして、他の IRC クライアント (WeeChat 自身も) は WeeChat に接続できます。 @@ -2498,41 +2498,41 @@ IRC サーバごとに異なるポート、もしくは全てのサーバに対 すべてのサーバに対して共通のポートを定義した場合には、クライアントからサーバの内部名を IRC の "PASS" コマンドに含めて送信するようにしてください、以下のフォーマットを使ってください: ----------------------------------------- +---- PASS server:mypass ----------------------------------------- +---- 例: SSL を使い、全てのサーバに対して共通の IRC プロキシを設定 (サーバはクライアントが選択): ----------------------------------------- +---- /relay add ssl.irc 8000 ----------------------------------------- +---- 例: SSL を使わず、内部名 "freenode" のサーバに対して IRC プロキシを設定: ----------------------------------------- +---- /relay add irc.freenode 8000 ----------------------------------------- +---- 任意の IRC クライアントからサーバパスワード "mypass" (全てのサーバに対して共通の IRC プロキシを設定した場合には "freenode:mypass") で 8000 番ポートに接続出来ます。 [[relay_weechat_protocol]] -==== WeeChat プロトコル ==== +==== WeeChat プロトコル Relay プラグインは WeeChat プロトコルを使ってリモートインターフェイスに対してデータを送信できます。 例: ----------------------------------------- +---- /relay add weechat 9000 ----------------------------------------- +---- この後、リモートインターフェイスを使って 9000 番ポートに対して、パスワード "mypass" で接続することができます。 [[relay_websocket]] -==== WebSocket ==== +==== WebSocket Relay プラグインはすべてのプロトコルに対して WebSocket プロトコル (http://tools.ietf.org/html/rfc6455[RFC 6455]) をサポートします。 @@ -2545,15 +2545,15 @@ origin が許可されていれば WebSocket 用のソケットが準備され HTML5 を使えばたった 1 行の JavaScript で WebSocket をオープンすることが可能です: [source,js] ----------------------------------------- +---- websocket = new WebSocket("ws://server.com:9000/weechat"); ----------------------------------------- +---- ポート番号 (例では 9000 番) は Relay プラグインで定義したものです。URI の最後には必ず "/weechat" をつけます ('irc' と 'weechat' プロトコルの場合)。 [[rmodifier_plugin]] -=== Rmodifier プラグイン === +=== Rmodifier プラグイン Rmodifier プラグインは正規表現を使って文字列を置換します。 パスワードの入力時やに入力文字列を隠すことや WeeChat @@ -2561,29 +2561,29 @@ Rmodifier プラグインは正規表現を使って文字列を置換します 例えば、パスワード文字列を `*` で置き換えることができます。 [[rmodifier_options]] -==== オプション (rmodifier.conf) ==== +==== オプション (rmodifier.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | look | /set rmodifier.look.* | 外観 | modifier | <<command_rmodifier_rmodifier,/rmodifier add>> + /set rmodifier.modifier.* | rmodifier -|======================================== +|=== オプション: include::autogen/user/rmodifier_options.txt[] [[rmodifier_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/rmodifier_commands.txt[] [[rmodifier_creation]] -==== Rmodifier の作成 ==== +==== Rmodifier の作成 rmodifier は 3 つの要素からなります: @@ -2621,7 +2621,7 @@ API リファレンス' の 'weechat_hook_modifier' 関数を参照してくだ `/oper nick ********` のように表示されます。 [[scripts_plugins]] -=== スクリプトプラグイン === +=== スクリプトプラグイン WeeChat は 6 種類のスクリプトプラグインを備えています: Python、Perl、Ruby、Lua、Tcl、Guile (scheme)。 @@ -2635,59 +2635,59 @@ WeeChat は 6 種類のスクリプトプラグインを備えています: Pyth 'WeeChat スクリプト製作ガイド' を参照してください。 [[script_options]] -==== スクリプトオプション (script.conf) ==== +==== スクリプトオプション (script.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | look | /set script.look.* | 外観 | color | /set script.color.* | 色 | scripts | /set script.scripts.* | スクリプトのダウンロードに関するオプション -|======================================== +|=== オプション: include::autogen/user/script_options.txt[] [[script_commands]] -==== Script コマンド ==== +==== Script コマンド include::autogen/user/script_commands.txt[] [[python_commands]] -==== Python コマンド ==== +==== Python コマンド include::autogen/user/python_commands.txt[] [[perl_commands]] -==== Perl コマンド ==== +==== Perl コマンド include::autogen/user/perl_commands.txt[] [[ruby_commands]] -==== Ruby コマンド ==== +==== Ruby コマンド include::autogen/user/ruby_commands.txt[] [[lua_commands]] -==== Lua コマンド ==== +==== Lua コマンド include::autogen/user/lua_commands.txt[] [[tcl_commands]] -==== Tcl コマンド ==== +==== Tcl コマンド include::autogen/user/tcl_commands.txt[] [[guile_commands]] -==== Guile コマンド ==== +==== Guile コマンド include::autogen/user/guile_commands.txt[] [[xfer_plugin]] -=== Xfer プラグイン === +=== Xfer プラグイン Xfer プラグインの機能: @@ -2696,30 +2696,30 @@ Xfer プラグインの機能: * ファイル転送、例えば IRC プラグイン経由の "DCC" [[xfer_options]] -==== オプション (xfer.conf) ==== +==== オプション (xfer.conf) セクション: [width="100%",cols="3m,6m,16",options="header"] -|======================================== +|=== | セクション | 操作コマンド | 説明 | look | /set xfer.look.* | 外観 | color | /set xfer.color.* | 色 | network | /set xfer.network.* | ネットワークオプション | file | /set xfer.file.* | ファイルの送信/受信に関するオプション -|======================================== +|=== オプション: include::autogen/user/xfer_options.txt[] [[xfer_commands]] -==== コマンド ==== +==== コマンド include::autogen/user/xfer_commands.txt[] [[support]] -== サポート == +== サポート サポートを依頼する前に、WeeChat に付属するドキュメントと FAQ を読んでください。 (ドキュメントとはこの文書のことで、ここまでの全ての内容を読んでいないのであれば、 |