diff options
Diffstat (limited to 'doc/ja')
27 files changed, 991 insertions, 991 deletions
diff --git a/doc/ja/autogen/plugin_api/completions.txt b/doc/ja/autogen/plugin_api/completions.txt index c5a4a72e0..9e12301c4 100644 --- a/doc/ja/autogen/plugin_api/completions.txt +++ b/doc/ja/autogen/plugin_api/completions.txt @@ -1,5 +1,5 @@ [width="65%",cols="^1,^2,8",options="header"] -|======================================== +|=== | プラグイン | 名前 | 説明 | alias | alias | 別名のリスト @@ -130,4 +130,4 @@ | xfer | nick | DCC チャットのニックネーム -|======================================== +|=== diff --git a/doc/ja/autogen/plugin_api/infolists.txt b/doc/ja/autogen/plugin_api/infolists.txt index 08670fe2f..545e1ecbc 100644 --- a/doc/ja/autogen/plugin_api/infolists.txt +++ b/doc/ja/autogen/plugin_api/infolists.txt @@ -1,5 +1,5 @@ [width="100%",cols="^1,^2,5,5,5",options="header"] -|======================================== +|=== | プラグイン | 名前 | 説明 | ポインタ | 引数 | alias | alias | 別名のリスト | 別名のポインタ (任意) | 別名の名前 (ワイルドカードとして "*" で始めるか終わるかできます) (任意) @@ -70,4 +70,4 @@ | xfer | xfer | xfer のリスト | xfer ポインタ (任意) | - -|======================================== +|=== diff --git a/doc/ja/autogen/plugin_api/infos.txt b/doc/ja/autogen/plugin_api/infos.txt index f57553b3a..94d384269 100644 --- a/doc/ja/autogen/plugin_api/infos.txt +++ b/doc/ja/autogen/plugin_api/infos.txt @@ -1,5 +1,5 @@ [width="100%",cols="^1,^2,6,6",options="header"] -|======================================== +|=== | プラグイン | 名前 | 説明 | 引数 | aspell | aspell_dict | バッファで使用中の辞書のコンマ区切りリスト | バッファポインタ ("0x12345678") またはバッファのフルネーム ("irc.freenode.#weechat") @@ -62,4 +62,4 @@ | weechat | weechat_upgrading | WeeChat がアップグレード中は 1 (コマンド `/upgrade`) | - -|======================================== +|=== diff --git a/doc/ja/autogen/plugin_api/infos_hashtable.txt b/doc/ja/autogen/plugin_api/infos_hashtable.txt index 44241f441..c59ff65a4 100644 --- a/doc/ja/autogen/plugin_api/infos_hashtable.txt +++ b/doc/ja/autogen/plugin_api/infos_hashtable.txt @@ -1,9 +1,9 @@ [width="100%",cols="^1,^2,6,6,6",options="header"] -|======================================== +|=== | プラグイン | 名前 | 説明 | ハッシュテーブル (入力) | ハッシュテーブル (出力) | irc | irc_message_parse | IRC メッセージを解析 | "message": IRC メッセージ、"server": サーバ名 (任意) | "tags": タグ、"message_without_tags": タグを含まないメッセージ、"nick": ニックネーム、"host": ホスト名、"command": コマンド、"channel": チャンネル、"arguments": 引数 (チャンネルを含む) | irc | irc_message_split | IRC メッセージを分割 (512 バイトに収める) | "message": IRC メッセージ、"server": サーバ名 (任意) | "msg1" ... "msgN": 送信メッセージ (最後の "\r\n" は無し), "args1" ... "argsN": メッセージの引数、"count": メッセージの数 -|======================================== +|=== diff --git a/doc/ja/autogen/plugin_api/url_options.txt b/doc/ja/autogen/plugin_api/url_options.txt index 43146bb4e..e216f5961 100644 --- a/doc/ja/autogen/plugin_api/url_options.txt +++ b/doc/ja/autogen/plugin_api/url_options.txt @@ -1,5 +1,5 @@ [width="100%",cols="2,^1,7",options="header"] -|======================================== +|=== | オプション | タイプ | 定数 ^(1)^ | verbose | long | @@ -298,4 +298,4 @@ | new_directory_perms | long | -|======================================== +|=== diff --git a/doc/ja/autogen/user/alias_commands.txt b/doc/ja/autogen/user/alias_commands.txt index daa240d34..bbf22a79b 100644 --- a/doc/ja/autogen/user/alias_commands.txt +++ b/doc/ja/autogen/user/alias_commands.txt @@ -1,7 +1,7 @@ [[command_alias_alias]] [command]*`alias`* コマンドの別名を作成:: ----------------------------------------- +---- /alias [-completion <completion>] <alias> [<command> [;<command>...]] completion: 別名の補完 (任意、デフォルトではターゲットコマンドを伴って補完される) @@ -30,5 +30,5 @@ completion: 別名の補完 (任意、デフォルトではターゲットコマ /alias hello /allchan -exclude=#weechat msg * hello /forcejoin を /sajoin の補完候補を使い IRC コマンド "forcejoin" を送信する別名と定義: /alias -completion %%sajoin forcejoin /quote forcejoin ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/aspell_commands.txt b/doc/ja/autogen/user/aspell_commands.txt index b621580df..fa9f8528f 100644 --- a/doc/ja/autogen/user/aspell_commands.txt +++ b/doc/ja/autogen/user/aspell_commands.txt @@ -1,7 +1,7 @@ [[command_aspell_aspell]] [command]*`aspell`* aspell プラグイン設定:: ----------------------------------------- +---- /aspell enable|disable|toggle listdict setdict <dict>[,<dict>...] @@ -23,5 +23,5 @@ listdict: インストール済み辞書を表示 /aspell enable aspell の有効無効を切り替えるデフォルトのキーは alt-s です。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/charset_commands.txt b/doc/ja/autogen/user/charset_commands.txt index 34ac8be18..9525c8951 100644 --- a/doc/ja/autogen/user/charset_commands.txt +++ b/doc/ja/autogen/user/charset_commands.txt @@ -1,7 +1,7 @@ [[command_charset_charset]] [command]*`charset`* 現在のバッファの文字集合を変更:: ----------------------------------------- +---- /charset decode|encode <charset> reset @@ -9,5 +9,5 @@ encode: エンコード文字集合を変更 charset: 現在のバッファの新しい文字集合 reset: 現在のバッファの文字集合をリセット ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/guile_commands.txt b/doc/ja/autogen/user/guile_commands.txt index 151d034be..aa8cc5c84 100644 --- a/doc/ja/autogen/user/guile_commands.txt +++ b/doc/ja/autogen/user/guile_commands.txt @@ -1,7 +1,7 @@ [[command_guile_guile]] [command]*`guile`* スクリプトをリストアップ/ロード/アンロード:: ----------------------------------------- +---- /guile list|listfull [<name>] load [-q] <filename> autoload @@ -18,5 +18,5 @@ filename: ロードするスクリプト (ファイル) -q: 出力抑制モード: メッセージを表示しない 引数無しの場合、全てのロード済みスクリプトをリストアップします。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/irc_commands.txt b/doc/ja/autogen/user/irc_commands.txt index 984b6a125..234f33ad1 100644 --- a/doc/ja/autogen/user/irc_commands.txt +++ b/doc/ja/autogen/user/irc_commands.txt @@ -1,16 +1,16 @@ [[command_irc_admin]] [command]*`admin`* サーバ管理者に関する情報を探す:: ----------------------------------------- +---- /admin [<target>] target: server ----------------------------------------- +---- [[command_irc_allchan]] [command]*`allchan`* 全てのサーバ、全てのチャンネルに対してコマンドを実行:: ----------------------------------------- +---- /allchan [-current] [-exclude=<channel>[,<channel>...]] <command> [<arguments>] -current: 現在のサーバ上のチャンネルに対してコマンドを実行 @@ -25,12 +25,12 @@ arguments: コマンドの引数 (特殊変数 $nick、$channel、$server はそ /allchan -exclude=#weechat msg * hello #weechat と #linux で始まるチャンネルを除いが全てのチャンネルで 'hello' と発言: /allchan -exclude=#weechat,#linux* msg * hello ----------------------------------------- +---- [[command_irc_allserv]] [command]*`allserv`* 全ての接続済みサーバでコマンドを実行:: ----------------------------------------- +---- /allserv [-exclude=<server>[,<server>...]] <command> [<arguments>] -exclude: いくつかのサーバを除外 (複数のサーバを除外するには '*' をサーバ名の最初と最後につける) @@ -44,24 +44,24 @@ arguments: コマンドの引数 (特殊変数 $nick、$channel、$server はそ /allserv away I'm away すべてのサーバで自分のニックネームに対して whois を実行: /allserv whois $nick ----------------------------------------- +---- [[command_irc_ban]] [command]*`ban`* ニックネームかホスト名を指定してバン:: ----------------------------------------- +---- /ban [<channel>] [<nick> [<nick>...]] channel: バン対象チャンネル nick: バンするユーザ名かホスト名 引数無しの場合は、現在のチャンネルのバンリストを表示。 ----------------------------------------- +---- [[command_irc_connect]] [command]*`connect`* IRC サーバに接続:: ----------------------------------------- +---- /connect <server> [<server>...] [-<option>[=<value>]] [-no<option>] [-nojoin] [-switch] -all|-auto|-open [-nojoin] [-switch] @@ -85,33 +85,33 @@ channel: バン対象チャンネル /connect my.server.org/6697 -ssl -password=test /connect irc://nick@irc.oftc.net/#channel /connect -switch ----------------------------------------- +---- [[command_irc_ctcp]] [command]*`ctcp`* CTCP メッセージの送信 (Client-To-Client Protocol):: ----------------------------------------- +---- /ctcp <target> <type> [<arguments>] target: CTCP を送信するニックネーム又はチャンネル名 type: CTCP タイプ (例: "version"、"ping"、..) arguments: CTCP の引数 ----------------------------------------- +---- [[command_irc_cycle]] [command]*`cycle`* チャンネルから退出し再参加:: ----------------------------------------- +---- /cycle [<channel>[,<channel>...]] [<message>] channel: チャンネル名 message: 退出メッセージ (他のユーザに対する) ----------------------------------------- +---- [[command_irc_dcc]] [command]*`dcc`* DCC の開始 (ファイル転送かダイレクトチャット):: ----------------------------------------- +---- /dcc chat <nick> send <nick> <file> @@ -123,76 +123,76 @@ file: ファイルネーム (ローカルホスト上の) /dcc chat toto ファイル "/home/foo/bar.txt" を ニックネーム "toto" に送信: /dcc send toto /home/foo/bar.txt ----------------------------------------- +---- [[command_irc_dehalfop]] [command]*`dehalfop`* ニックネームから half-operator 権を剥奪:: ----------------------------------------- +---- /dehalfop <nick> [<nick>...] nick: ニックネームまたはマスク (ワイルドカード "*" を最初と最後につけることが可能) *: 自分以外のチャンネル参加者からチャンネルの half-operator 権を剥奪 ----------------------------------------- +---- [[command_irc_deop]] [command]*`deop`* ニックネームからチャンネルオペレータ権を剥奪:: ----------------------------------------- +---- /deop <nick> [<nick>...] * -yes nick: ニックネームまたはマスク (ワイルドカード "*" を最初と最後につけることが可能) *: 自分以外のチャンネル参加者からチャンネルオペレータ権を剥奪 ----------------------------------------- +---- [[command_irc_devoice]] [command]*`devoice`* ニックネームから発言権を剥奪:: ----------------------------------------- +---- /devoice <nick> [<nick>...] * -yes nick: ニックネームまたはマスク (ワイルドカード "*" を最初と最後につけることが可能) *: チャンネル参加者全員から voice 状態を剥奪 ----------------------------------------- +---- [[command_irc_die]] [command]*`die`* サーバのシャットダウン:: ----------------------------------------- +---- /die [<target>] target: サーバ名 ----------------------------------------- +---- [[command_irc_disconnect]] [command]*`disconnect`* 特定のまたは全ての IRC サーバとの接続を切断:: ----------------------------------------- +---- /disconnect [<server>|-all|-pending [<reason>]] server: 接続を切断するサーバ名 -all: 全てのサーバとの接続を切る -pending: 現在再接続試行中のサーバに対する自動再接続を止める reason: 終了の理由 ----------------------------------------- +---- [[command_irc_halfop]] [command]*`halfop`* 指定したニックネームに half-operator 権を付与:: ----------------------------------------- +---- /halfop <nick> [<nick>...] * -yes nick: ニックネームまたはマスク (ワイルドカード "*" を最初と最後につけることが可能) *: チャンネル参加者全員に half-operator 権を付与 ----------------------------------------- +---- [[command_irc_ignore]] [command]*`ignore`* あるサーバかチャンネルで、指定したニックネーム/ホスト名を無視:: ----------------------------------------- +---- /ignore list add [re:]<nick> [<server> [<channel>]] del <number>|-all @@ -215,40 +215,40 @@ nick: ニックネームまたはマスク (ワイルドカード "*" を最初 /ignore add toto@domain.com freenode freenode サーバの #weechat チャンネル上のホスト名 "toto*@*.domain.com" を無視: /ignore add toto*@*.domain.com freenode #weechat ----------------------------------------- +---- [[command_irc_info]] [command]*`info`* サーバに関する情報を入手:: ----------------------------------------- +---- /info [<target>] target: サーバ名 ----------------------------------------- +---- [[command_irc_invite]] [command]*`invite`* チャンネルにニックネームを招待:: ----------------------------------------- +---- /invite <nick> [<nick>...] [<channel>] nick: 招待するニックネーム channel: 招待先のチャンネル ----------------------------------------- +---- [[command_irc_ison]] [command]*`ison`* ニックネームが IRC 上にいるか確認:: ----------------------------------------- +---- /ison <nick> [<nick>...] nick: nick ----------------------------------------- +---- [[command_irc_join]] [command]*`join`* チャンネルに参加:: ----------------------------------------- +---- /join [-noswitch] [-server <server>] [<channel1>[,<channel2>...]] [<key1>[,<key2>...]] -noswitch: 新しいバッファに移動しない @@ -261,23 +261,23 @@ nick: nick /join #protectedchan,#weechat key /join -server freenode #weechat /join -noswitch #weechat ----------------------------------------- +---- [[command_irc_kick]] [command]*`kick`* チャンネルからユーザを強制的に削除:: ----------------------------------------- +---- /kick [<channel>] <nick> [<reason>] channel: channel where user is nick: nick to kick reason: reason for kick (special variables $nick, $channel and $server are replaced by their value) ----------------------------------------- +---- [[command_irc_kickban]] [command]*`kickban`* チャンネルからニックネームをキックして参加を禁止:: ----------------------------------------- +---- /kickban [<channel>] <nick> [<reason>] channel: channel where user is @@ -289,32 +289,32 @@ It is possible to kick/ban with a mask, nick will be extracted from mask and rep Example: ban "*!*@host.com" and then kick "toto": /kickban toto!*@host.com ----------------------------------------- +---- [[command_irc_kill]] [command]*`kill`* クライアント - サーバの接続を閉じる:: ----------------------------------------- +---- /kill <nick> <reason> nick: kill するニックネーム reason: kill の理由 ----------------------------------------- +---- [[command_irc_links]] [command]*`links`* このクエリに応答するサーバが知っている全てのサーバ名をリストアップ:: ----------------------------------------- +---- /links [[<server>] <server_mask>] server: このクエリに応答するべきサーバ server_mask: このマスクにマッチするサーバのリスト ----------------------------------------- +---- [[command_irc_list]] [command]*`list`* チャンネルとトピックをリストアップ:: ----------------------------------------- +---- /list [<channel>[,<channel>...]] [<server>] [-re <regex>] channel: リストアップするチャンネル名 @@ -328,37 +328,37 @@ channel: リストアップするチャンネル名 /list #weechat "#weechat" で始まる全てのチャンネルをリストアップ (大きなネットワークでは非常に遅い): /list -re #weechat.* ----------------------------------------- +---- [[command_irc_lusers]] [command]*`lusers`* IRC ネットワークのサイズに関する統計を入手:: ----------------------------------------- +---- /lusers [<mask> [<target>]] mask: このマスクにマッチするサーバ target: リクエストを送信するサーバ ----------------------------------------- +---- [[command_irc_map]] [command]*`map`* IRC ネットワークのグラフィカルマップを表示:: ----------------------------------------- ----------------------------------------- +---- +---- [[command_irc_me]] [command]*`me`* 現在のチャンネルに CTCP action を送信:: ----------------------------------------- +---- /me <message> message: 送信メッセージ ----------------------------------------- +---- [[command_irc_mode]] [command]*`mode`* チャンネルかユーザのモードを変更:: ----------------------------------------- +---- /mode [<channel>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<arguments>] <nick> [+|-]i|s|w|o @@ -390,62 +390,62 @@ message: 送信メッセージ /mode #weechat +t サーバ上で不可視にする: /mode nick +i ----------------------------------------- +---- [[command_irc_motd]] [command]*`motd`* "今日のメッセージ" を取得:: ----------------------------------------- +---- /motd [<target>] target: サーバ名 ----------------------------------------- +---- [[command_irc_msg]] [command]*`msg`* ニックネームかチャンネルにメッセージを送る:: ----------------------------------------- +---- /msg [-server <server>] <target>[,<target>...] <text> server: このサーバに送信 (内部サーバ名) target: ニックネーム又はチャンネル名 (マスクを使えるかもしれない、'*' = 現在のチャンネル) text: 送信するテキスト ----------------------------------------- +---- [[command_irc_names]] [command]*`names`* チャンネルに参加しているニックネームをリストアップ:: ----------------------------------------- +---- /names [<channel>[,<channel>...]] channel: チャンネル名 ----------------------------------------- +---- [[command_irc_nick]] [command]*`nick`* 現在のニックネームを変更:: ----------------------------------------- +---- /nick [-all] <nick> -all: 全ての接続済みサーバで新しいニックネームを設定 nick: 新しいニックネーム ----------------------------------------- +---- [[command_irc_notice]] [command]*`notice`* ユーザに notice メッセージを送信:: ----------------------------------------- +---- /notice [-server <server>] <target> <text> server: このサーバに送信 (内部サーバ名) target: ニックネーム又はチャンネル text: 送信するテキスト ----------------------------------------- +---- [[command_irc_notify]] [command]*`notify`* サーバ上のニックネームに対して接続か離席状態の通知を追加する:: ----------------------------------------- +---- /notify add <nick> [<server> [-away]] del <nick>|-all [<server>] @@ -465,96 +465,96 @@ server: 内部サーバ名 (デフォルトでは現在のサーバ) /notify add toto freenode "toto" が freenode サーバに戻るか離席状態になった場合に通知: /notify add toto freenode -away ----------------------------------------- +---- [[command_irc_op]] [command]*`op`* ニックネームにオペレータ権を付与:: ----------------------------------------- +---- /op <nick> [<nick>...] * -yes nick: ニックネームまたはマスク (ワイルドカード "*" を最初と最後につけることが可能) *: チャンネル参加者全員にチャンネルオペレータ権を付与 ----------------------------------------- +---- [[command_irc_oper]] [command]*`oper`* オペレータ権を入手:: ----------------------------------------- +---- /oper <user> <password> user: ユーザ password: パスワード ----------------------------------------- +---- [[command_irc_part]] [command]*`part`* チャンネルから退出:: ----------------------------------------- +---- /part [<channel>[,<channel>...]] [<message>] channel: 退出するチャンネル名 message: 退出メッセージ (他のユーザに対して) ----------------------------------------- +---- [[command_irc_ping]] [command]*`ping`* サーバにピンを送信:: ----------------------------------------- +---- /ping <server1> [<server2>] server1: サーバ server2: このサーバにピンを転送 ----------------------------------------- +---- [[command_irc_pong]] [command]*`pong`* ピンメッセージに応答:: ----------------------------------------- +---- /pong <daemon> [<daemon2>] daemon: ピンメッセージに応答したデーモン daemon2: メッセージをデーモンに転送 ----------------------------------------- +---- [[command_irc_query]] [command]*`query`* ニックネーム宛にプライベートメッセージを送信:: ----------------------------------------- +---- /query [-server <server>] <nick>[,<nick>...] [<text>] server: 送信先サーバ (内部サーバ名) nick: プライベート会話を行うニックネーム text: 送信テキスト ----------------------------------------- +---- [[command_irc_quiet]] [command]*`quiet`* ニックネームかホストを発言禁止に:: ----------------------------------------- +---- /quiet [<channel>] [<nick> [<nick>...]] channel: 発言禁止にするチャンネル nick: 発言禁止にするユーザ名かホスト名 引数無しの場合は、現在のチャンネルの発言禁止リストを表示。 ----------------------------------------- +---- [[command_irc_quote]] [command]*`quote`* パースせずにサーバ宛に生データを送信:: ----------------------------------------- +---- /quote [-server <server>] <data> server: 送信先サーバ (内部サーバ名) data: 送信する生データ ----------------------------------------- +---- [[command_irc_reconnect]] [command]*`reconnect`* サーバに再接続:: ----------------------------------------- +---- /reconnect <server> [<server>...] [-nojoin] [-switch] -all [-nojoin] [-switch] @@ -562,80 +562,80 @@ server: 送信先サーバ (内部サーバ名) -all: 全てのサーバに再接続 -nojoin: チャンネルに参加しない (autojoin がサーバで有効化されていても) -switch: 次のサーバアドレスに移動 ----------------------------------------- +---- [[command_irc_rehash]] [command]*`rehash`* サーバに設定ファイルの読み込みを指示:: ----------------------------------------- +---- /rehash [<option>] option: 追加オプション、いくつかのサーバ用 ----------------------------------------- +---- [[command_irc_restart]] [command]*`restart`* サーバに再起動を指示:: ----------------------------------------- +---- /restart [<target>] target: サーバ名 ----------------------------------------- +---- [[command_irc_sajoin]] [command]*`sajoin`* ユーザがチャンネルへ参加することを強制:: ----------------------------------------- +---- /sajoin <nick> <channel>[,<channel>...] nick: ニックネーム channel: チャンネル名 ----------------------------------------- +---- [[command_irc_samode]] [command]*`samode`* チャンネルモードを変更、オペレータ権無しに:: ----------------------------------------- +---- /samode <channel> <mode> channel: チャンネル名 mode: チャンネルモード ----------------------------------------- +---- [[command_irc_sanick]] [command]*`sanick`* 強制的にユーザのニックネームを変更:: ----------------------------------------- +---- /sanick <nick> <new_nick> nick: ニックネーム new_nick: 新しいニックネーム ----------------------------------------- +---- [[command_irc_sapart]] [command]*`sapart`* 強制的にユーザをチャンネルから退出:: ----------------------------------------- +---- /sapart <nick> <channel>[,<channel>...] nick: ニックネーム channel: チャンネル名 ----------------------------------------- +---- [[command_irc_saquit]] [command]*`saquit`* ある理由で強制的にユーザをサーバから切断:: ----------------------------------------- +---- /saquit <nick> <reason> nick: ニックネーム reason: 理由 ----------------------------------------- +---- [[command_irc_server]] [command]*`server`* IRC サーバのリストアップ、追加、削除:: ----------------------------------------- +---- /server list|listfull [<server>] add <server> <hostname>[/<port>] [-temp] [-<option>[=<value>]] [-no<option>] copy|rename <server> <new_name> @@ -668,179 +668,179 @@ nooption: ブールオプションを 'off' に設定 (例えば: -nossl) /server rename oftc newoftc /server del freenode /server deloutq ----------------------------------------- +---- [[command_irc_service]] [command]*`service`* 新しいサービスを登録:: ----------------------------------------- +---- /service <nick> <reserved> <distribution> <type> <reserved> <info> distribution: サービスの可視性 type: 将来のために予約 ----------------------------------------- +---- [[command_irc_servlist]] [command]*`servlist`* 現在ネットワークに接続されたサービスをリストアップ:: ----------------------------------------- +---- /servlist [<mask> [<type>]] mask: マスクにマッチするサービスだけをリストアップ type: タイプにマッチするサービスだけをリストアップ ----------------------------------------- +---- [[command_irc_squery]] [command]*`squery`* サービスにメッセージを配送:: ----------------------------------------- +---- /squery <service> <text> service: サービス名 text: 送信テキスト ----------------------------------------- +---- [[command_irc_squit]] [command]*`squit`* サーバリンクを切断:: ----------------------------------------- +---- /squit <server> <comment> server: サーバ名 comment: 切断コメント ----------------------------------------- +---- [[command_irc_stats]] [command]*`stats`* サーバに関するクエリ統計:: ----------------------------------------- +---- /stats [<query> [<server>]] query: c/h/i/k/l/m/o/y/u (RFC1459 を参照) server: サーバ名 ----------------------------------------- +---- [[command_irc_summon]] [command]*`summon`* IRC サーバを実行中のホストにいるユーザ宛てに、IRC に参加することを要請するメッセージを送信:: ----------------------------------------- +---- /summon <user> [<target> [<channel>]] user: ユーザ名 target: サーバ名 channel: チャンネル名 ----------------------------------------- +---- [[command_irc_time]] [command]*`time`* サーバのローカル時間を要求:: ----------------------------------------- +---- /time [<target>] target: 時間を要求するサーバを指定 ----------------------------------------- +---- [[command_irc_topic]] [command]*`topic`* チャンネルトピックの取得/設定:: ----------------------------------------- +---- /topic [<channel>] [<topic>|-delete] channel: チャンネル名 topic: チャンネルに設定する新しいトピック -delete: チャンネルトピックを削除 ----------------------------------------- +---- [[command_irc_trace]] [command]*`trace`* 指定されたサーバへのルートを探す:: ----------------------------------------- +---- /trace [<target>] target: server ----------------------------------------- +---- [[command_irc_unban]] [command]*`unban`* ニックネームかホストの禁止設定を解除:: ----------------------------------------- +---- /unban [<channel>] <nick> [<nick>...] channel: 禁止設定を解除するチャンネル nick: 禁止設定を解除するユーザかホスト ----------------------------------------- +---- [[command_irc_userhost]] [command]*`userhost`* ニックネームに関する情報のリストを返す:: ----------------------------------------- +---- /userhost <nick> [<nick>...] nick: nick ----------------------------------------- +---- [[command_irc_users]] [command]*`users`* サーバにログインしているユーザのリスト:: ----------------------------------------- +---- /users [<target>] target: server ----------------------------------------- +---- [[command_irc_version]] [command]*`version`* ニックネームかサーバのバージョン情報を取得 (現在のサーバか指定したサーバ):: ----------------------------------------- +---- /version [<server>|<nick>] server: サーバ名 nick: ニックネーム ----------------------------------------- +---- [[command_irc_voice]] [command]*`voice`* ニックネームに発言権を付与:: ----------------------------------------- +---- /voice <nick> [<nick>...] nick: ニックネームまたはマスク (ワイルドカード "*" を最初と最後につけることが可能) *: チャンネル参加者全員に voice 権を付与 ----------------------------------------- +---- [[command_irc_wallchops]] [command]*`wallchops`* チャンネルオペレータに notice を送信:: ----------------------------------------- +---- /wallchops [<channel>] <text> channel: チャンネル名 text: 送信テキスト ----------------------------------------- +---- [[command_irc_wallops]] [command]*`wallops`* ユーザモードに 'w' を設定した全ての接続済みユーザ宛てにメッセージを送信:: ----------------------------------------- +---- /wallops <text> text: 送信テキスト ----------------------------------------- +---- [[command_irc_who]] [command]*`who`* 情報のリストを返すクエリを生成:: ----------------------------------------- +---- /who [<mask> [o]] mask: マスクにマッチする情報 o: マスクにマッチするオペレータだけを返す ----------------------------------------- +---- [[command_irc_whois]] [command]*`whois`* ユーザに関する情報を要求:: ----------------------------------------- +---- /whois [<server>] [<nick>[,<nick>...]] server: サーバ名 @@ -849,16 +849,16 @@ server: サーバ名 引数が無い場合、このコマンドは以下のユーザに対する whois を行います: - バッファがサーバ/チャンネルの場合、自分自身のニックネーム - バッファがプライベートの場合、相手のニックネーム。 ----------------------------------------- +---- [[command_irc_whowas]] [command]*`whowas`* 既に存在しないニックネームに関する情報を要求:: ----------------------------------------- +---- /whowas <nick>[,<nick>...] [<count> [<target>]] nick: 検索するニックネーム count: リプライの個数 (負の値で完全な検索) target: マスクに一致するものだけを返す ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/logger_commands.txt b/doc/ja/autogen/user/logger_commands.txt index dab20eaba..7ad6925b4 100644 --- a/doc/ja/autogen/user/logger_commands.txt +++ b/doc/ja/autogen/user/logger_commands.txt @@ -1,7 +1,7 @@ [[command_logger_logger]] [command]*`logger`* logger プラグイン設定:: ----------------------------------------- +---- /logger list set <level> flush @@ -33,5 +33,5 @@ IRC プラグインで使われるログレベル: /set logger.level.core.weechat 0 IRC サーバごとのディレクトリ、チャンネルごとのファイルを使う: /set logger.mask.irc "$server/$channel.weechatlog" ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/lua_commands.txt b/doc/ja/autogen/user/lua_commands.txt index 3193874da..57058642e 100644 --- a/doc/ja/autogen/user/lua_commands.txt +++ b/doc/ja/autogen/user/lua_commands.txt @@ -1,7 +1,7 @@ [[command_lua_lua]] [command]*`lua`* スクリプトをリストアップ/ロード/アンロード:: ----------------------------------------- +---- /lua list|listfull [<name>] load [-q] <filename> autoload @@ -18,5 +18,5 @@ filename: ロードするスクリプト (ファイル) -q: 出力抑制モード: メッセージを表示しない 引数無しの場合、全てのロード済みスクリプトをリストアップします。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/perl_commands.txt b/doc/ja/autogen/user/perl_commands.txt index d143d6357..6d3023e85 100644 --- a/doc/ja/autogen/user/perl_commands.txt +++ b/doc/ja/autogen/user/perl_commands.txt @@ -1,7 +1,7 @@ [[command_perl_perl]] [command]*`perl`* スクリプトをリストアップ/ロード/アンロード:: ----------------------------------------- +---- /perl list|listfull [<name>] load [-q] <filename> autoload @@ -18,5 +18,5 @@ filename: ロードするスクリプト (ファイル) -q: 出力抑制モード: メッセージを表示しない 引数無しの場合、全てのロード済みスクリプトをリストアップします。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/python_commands.txt b/doc/ja/autogen/user/python_commands.txt index 004ac4e01..42bad534a 100644 --- a/doc/ja/autogen/user/python_commands.txt +++ b/doc/ja/autogen/user/python_commands.txt @@ -1,7 +1,7 @@ [[command_python_python]] [command]*`python`* スクリプトをリストアップ/ロード/アンロード:: ----------------------------------------- +---- /python list|listfull [<name>] load [-q] <filename> autoload @@ -18,5 +18,5 @@ filename: ロードするスクリプト (ファイル) -q: 出力抑制モード: メッセージを表示しない 引数無しの場合、全てのロード済みスクリプトをリストアップします。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/relay_commands.txt b/doc/ja/autogen/user/relay_commands.txt index ee7c355d0..6c03dab56 100644 --- a/doc/ja/autogen/user/relay_commands.txt +++ b/doc/ja/autogen/user/relay_commands.txt @@ -1,7 +1,7 @@ [[command_relay_relay]] [command]*`relay`* リレー管理:: ----------------------------------------- +---- /relay list|listfull|listrelay add [ipv4.][ipv6.][ssl.]<protocol.name> <port> del [ipv4.][ipv6.][ssl.]<protocol.name> @@ -42,5 +42,5 @@ protocol.name: リレーするプロトコルと名前: /relay add ipv6.ssl.weechat 9001 SSL を有効にした weechat プロトコル、IPv4 と IPv6 を利用: /relay add ipv4.ipv6.ssl.weechat 9001 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/rmodifier_commands.txt b/doc/ja/autogen/user/rmodifier_commands.txt index f5c94d90e..81631aeb4 100644 --- a/doc/ja/autogen/user/rmodifier_commands.txt +++ b/doc/ja/autogen/user/rmodifier_commands.txt @@ -1,7 +1,7 @@ [[command_rmodifier_rmodifier]] [command]*`rmodifier`* 正規表現で modifier 文字列を変更:: ----------------------------------------- +---- /rmodifier list|listdefault add <name> <modifiers> <groups> <regex> del <name>|-all [<name>...] @@ -27,5 +27,5 @@ listdefault: デフォルトの rmodifier をリストアップ /rmodifier del password 全ての rmodifiers を削除: /rmodifier del -all ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/ruby_commands.txt b/doc/ja/autogen/user/ruby_commands.txt index b53da3eeb..0d2ffabdc 100644 --- a/doc/ja/autogen/user/ruby_commands.txt +++ b/doc/ja/autogen/user/ruby_commands.txt @@ -1,7 +1,7 @@ [[command_ruby_ruby]] [command]*`ruby`* スクリプトをリストアップ/ロード/アンロード:: ----------------------------------------- +---- /ruby list|listfull [<name>] load [-q] <filename> autoload @@ -18,5 +18,5 @@ filename: ロードするスクリプト (ファイル) -q: 出力抑制モード: メッセージを表示しない 引数無しの場合、全てのロード済みスクリプトをリストアップします。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/script_commands.txt b/doc/ja/autogen/user/script_commands.txt index 8cace26f8..5ee951a13 100644 --- a/doc/ja/autogen/user/script_commands.txt +++ b/doc/ja/autogen/user/script_commands.txt @@ -1,7 +1,7 @@ [[command_script_script]] [command]*`script`* WeeChat スクリプトマネージャ:: ----------------------------------------- +---- /script list [-o|-i] search <text> show <script> @@ -73,5 +73,5 @@ toggleautoload: 自動ロードの切り替え /script hold urlserver.py /script reload urlserver /script upgrade ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/tcl_commands.txt b/doc/ja/autogen/user/tcl_commands.txt index a0435c5b6..852e9f178 100644 --- a/doc/ja/autogen/user/tcl_commands.txt +++ b/doc/ja/autogen/user/tcl_commands.txt @@ -1,7 +1,7 @@ [[command_tcl_tcl]] [command]*`tcl`* スクリプトをリストアップ/ロード/アンロード:: ----------------------------------------- +---- /tcl list|listfull [<name>] load [-q] <filename> autoload @@ -18,5 +18,5 @@ filename: ロードするスクリプト (ファイル) -q: 出力抑制モード: メッセージを表示しない 引数無しの場合、全てのロード済みスクリプトをリストアップします。 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/weechat_commands.txt b/doc/ja/autogen/user/weechat_commands.txt index 5f620eecd..a5174ff2d 100644 --- a/doc/ja/autogen/user/weechat_commands.txt +++ b/doc/ja/autogen/user/weechat_commands.txt @@ -1,17 +1,17 @@ [[command_weechat_away]] [command]*`away`* 離席状態の切り替え:: ----------------------------------------- +---- /away [-all] [<message>] -all: 全ての接続済みサーバに対して離席状態を切り替え message: 離席メッセージ (メッセージが無い場合は、離席状態を解除) ----------------------------------------- +---- [[command_weechat_bar]] [command]*`bar`* バーの管理:: ----------------------------------------- +---- /bar list|listfull|listitems add <name> <type>[,<condition>] <position> <size> <separator> <item1>[,<item2>...] default [input|title|status|nicklist] @@ -58,12 +58,12 @@ message: 離席メッセージ (メッセージが無い場合は、離席状態 /bar scroll nicklist * y+10 現在のバッファに対応したニックネームリストを最後までスクロール: /bar scroll nicklist * ye ----------------------------------------- +---- [[command_weechat_buffer]] [command]*`buffer`* バッファの管理:: ----------------------------------------- +---- /buffer list clear [<number>|<name>|-merged|-all] move|merge <number> @@ -120,12 +120,12 @@ localvar: 現在のバッファのローカル変数を表示 /buffer #weechat 次のバッファに移動: /buffer +1 ----------------------------------------- +---- [[command_weechat_color]] [command]*`color`* 色の別名の定義と、カラーパレットの表示:: ----------------------------------------- +---- /color alias <color> <name> unalias <color> reset @@ -145,22 +145,22 @@ unalias: 別名の削除 /color alias 214 orange 色番号 214 を削除: /color unalias 214 ----------------------------------------- +---- [[command_weechat_command]] [command]*`command`* WeeChat かプラグインのコマンドを起動:: ----------------------------------------- +---- /command <plugin> <command> plugin: プラグインの名前 ('weechat' は WeeChat の内部コマンドを意味します) command: 実行するコマンド (コマンドの最初に '/' が無い場合、'/' が自動的に追加されます) ----------------------------------------- +---- [[command_weechat_cursor]] [command]*`cursor`* カーソルを移動してアクションを実行するエリアを指定:: ----------------------------------------- +---- /cursor go chat|<bar>|<x>,<y> move up|down|left|right|area_up|area_down|area_left|area_right stop @@ -178,12 +178,12 @@ stop: カーソルモードを終了 /cursor go nicklist x=10、y=5 の位置に移動: /cursor go 10,5 ----------------------------------------- +---- [[command_weechat_debug]] [command]*`debug`* core やプラグインのデバッグ管理:: ----------------------------------------- +---- /debug list set <plugin> <level> dump [<plugin>] @@ -208,12 +208,12 @@ infolists: infolist に関する情報を表示 tags: 行のタグを表示 term: ターミナルに関する情報を表示 windows: ウィンドウツリーの情報を表示 ----------------------------------------- +---- [[command_weechat_eval]] [command]*`eval`* 式を評価して結果をバッファに送信:: ----------------------------------------- +---- /eval [-n] <expression> [-n] -c <expression1> <operator> <expression2> @@ -266,12 +266,12 @@ hdata と変数の名前については、"プラグイン API リファレン /eval -n -c abcd =~ (?-i)^ABC ==> 0 /eval -n -c abcd =~ (?-i)^abc ==> 1 /eval -n -c abcd !~ abc ==> 0 ----------------------------------------- +---- [[command_weechat_filter]] [command]*`filter`* タグか正規表現に基づくバッファメッセージの非表示/表示:: ----------------------------------------- +---- /filter list enable|disable|toggle [<name>] add <name> <buffer>[,<buffer>...] <tags> <regex> @@ -320,12 +320,12 @@ disable: フィルタを無効化 /filter add toto irc.freenode.#weechat nick_toto * IRC チャンネル #weechat で "weechat sucks" を含む行をフィルタ: /filter add sucks irc.freenode.#weechat * weechat sucks ----------------------------------------- +---- [[command_weechat_help]] [command]*`help`* コマンドとオプションに関するヘルプを表示:: ----------------------------------------- +---- /help -list|-listfull [<plugin> [<plugin>...]] <command> <option> @@ -335,23 +335,23 @@ disable: フィルタを無効化 plugin: このプラグインに関するコマンドをリストアップ command: コマンドの名前 option: オプションの名前 (リストを見るには /set を使用) ----------------------------------------- +---- [[command_weechat_history]] [command]*`history`* バッファコマンド履歴を表示:: ----------------------------------------- +---- /history clear <value> clear: 履歴の削除 value: 表示する履歴エントリの数 ----------------------------------------- +---- [[command_weechat_input]] [command]*`input`* コマンドライン関数:: ----------------------------------------- +---- /input <action> [<arguments>] アクションリスト: @@ -406,12 +406,12 @@ value: 表示する履歴エントリの数 paste_stop: ペーストの終了 (括弧付きペーストモード) これらのコマンドはキーバインドかプラグインで利用できます。 ----------------------------------------- +---- [[command_weechat_key]] [command]*`key`* キーの割り当てと割り当て解除:: ----------------------------------------- +---- /key list|listdefault|listdiff [<context>] bind <key> [<command> [<args>]] bindctxt <context> <key> [<command> [<args>]] @@ -461,12 +461,12 @@ listdefault: デフォルトキーをリストアップ /key bindctxt search ctrl-I /input search_stop ニック上でのマウスのセンターボタンをニックネームの情報取得に割り当てる: /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick} ----------------------------------------- +---- [[command_weechat_layout]] [command]*`layout`* バッファとウィンドウのレイアウトを保存/適用/リセット:: ----------------------------------------- +---- /layout save [<name>] [buffers|windows] apply [<name>] [buffers|windows] leave @@ -484,12 +484,12 @@ buffers: バッファのみに対してレイアウトを保存/適用 (バッ windows: ウィンドウのみに対してレイアウトを保存/適用 (それぞれのウィンドウに表示されるバッファ) 引数無しでは、保存されたレイアウトを表示します。 ----------------------------------------- +---- [[command_weechat_mouse]] [command]*`mouse`* マウス操作:: ----------------------------------------- +---- /mouse enable|disable|toggle [<delay>] enable: マウスの有効化 @@ -504,12 +504,12 @@ disable: マウスの無効化 /mouse enable 5 秒間マウスの有効無効を切り替え: /mouse toggle 5 ----------------------------------------- +---- [[command_weechat_mute]] [command]*`mute`* 静かにコマンドを実行:: ----------------------------------------- +---- /mute [-current | -buffer <name> | -all] command -current: 現在のバッファへの出力を禁止 @@ -527,12 +527,12 @@ disable: マウスの無効化 /mute -current msg * hi! #weechat チャンネルへのメッセージ: /mute -buffer irc.freenode.#weechat msg #weechat hi! ----------------------------------------- +---- [[command_weechat_plugin]] [command]*`plugin`* プラグインの表示/ロード/アンロード:: ----------------------------------------- +---- /plugin list|listfull [<name>] load <filename> [<arguments>] autoload [<arguments>] @@ -550,12 +550,12 @@ disable: マウスの無効化 arguments: ロードするプラグインに与える引数 引数無しでは、ロードされたプラグインをリストアップ。 ----------------------------------------- +---- [[command_weechat_proxy]] [command]*`proxy`* プロキシの管理:: ----------------------------------------- +---- /proxy list add <name> <type> <address> <port> [<username> [<password>]] del <name>|-all @@ -584,34 +584,34 @@ password: パスワード (任意) /proxy add myproxy socks5 sample.host.org 3128 myuser mypass プロキシを削除: /proxy del myproxy ----------------------------------------- +---- [[command_weechat_quit]] [command]*`quit`* WeeChat の終了:: ----------------------------------------- +---- /quit [-yes] [<arguments>] -yes: weechat.look.confirm_quit オプションが有効な場合に必要 arguments: "quit" シグナルと共に送られるテキスト (例えば irc プラグインはサーバに quit メッセージを送る際にこのテキストを使います) ----------------------------------------- +---- [[command_weechat_reload]] [command]*`reload`* ディスクから設定ファイルを再読み込み:: ----------------------------------------- +---- /reload [<file> [<file>...]] file: 再読み込みする設定ファイル (拡張子 ".conf" は不要) 引数無しでは、全てのファイル (WeeChat とプラグイン) が再読み込みされます。 ----------------------------------------- +---- [[command_weechat_repeat]] [command]*`repeat`* 複数回コマンドを実行:: ----------------------------------------- +---- /repeat [-interval <delay>] <count> <command> delay: コマンドの実行間隔 (ミリ秒単位) @@ -623,23 +623,23 @@ command: 実行するコマンド (最初に '/' が無い場合は自動的に 例: 2 ページ分上方向にスクロール: /repeat 2 /window page_up ----------------------------------------- +---- [[command_weechat_save]] [command]*`save`* 設定をファイルに保存:: ----------------------------------------- +---- /save [<file> [<file>...]] file: 保存する設定ファイル (拡張子 ".conf" は不要) 引数無しでは、全てのファイル (WeeChat とプラグイン) が保存されます。 ----------------------------------------- +---- [[command_weechat_secure]] [command]*`secure`* 保護データを管理します (パスワードやプライベートデータは暗号化されて sec.conf ファイルに保存):: ----------------------------------------- +---- /secure passphrase <passphrase>|-delete decrypt <passphrase>|-discard set <name> <value> @@ -676,12 +676,12 @@ Examples: /set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}" alias to ghost the nick "mynick": /alias ghost /eval /msg -server freenode nickserv ghost mynick ${sec.data.freenode} ----------------------------------------- +---- [[command_weechat_set]] [command]*`set`* オプションの設定:: ----------------------------------------- +---- /set [<option> [<value>]] diff [<option> [<option>...]] @@ -706,12 +706,12 @@ option: オプションの名前 (多くのオプションをリストアップ /set diff irc プラグインのオプションの内、変更されたオプションを表示 /set diff irc.* ----------------------------------------- +---- [[command_weechat_unset]] [command]*`unset`* オプションのアンセット/リセット:: ----------------------------------------- +---- /unset <option> option: オプションの名前 ("*" で始めるか終わるかすれば大量のオプションをリセットできます、注意して使用!) @@ -723,12 +723,12 @@ option: オプションの名前 ("*" で始めるか終わるかすれば大量 /unset weechat.look.item_time_format 全ての色関連オプションをリセット: /unset weechat.color.* ----------------------------------------- +---- [[command_weechat_upgrade]] [command]*`upgrade`* サーバとの接続を維持して WeeChat をアップグレード:: ----------------------------------------- +---- /upgrade [<path_to_binary>|-quit] path_to_binary: WeeChat バイナリへのパス (デフォルトは現在のバイナリ) @@ -754,32 +754,32 @@ path_to_binary: WeeChat バイナリへのパス (デフォルトは現在のバ この後、セッションを回復させるには weechat --upgrade を使ってください。 重要: 完全に同一の設定で (*.conf ファイルで) セッションを回復させてください。 "~/.weechat" ディレクトリの内容をコピーすれば異なるマシンで WeeChat のセッションを回復することも可能です。 ----------------------------------------- +---- [[command_weechat_uptime]] [command]*`uptime`* WeeChat 連続稼働時間の表示:: ----------------------------------------- +---- /uptime [-o | -ol] -o: 連続稼働時間を現在のバッファの入力に送る (英語で) -ol: 連続稼働時間を現在のバッファの入力に送る (翻訳済み) ----------------------------------------- +---- [[command_weechat_version]] [command]*`version`* WeeChat のバージョンとコンパイル日時を表示:: ----------------------------------------- +---- /version [-o | -ol] -o: バージョンを現在のバッファの入力に送る (英語で) -ol: バージョンを現在のバッファの入力に送る (翻訳済み) ----------------------------------------- +---- [[command_weechat_wait]] [command]*`wait`* コマンドの実行を予約:: ----------------------------------------- +---- /wait <number>[<unit>] <command> number: 遅延時間 (整数) @@ -799,12 +799,12 @@ command: 実行するコマンド (コマンドが '/' で始まらない場合 /wait 15m /away -all I'm away 2 分後に 'hello' と発言: /wait 2m hello ----------------------------------------- +---- [[command_weechat_window]] [command]*`window`* ウィンドウの操作:: ----------------------------------------- +---- /window list -1|+1|b#|up|down|left|right [-window <number>] <number> @@ -863,5 +863,5 @@ splith と splitv に関しては、pct は新しいウィンドウのパーセ /window scroll -d ウィンドウ #2 を拡大: /window zoom -window 2 ----------------------------------------- +---- diff --git a/doc/ja/autogen/user/xfer_commands.txt b/doc/ja/autogen/user/xfer_commands.txt index ba97c7dab..c21bb7ac5 100644 --- a/doc/ja/autogen/user/xfer_commands.txt +++ b/doc/ja/autogen/user/xfer_commands.txt @@ -1,21 +1,21 @@ [[command_xfer_me]] [command]*`me`* CTCP action をリモートホストに送信:: ----------------------------------------- +---- /me <message> message: 送信メッセージ ----------------------------------------- +---- [[command_xfer_xfer]] [command]*`xfer`* xfer 管理:: ----------------------------------------- +---- /xfer [list|listfull] list: xfer をリストアップ listfull: xfer をリストアップ (詳細) 引数無しでは、xfer リストを含むバッファを開きます。 ----------------------------------------- +---- diff --git a/doc/ja/weechat.1.ja.txt b/doc/ja/weechat.1.ja.txt index f2c97887b..93434a8cb 100644 --- a/doc/ja/weechat.1.ja.txt +++ b/doc/ja/weechat.1.ja.txt @@ -1,11 +1,11 @@ -= WEECHAT(1) = += WEECHAT(1) :doctype: manpage -== 名前 == +== 名前 weechat - 拡張可能なチャットクライアント -== 書式 == +== 書式 [verse] 'weechat' [-a|--no-connect] [-d|--dir <path>] [-p|--no-plugin] [-r|--run-command <command>] [-s|--no-script] [--upgrade] [plugin:option...] @@ -15,18 +15,18 @@ weechat - 拡張可能なチャットクライアント 'weechat' [-l|--license] 'weechat' [-v|--version] -== 説明 == +== 説明 WeeChat は高速、軽量、拡張可能なチャットクライアントです。 モジュール式 (プラグインを持つ軽量なコア)、マルチプロトコル (IRC と Jabber)、 C 言語と様々なプログラミング言語で書かれたスクリプトを使って拡張可能です。 -== オプション == +== オプション include::cmdline_options.ja.txt[] -== プラグインオプション == +== プラグインオプション プラグインオプションに関する完全な文書は http://weechat.org/doc[WeeChat ユーザーガイド] のプラグインリファレンスを参照してください。 @@ -44,7 +44,7 @@ IPv6 アドレスの後にポートを指定するには IPv6 irc://mynick@[2001:db8:0:85a3::ac1f:8001]:6668/#test -== ファイル == +== ファイル $HOME/.weechat/weechat.conf:: WeeChat の主設定ファイル @@ -82,7 +82,7 @@ $HOME/.weechat/xfer.conf:: $HOME/.weechat/weechat.log:: WeeChat ログファイル -== 著者 == +== 著者 WeeChat は Sébastien Helleu さんと貢献者によって作成されています (完全なリストは AUTHORS ファイルを参照してください)。 @@ -97,7 +97,7 @@ GNU 一般公衆利用許諾契約書 (バージョン2か、希望によって Web: <http://weechat.org/> -== バグ報告 == +== バグ報告 バグの報告や機能追加のリクエストは Savannah ウェブサイトで行なってください: diff --git a/doc/ja/weechat_faq.ja.txt b/doc/ja/weechat_faq.ja.txt index 4b1960afa..cecd4df68 100644 --- a/doc/ja/weechat_faq.ja.txt +++ b/doc/ja/weechat_faq.ja.txt @@ -1,4 +1,4 @@ -= WeeChat FAQ (よくある質問) = += WeeChat FAQ (よくある質問) Sébastien Helleu <flashcode@flashtux.org> @@ -8,10 +8,10 @@ Sébastien Helleu <flashcode@flashtux.org> [[general]] -== 一般 == +== 一般 [[weechat_name]] -=== "WeeChat" という名前の由来は何ですか? === +=== "WeeChat" という名前の由来は何ですか? "Wee" は再帰的頭字語で、"Wee Enhanced Environment" の略です。 そのため、完全な名前は "Wee Enhanced Environment for Chat" です。 @@ -20,17 +20,17 @@ Sébastien Helleu <flashcode@flashtux.org> その他の意味もありますが、それは WeeChat とは関係ありませんよ!)。 [[why_choose_weechat]] -=== WeeChat を選ぶ理由は何ですか? X-Chat や Irssi は最高なのに... === +=== WeeChat を選ぶ理由は何ですか? X-Chat や Irssi は最高なのに... WeeChat は非常に軽く、革新的な機能を備えているからです。 こののページに関するより詳しい情報: http://weechat.org/about/features [[compilation_install]] -== コンパイル / インストール == +== コンパイル / インストール [[gui]] -=== WeeChat には多くの GUI があると聞きました。コンパイル/利用方法を教えてください。 === +=== WeeChat には多くの GUI があると聞きました。コンパイル/利用方法を教えてください。 いくつかのリモート GUI を使うことができます: @@ -40,7 +40,7 @@ WeeChat は非常に軽く、革新的な機能を備えているからです。 * https://github.com/eirikb/weecloud[weecloud] (Web) [[compile_git]] -=== git リポジトリをクローンした後に WeeChat をコンパイルできません。 === +=== git リポジトリをクローンした後に WeeChat をコンパイルできません。 WeeChat をコンパイルするには cmake を使うことが推奨されています。 @@ -53,7 +53,7 @@ autotools を使って (cmake を使わずに) コンパイルする場合、 アップデートをインストールする場合には git をクローンする方法よりも不便であることに注意してください。 [[lost]] -=== WeeChat を起動しました。でも何をすればいいかわかりません。 === +=== WeeChat を起動しました。でも何をすればいいかわかりません。 ヘルプを見るには、`/help` と入力してください。コマンドに関するヘルプを見るには、`/help command` と入力してください。 キーとコマンドはドキュメント内にリストアップされています。 @@ -62,10 +62,10 @@ autotools を使って (cmake を使わずに) コンパイルする場合、 (ウェブサイトのドキュメントページを参照)。 [[display]] -== 表示 == +== 表示 [[charset]] -=== いくつかの文字が見えません。どうすれば良いですか。 === +=== いくつかの文字が見えません。どうすれば良いですか。 これは良くある問題です。以下の内容をよく読んで、*全ての* 解決策をチェックしてください: @@ -92,7 +92,7 @@ WeeChat は UTF-8 ロケールを推奨します。ISO 又はその他のロケ UTF-8 *でない* ことを確認してください。 [[bars_background]] -=== タイトルやステータスバー等の背景色が行末ではなくテキストの最後で終わってしまいます。 === +=== タイトルやステータスバー等の背景色が行末ではなくテキストの最後で終わってしまいます。 シェルの TERM 変数に間違った値が設定されている可能性があります (ターミナルで `echo $TERM` の出力を確認してください)。 @@ -107,7 +107,7 @@ WeeChat を起動した場所に依存しますが、以下の値を持つはず もし必要であれば、TERM 変数を修正してください: `export TERM="xxx"` [[screen_weird_chars]] -=== weechat を screen/tmux の中で使っている場合、おかしなランダム文字列が表示されます。どうすれば直りますか。 === +=== weechat を screen/tmux の中で使っている場合、おかしなランダム文字列が表示されます。どうすれば直りますか。 シェルの TERM 変数に間違った値が設定されている可能性があります。 (ターミナル、*screen/tmux の外* で `echo $TERM` の出力を確認してください)。 @@ -118,7 +118,7 @@ WeeChat を起動した場所に依存しますが、以下の値を持つはず もし必要であれば、TERM 変数を修正してください: `export TERM="xxx"` [[osx_display_broken]] -=== OS X 上で WeeChat をコンパイルした場合、"(null)" という文字列が至る所に表示されます。 === +=== OS X 上で WeeChat をコンパイルした場合、"(null)" という文字列が至る所に表示されます。 ncursesw を自分でコンパイルした場合は、標準の (システムに元から存在する) ncurses を使ってみてください。 @@ -127,7 +127,7 @@ ncurses を使ってみてください。 WeeChat をインストールすることをお勧めします。 [[buffer_vs_window]] -=== "バッファ" と "ウィンドウ" の違いは何ですか。 === +=== "バッファ" と "ウィンドウ" の違いは何ですか。 'バッファ' とは番号、名前、表示行、(とその他のデータ) からなります。 @@ -139,39 +139,39 @@ WeeChat をインストールすることをお勧めします。 (ウィンドウで表示させない) ことや 1 つ以上のウィンドウに表示させることも出来ます。 [[buffers_list]] -=== どうすれば左側にバッファリストを表示できますか。 === +=== どうすれば左側にバッファリストを表示できますか。 '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' @@ -179,69 +179,69 @@ WeeChat をインストールすることをお勧めします。 動的サイズを設定する例: ----------------------------------------- +---- /set weechat.bar.input.size 0 ----------------------------------------- +---- サイズの最大値を 2 に設定: ----------------------------------------- +---- /set weechat.bar.input.size_max 2 ----------------------------------------- +---- [[one_input_root_bar]] -=== 全てのウィンドウに対して入力バーの数を 1 つだけにすることができますか (画面分割されている場合)。 === +=== 全てのウィンドウに対して入力バーの数を 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]] -=== どうすればニックネームリストを選択せずにテキストだけをコピー/ペーストできますか。 === +=== どうすればニックネームリストを選択せずにテキストだけをコピー/ペーストできますか。 矩形選択のできるターミナルを使ってください (rxvt-unicode、 konsole、gnome-terminal、...)。通常、キーは @k(C-)@k(A-) マウス選択です。 別の解決策はニックネームリストを上か下かに移動することです、例えば: ----------------------------------------- +---- /set weechat.bar.nicklist.position top ----------------------------------------- +---- [[urls]] -=== どうすれば長い (一行以上に渡る) URL をクリックできますか。 === +=== どうすれば長い (一行以上に渡る) URL をクリックできますか。 デフォルトでは、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] このオプションには表示上の問題を引き起こす可能性があります。 @@ -250,21 +250,21 @@ WeeChat ≥ 0.3.6 では、"eat_newline_glitch" オプションを有効化で 別の解決策として、スクリプトを利用することもできます: http://weechat.org/scripts/stable/tag/url [[change_locale_without_quit]] -=== WeeChat が出力するメッセージの言語を、再起動せずに変更したいです。このようなことは可能ですか。 === +=== WeeChat が出力するメッセージの言語を、再起動せずに変更したいです。このようなことは可能ですか。 可能です。python スクリプト 'shell.py' (WeeChat ウェブサイトから入手可能) を使い、 スクリプトを読み込んだら以下のコマンドを打ってください。 ----------------------------------------- +---- /shell setenv LANG=en_US.UTF-8 /upgrade ----------------------------------------- +---- UTF-8 エンコードされた英語メッセージが表示されるようになります、 ISO ユーザは以下のようにして下さい: `/shell setenv LANG=en_US` [[use_256_colors]] -=== どうすれば WeeChat で 256 色が使えますか。 === +=== どうすれば WeeChat で 256 色が使えますか。 256 色は WeeChat ≥ 0.3.4 でサポートされます。 @@ -280,17 +280,17 @@ ISO ユーザは以下のようにして下さい: `/shell setenv LANG=en_US` screen を使っている場合は、以下の行を '~/.screenrc' に追加してください: ----------------------------------------- +---- term screen-256color ----------------------------------------- +---- 'TERM' 変数の設定に間違いがあり、WeeChat が起動中の場合でも、 慌てないでください! 'shell.py' を使えば再起動せずに環境変数を変更できます。 ----------------------------------------- +---- /shell setenv TERM=screen-256color /upgrade ----------------------------------------- +---- バージョン 0.3.4 では、新しい色を追加するには `/color` コマンドを使ってください。 @@ -300,7 +300,7 @@ term screen-256color 色管理に関するより詳しい情報はユーザーガイドを読んでください。 [[search_text]] -=== どうすればバッファ内の文字列を検索できますか (irssi の /lastlog の様に)。 === +=== どうすればバッファ内の文字列を検索できますか (irssi の /lastlog の様に)。 デフォルトのキーは @k(C-)@k(r) です (コマンドは: `/input search_text`)。 ハイライト部分へのジャンプは: @k(A-)@k(p)/@k(n) @@ -308,76 +308,76 @@ term screen-256color この機能に関するより詳しい情報はユーザーガイドを参照してください (デフォルトのキー割り当て)。 [[key_bindings]] -== キー割り当て == +== キー割り当て [[meta_keys]] -=== いくつかのメタキーが (alt + key) が動きません。 === +=== いくつかのメタキーが (alt + key) が動きません。 xterm や uxterm 等のターミナルを利用している場合、いくつかのメタキーはデフォルトでは利用できません。 以下の行を '~/.Xresources' に追加してください: * xterm の場合: ----------------------------------------- +---- XTerm*metaSendsEscape: true ----------------------------------------- +---- * uxterm の場合: ----------------------------------------- +---- UXTerm*metaSendsEscape: true ----------------------------------------- +---- このファイルを再読み込みするか (`xrdb -override ~/.Xresources`) 又は X を再起動してください。 [[customize_key_bindings]] -=== どうすればキー割り当てをカスタマイズできますか。 === +=== どうすればキー割り当てをカスタマイズできますか。 キー割り当ては `/key` コマンドでカスタマイズできます。 デフォルトキー @k(A-)@k(k) でキーコードを取り込み、これをコマンドラインに入力できます。 [[jump_to_buffer_11_or_higher]] -=== バッファ 11 番 (又はそれ以上の番号) にジャンプするキーは何ですか。 === +=== バッファ 11 番 (又はそれ以上の番号) にジャンプするキーは何ですか。 キー @k(A-)@k(j) の後に 2 桁の数字を入力します、例えば @k(A-)@k(j) その後に @k(1)、 @k(1) でバッファ 11 番にジャンプします。 これにキーを割り当てることが出来ます、例えば: ----------------------------------------- +---- /key bind meta-q /buffer *11 ----------------------------------------- +---- デフォルトキー割り当てのリストはユーザーガイドを参照してください。 [[global_history]] -=== どうすればグローバルヒストリを (バッファヒストリの代わりに) 上下矢印キーで使えますか。 === +=== どうすればグローバルヒストリを (バッファヒストリの代わりに) 上下矢印キーで使えますか。 上下矢印キーをグローバルヒストリに割り当ててください (グローバルヒストリに対する デフォルトのキーは @k(C-)@k(↑) と @k(C-)@k(↓) です。 例: ----------------------------------------- +---- /key bind meta2-A /input history_global_previous /key bind meta2-B /input history_global_next ----------------------------------------- +---- [NOTE] "meta2-A" と "meta2-B" キーはターミナルによって異なります。 キーコードを 見つけるには @k(A-)@k(k) の後にキー (上矢印又は下矢印) を押してください。 [[mouse]] -== マウス == +== マウス [[mouse_not_working]] -=== マウスが少しも動きません。どうすれば良いですか。 === +=== マウスが少しも動きません。どうすれば良いですか。 マウスのサポートは WeeChat 0.3.6 以上からです。 最初にマウスを有効化してください: ----------------------------------------- +---- /mouse enable ----------------------------------------- +---- これでマウスが動かない場合は、シェルの TERM 変数を確認してください (ターミナル内で `echo $TERM` の出力を見てください)。 @@ -385,20 +385,20 @@ UXTerm*metaSendsEscape: true マウスサポートをターミナルから確認するには: ----------------------------------------- +---- $ printf '\033[?1002h' ----------------------------------------- +---- ターミナルの最初の文字 (左上) をクリックしてください。" !!#!!" と見えるはずです。 ターミナルのマウスサポートを無効化するには: ----------------------------------------- +---- $ printf '\033[?1002l' ----------------------------------------- +---- [[mouse_coords]] -=== マウスの位置座標 X 又は Y が 94 よりも大きい場合にマウス機能が正しく動きません。 === +=== マウスの位置座標 X 又は Y が 94 よりも大きい場合にマウス機能が正しく動きません。 一部のターミナルではマウスの位置座標を指定するために ISO 文字だけを使います、 このため X/Y が 94 よりも大きい場合は正しく動きません。 @@ -407,49 +407,49 @@ $ printf '\033[?1002l' 例えば rxvt-unicode 等です。 [[mouse_select_paste]] -=== WeeChat でマウスが利用可能な場合、ターミナルのテキストを選択したり、貼り付けるにはどうすれば良いですか。 === +=== WeeChat でマウスが利用可能な場合、ターミナルのテキストを選択したり、貼り付けるにはどうすれば良いですか。 WeeChat でマウスが利用可能な場合、@k(-S-) キーを押しながらターミナルをクリックして選択してください、 マウスが無効化されます (例えば iTerm 等の場合、@k(-S-) の代わりに @k(-A-) を使ってください)。 [[irc]] -== IRC == +== IRC [[irc_ssl_connection]] -=== SSL を使うサーバへの接続中に問題が発生しました。どうすればいいですか。 === +=== SSL を使うサーバへの接続中に問題が発生しました。どうすればいいですか。 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" というエラーだけが表示されます。どうすれば良いですか。 === +=== 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 サーバに接続できますか。 === +=== どうすれば SSL を使って freenode サーバに接続できますか。 オプション 'weechat.network.gnutls_ca_file' に証明書ファイルへのパスを設定してください。 ----------------------------------------- +---- /set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt" ----------------------------------------- +---- [NOTE] 設定したファイルが自分のシステムに存在することを確認してください @@ -457,15 +457,15 @@ gnutls ハンドシェイクに関するエラーの場合、Diffie-Hellman キ サーバポート、SSL、dhkey_size を設定の後に接続してください: ----------------------------------------- +---- /set irc.server.freenode.addresses "chat.freenode.net/7000" /set irc.server.freenode.ssl on /set irc.server.freenode.ssl_dhkey_size 1024 /connect freenode ----------------------------------------- +---- [[irc_oauth]] -=== どうすれば "oauth" が必要なサーバに接続出来ますか? === +=== どうすれば "oauth" が必要なサーバに接続出来ますか? 'twitch' などの一部のサーバは接続するために oauth が必要です。 @@ -474,32 +474,32 @@ oauth を使うにはパスワードを "oauth:XXXX" のように指定してく 以下のコマンドでサーバを作成し、接続することができます (名前とアドレスは適当な値に変更してください): ----------------------------------------- +---- /server add name irc.server.org -password="oauth:XXXX" /connect name ----------------------------------------- +---- [[irc_sasl]] -=== どうすればチャンネル参加前にニックネーム認証を行うことができますか。 === +=== どうすればチャンネル参加前にニックネーム認証を行うことができますか。 サーバで SASL を利用可能なら、nickserv 認証のコマンドを送信するよりも SASL を利用する方が良いです。例えば: ----------------------------------------- +---- /set irc.server_default.sasl_mechanism dh-blowfish /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 と /filter コマンドの違いは何ですか。 `/ignore` コマンドは IRC コマンドです、このため IRC バッファ (サーバとチャンネル) にのみ有効です。 @@ -515,35 +515,35 @@ of channels): フィルタを無効化すれば見えるようになります (デフォルトでは @k(A-)@k(=) でフィルタの有効無効の切り替えが出来ます)。 [[filter_irc_join_part_quit]] -=== どうすれば IRC チャンネルへの参加/退出/終了メッセージをフィルタできますか。 === +=== どうすれば 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 チャンネルに参加した際に表示される一部のメッセージをフィルタできますか。 === +=== どうすれば IRC チャンネルに参加した際に表示される一部のメッセージをフィルタできますか。 WeeChat ≥ 0.4.1 では、オプション 'irc.look.display_join_message' を使って一部のメッセージを隠すことができます。 例えば、ニックネームリストを隠すには (この IRC メッセージの番号は '366'): ----------------------------------------- +---- /set irc.look.display_join_message "329,332,333" ----------------------------------------- +---- [NOTE] ヘルプを見るには: `/help irc.look.display_join_message` @@ -560,16 +560,16 @@ IRC 生サーバ (`/server raw`) を参照することで、 例: * 名前をフィルタ: ----------------------------------------- +---- /filter add irc_join_names * irc_366 * ----------------------------------------- +---- * トピック (と日時) をフィルタ: ----------------------------------------- +---- /filter add irc_join_topic_date * irc_332,irc_333 * ----------------------------------------- +---- [[filter_voice_messages]] -=== どうすれば voice メッセージをフィルタできますか (例えば Bitlbee サーバ上で)。 === +=== どうすれば voice メッセージをフィルタできますか (例えば Bitlbee サーバ上で)。 voice メッセージをフィルタするのは簡単ではありません、なぜなら voice モードの設定は同じ IRC メッセージの中で他のモード設定と同時に行われる可能性があるからです。 @@ -580,15 +580,15 @@ voice メッセージでチャットエリアが溢れてしまうから、こ Bitlbee 3 以上の場合、以下のコマンドをチャンネル '&bitlbee' で入力: ----------------------------------------- +---- channel set show_users online,away ----------------------------------------- +---- Bitlbee の古いバージョンでは、以下のコマンドを '&bitlbee' で入力: ----------------------------------------- +---- set away_devoice false ----------------------------------------- +---- WeeChat で離席中のニックネームをチェックするには、 <<color_away_nicks,離席状態のニックネーム>> に関する質問を参照してください。 @@ -596,12 +596,12 @@ WeeChat で離席中のニックネームをチェックするには、 もし本当に voice メッセージをフィルタしたい場合は、以下のコマンドを使ってください、 ただしこれは完璧なものではありません (voice モードの変更が最初に指定されている場合のみ有効)。 ----------------------------------------- +---- /filter add hidevoices * irc_mode (\+|\-)v ----------------------------------------- +---- [[color_away_nicks]] -=== どうすればニックネームリストから離席中のニックネームを確認できますか。 === +=== どうすればニックネームリストから離席中のニックネームを確認できますか。 オプション 'irc.server_default.away_check' に正の値を設定してください (離席状態確認のインターバルを分単位で)。 @@ -612,50 +612,50 @@ WeeChat で離席中のニックネームをチェックするには、 例えば、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]] -=== どうすればあるチャンネルで自分が呼ばれたら警告できますか。 === +=== どうすればあるチャンネルで自分が呼ばれたら警告できますか。 'beep.pl' や 'launcher.pl' 等のスクリプトを使ってください。 'launcher.pl' の場合、コマンドの設定が必要です: ----------------------------------------- +---- /set plugins.var.perl.launcher.signal.weechat_highlight "/path/to/command arguments" ----------------------------------------- +---- この問題に対するその他のスクリプトは: http://weechat.org/scripts/stable/tag/notify/ [[irc_target_buffer]] -=== どうすればマージされたバッファ内であるコマンドを発行するターゲットバッファを変更できますか。 === +=== どうすればマージされたバッファ内であるコマンドを発行するターゲットバッファを変更できますか。 デフォルトのキーは @k(C-)@k(x) です (コマンドは: `/input switch_active_buffer`)。 [[plugins_scripts]] -== プラグイン / スクリプト == +== プラグイン / スクリプト [[openbsd_plugins]] -=== OpenBSD と WeeChat を使っている場合、プラグインが 1 つもロードされません。 === +=== OpenBSD と WeeChat を使っている場合、プラグインが 1 つもロードされません。 OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Linux では ".so")。 以下の様に設定してください: ----------------------------------------- +---- /set weechat.plugin.extension ".so.0.0" /plugin autoload ----------------------------------------- +---- [[load_scripts]] -=== どうすれば Perl/Python/Ruby/Lua/Tcl スクリプトをロードできますか。スクリプトは他の IRC クライアントのものと互換性がありますか。 === +=== どうすれば Perl/Python/Ruby/Lua/Tcl スクリプトをロードできますか。スクリプトは他の IRC クライアントのものと互換性がありますか。 `/perl` 、`/python` 、`/ruby` 、`/lua` 、`/tcl` コマンドを使ってスクリプトをロードしてください (スクリプトのデフォルトパスは '~/.weechat/<language>/' )。 @@ -669,10 +669,10 @@ OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Li * 'tcl' プラグインはバージョン 0.3.0 以上で利用できます。 [[settings]] -== 設定 == +== 設定 [[memory_usage]] -=== どうすれば WeeChat のメモリ使用量を節約できますか。 === +=== どうすれば WeeChat のメモリ使用量を節約できますか。 メモリ使用量を減らすには以下のヒントを試してください: @@ -688,10 +688,10 @@ OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Li * 'weechat.history.max_commands' オプションの値を減らしてください。 [[development]] -== 開発 == +== 開発 [[bug_task_patch]] -=== どのようにバグ報告、新機能のリクエスト、パッチ送信すればよいですか。 === +=== どのようにバグ報告、新機能のリクエスト、パッチ送信すればよいですか。 3 つの方法があります: @@ -705,27 +705,27 @@ OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Li ("support" メーリングリストを購読して送信することもできます) [[gdb_error_threads]] -=== gdb で WeeChat を実行する場合、スレッドに関するエラーが発生します。 === +=== 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 をサポートするプラットフォームのリストを教えてください。他のオペレーティングシステムへの移植予定はありますか。 === +=== WeeChat をサポートするプラットフォームのリストを教えてください。他のオペレーティングシステムへの移植予定はありますか。 完全なリストはこのページにあります: http://weechat.org/download @@ -733,7 +733,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat 我々が持っていない OS で WeeChat をテストすることを歓迎します。 [[help_developers]] -=== どうすれば WeeChat 開発者を手伝えますか。 === +=== どうすれば WeeChat 開発者を手伝えますか。 多くの課題があります (テスト、コード、ドキュメント作成、...)。 @@ -741,7 +741,7 @@ IRC かメールで連絡を取り、サポートページを確認してくだ http://weechat.org/dev/support [[donate]] -=== WeeChat 開発者にお金か何かを贈りたいのですが。 === +=== WeeChat 開発者にお金か何かを贈りたいのですが。 開発補助のためお金を贈ることができます。 詳しいことは http://weechat.org/about/donate に載っています。 diff --git a/doc/ja/weechat_quickstart.ja.txt b/doc/ja/weechat_quickstart.ja.txt index 59d294052..86bf18a61 100644 --- a/doc/ja/weechat_quickstart.ja.txt +++ b/doc/ja/weechat_quickstart.ja.txt @@ -1,40 +1,40 @@ -= WeeChat クイックスタートガイド = += WeeChat クイックスタートガイド Sébastien Helleu <flashcode@flashtux.org> [[start]] -== WeeChat を起動 == +== WeeChat を起動 X 用ターミナルエミュレータは rxvt-unicode を推奨します (UTF-8 がサポートされており、デフォルトのキーバインドで問題が発生しないためです)。 シェルから起動するには: ----------------------------------------- +---- $ weechat ----------------------------------------- +---- [[help_options]] -== オンラインヘルプ / オプション == +== オンラインヘルプ / オプション WeeChat はすべてのコマンドにヘルプがあります。ヘルプを見るには、以下のコマンドを入力してください: ----------------------------------------- +---- /help ----------------------------------------- +---- 特定のコマンドに対するヘルプを見るには、以下のコマンドを入力してください: ----------------------------------------- +---- /help command ----------------------------------------- +---- オプションを設定するには以下のコマンドを入力してください: ----------------------------------------- +---- /set config.section.option value ----------------------------------------- +---- (ここで `config` は設定名 (core の場合は `weechat` もしくはプラグイン名)、`section` @@ -49,27 +49,27 @@ WeeChat を再起動する必要は*ありません*)。 * 全ての設定名を表示します (WeeChat およびプラグイン) ----------------------------------------- +---- /set ----------------------------------------- +---- * WeeChat のオプションを表示します ----------------------------------------- +---- /set weechat.* ----------------------------------------- +---- * IRC プラグインのオプションを表示します ----------------------------------------- +---- /set irc.* ----------------------------------------- +---- `/help` とオプション名を指定することでヘルプを表示できます、例: ----------------------------------------- +---- /help weechat.look.highlight ----------------------------------------- +---- すべての設定は WeeChat の終了時 (または強制的に設定保存を行う `/save` コマンドを使用した場合) に保存されます。 @@ -79,7 +79,7 @@ WeeChat を再起動する必要は*ありません*)。 [[core_vs_plugins]] -== コア vs プラグイン == +== コア vs プラグイン WeeChat の "core" にはユーザインタフェースに関わるものだけが含まれているため、 プラグインがなければ使い物になりません (以前からのユーザーへ: IRC @@ -92,23 +92,23 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ [[create_irc_server]] -== サーバ情報を作成する == +== サーバ情報を作成する `/server` コマンドで IRC サーバを追加できます。例: ----------------------------------------- +---- /server add oftc irc.oftc.net/6667 ----------------------------------------- +---- 書式が思い出せない場合はヘルプを利用してください: ----------------------------------------- +---- /help server ----------------------------------------- +---- [[irc_server_options]] -== IRC サーバのオプションを設定する == +== IRC サーバのオプションを設定する もしサーバオプションが特に設定されていない場合、WeeChat はデフォルト設定をすべてのサーバに適用します @@ -120,69 +120,69 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ 例えばデフォルトでは (un*x ログイン名をベースにした) ニックネームが設定されますが、以下のコマンドで oftc サーバ用の設定として上書きすることが可能です: ----------------------------------------- +---- /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5" ----------------------------------------- +---- ユーザ名と実名を設定する場合: ----------------------------------------- +---- /set irc.server.oftc.username "My user name" /set irc.server.oftc.realname "My real name" ----------------------------------------- +---- サーバへの自動接続を設定する場合: ----------------------------------------- +---- /set irc.server.oftc.autoconnect on ----------------------------------------- +---- サーバで SASL を利用可能な場合、SASL を利用してニックネーム認証することができます (チャンネル参加前にニックネーム認証が行われるでしょう): ----------------------------------------- +---- /set irc.server_default.sasl_mechanism dh-blowfish /set irc.server.oftc.sasl_username "mynick" /set irc.server.oftc.sasl_password "xxxxxxx" ----------------------------------------- +---- 例えば nickserv との認証などを行うためにサーバ接続後にコマンドを実行するには (SASL を利用して認証を行わない場合): ----------------------------------------- +---- /set irc.server.oftc.command "/msg nickserv identify xxxxxxx" ----------------------------------------- +---- [NOTE] ';' (セミコロン) で繋ぐことで複数のコマンドを設定することができます チャンネルへの自動参加を設定する場合: ----------------------------------------- +---- /set irc.server.oftc.autojoin "#channel1,#channel2" ----------------------------------------- +---- サーバオプションの代わりにデフォルトの値を使用する、例えばデフォルトのニックネーム (irc.server_default.nicks) を使用する場合: ----------------------------------------- +---- /set irc.server.oftc.nicks null ----------------------------------------- +---- その他設定: その他のオプションも以下のコマンドで設定できます ("xxx" は設定名です): ----------------------------------------- +---- /set irc.server.oftc.xxx value ----------------------------------------- +---- [[connect_to_irc_server]] -== サーバに接続し、チャンネルに自動接続する == +== サーバに接続し、チャンネルに自動接続する ----------------------------------------- +---- /connect oftc ----------------------------------------- +---- [NOTE] このコマンドは、`/server` @@ -195,35 +195,35 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ サーババッファへの自動マージを無効にして 独立したサーババッファにすることができます: ----------------------------------------- +---- /set irc.look.server_buffer independent ----------------------------------------- +---- [[join_part_irc_channels]] -== チャンネルに接続 / 切断する == +== チャンネルに接続 / 切断する チャンネルに接続する ----------------------------------------- +---- /join #channel ----------------------------------------- +---- チャンネルから切断する (バッファは開いたままにする) ----------------------------------------- +---- /part [切断メッセージ] ----------------------------------------- +---- チャンネルから切断し、バッファを閉じる (`/close` は `/buffer close` の別名) ----------------------------------------- +---- /close ----------------------------------------- +---- [[buffer_window]] -== バッファ / ウィンドウ管理 == +== バッファ / ウィンドウ管理 バッファは番号、カテゴリおよび名前とともにプラグインに関連づけられたあるコンポーネントです。 バッファは画面に表示するデータを含んでいます。 @@ -234,23 +234,23 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ バッファ / ウィンドウを管理するためのコマンド: ----------------------------------------- +---- /buffer /window ----------------------------------------- +---- (言うまでもありませんが /help でこれらのコマンドもヘルプを確認することができます) 例えば、ウィンドウを垂直方向に小さいウィンドウ (1/3 幅) と大きいウィンドウ (2/3 幅) に分割する場合は次のコマンドを実行します: ----------------------------------------- +---- /window splitv 33 ----------------------------------------- +---- [[key_bindings]] -== キー割り当て設定 == +== キー割り当て設定 WeeChat はデフォルトでたくさんのショートカットキーが設定されています。 これらはドキュメントに記載されていますが、いくつか重要なキーがあります: @@ -269,25 +269,25 @@ WeeChat はデフォルトでたくさんのショートカットキーが設定 例えば、meta-y (alt-y) に `/buffer close` を割り当てる場合: ----------------------------------------- +---- /key bind (meta-kを押下) (meta-yを押下) /buffer close ----------------------------------------- +---- コマンドラインには以下のように表示されます: ----------------------------------------- +---- /key bind meta-y /buffer close ----------------------------------------- +---- キー割り当てを解除する場合: ----------------------------------------- +---- /key unbind meta-y ----------------------------------------- +---- [[plugins_scripts]] -== プラグイン / スクリプト == +== プラグイン / スクリプト Debian のようにいくつかのディストリビューションでは、プラグイン用パッケージが独立して用意されています (例えば weechat-plugins)。 @@ -302,7 +302,7 @@ WeeChat ではコマンド `/script` を使うことで、スクリプトの管 [[more_doc]] -== 詳しいドキュメント情報 == +== 詳しいドキュメント情報 FAQ やその他の質問に関するドキュメントはこちらで参照できます: http://weechat.org/doc diff --git a/doc/ja/weechat_scripting.ja.txt b/doc/ja/weechat_scripting.ja.txt index a0d7a63de..f02e0d7ee 100644 --- a/doc/ja/weechat_scripting.ja.txt +++ b/doc/ja/weechat_scripting.ja.txt @@ -1,4 +1,4 @@ -= WeeChat スクリプト製作ガイド = += WeeChat スクリプト製作ガイド Sébastien Helleu <flashcode@flashtux.org> @@ -9,7 +9,7 @@ http://weechat.org/doc [[introduction]] -== イントロダクション == +== イントロダクション WeeChat (Wee Enhanced Environment for Chat) はフリー、高速、軽量な 多くのオペレーティングシステムで動くチャットクライアントです。 @@ -29,23 +29,23 @@ WeeChat (Wee Enhanced Environment for Chat) はフリー、高速、軽量な で書かれていますが API は他の言語でも共通です。 [[scripts_in_weechat]] -== WeeChat のスクリプト == +== WeeChat のスクリプト [[languages_specifities]] -=== 言語仕様 === +=== 言語仕様 -==== Python ==== +==== Python * `import weechat` を使うことは必須です。 * python では `print*` 系の関数は `prnt*` と呼ばれます ('print' は予約済みキーワードなので)。 * 関数は `weechat.xxx(arg1, arg2, ...)` のように呼び出してください。 -==== Perl ==== +==== Perl * 関数は `weechat::xxx(arg1, arg2, ...);` のように呼び出してください。 -==== Ruby ==== +==== Ruby * 'weechat_init' を定義して、内部で 'register' を呼び出してください。 * 関数は `Weechat.xxx(arg1, arg2, ...)` のように呼び出してください。 @@ -54,20 +54,20 @@ WeeChat (Wee Enhanced Environment for Chat) はフリー、高速、軽量な + 3 個のデータ文字列)、したがって `Weechat.config_new_option` 関数を呼び出すには以下のようにしてください: [source,ruby] ----------------------------------------- +---- Weechat.config_new_option(config, section, "name", "string", "description of option", "", 0, 0, "value", "value", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""]) ----------------------------------------- +---- -==== Lua ==== +==== Lua * 関数は `weechat.xxx(arg1, arg2, ...)` のように呼び出してください。 -==== Tcl ==== +==== Tcl * 関数は `weechat::xxx arg1 arg2 ...` のように呼び出してください。 -==== Guile (scheme) ==== +==== Guile (scheme) * 関数は `(weechat:xxx arg1 arg2 ...)` のように呼び出してください。 * 以下の関数は引数のリストをひとつだけ取ります。 @@ -78,7 +78,7 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt ** bar_new [[register_function]] -=== 関数の登録 === +=== 関数の登録 全ての WeeChat スクリプトは WeeChat に自分自身を "登録" し、登録はスクリプトの最初で行われなければいけません。 @@ -86,9 +86,9 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt プロトタイプ: [source,python] ----------------------------------------- +---- weechat.register(name, author, version, license, description, shutdown_function, charset) ----------------------------------------- +---- 引数: @@ -108,97 +108,97 @@ weechat.register(name, author, version, license, description, shutdown_function, * python: [source,python] ----------------------------------------- +---- import weechat weechat.register("test_python", "FlashCode", "1.0", "GPL3", "Test script", "", "") weechat.prnt("", "Hello, from python script!") ----------------------------------------- +---- * perl: [source,perl] ----------------------------------------- +---- weechat::register("test_perl", "FlashCode", "1.0", "GPL3", "Test script", "", ""); weechat::print("", "Hello, from perl script!"); ----------------------------------------- +---- * ruby: [source,ruby] ----------------------------------------- +---- def weechat_init Weechat.register("test_ruby", "FlashCode", "1.0", "GPL3", "Test script", "", "") Weechat.print("", "Hello, from ruby script!") return Weechat::WEECHAT_RC_OK end ----------------------------------------- +---- * lua: [source,lua] ----------------------------------------- +---- weechat.register("test_lua", "FlashCode", "1.0", "GPL3", "Test script", "", "") weechat.print("", "Hello, from lua script!") ----------------------------------------- +---- * tcl: [source,tcl] ----------------------------------------- +---- weechat::register "test_tcl" "FlashCode" "1.0" "GPL3" "Test script" "" "" weechat::print "" "Hello, from tcl script!" ----------------------------------------- +---- * guile (scheme): [source,lisp] ----------------------------------------- +---- (weechat:register "test_scheme" "FlashCode" "1.0" "GPL3" "Test script" "" "") (weechat:print "" "Hello, from scheme script!") ----------------------------------------- +---- [[load_script]] -=== スクリプトのロード === +=== スクリプトのロード スクリプトをロードするには "script" プラグインを使うことを推奨します。例: ----------------------------------------- +---- /script load script.py /script load script.pl /script load script.rb /script load script.lua /script load script.tcl /script load script.scm ----------------------------------------- +---- プログラミング言語ごとの固有コマンドを利用することもできます: ----------------------------------------- +---- /python load python/script.py /perl load perl/script.pl /ruby load ruby/script.rb /lua load lua/script.lua /tcl load tcl/script.tcl /guile load guile/script.scm ----------------------------------------- +---- WeeChat の開始時にスクリプトを自動ロードするには 'language/autoload' ディレクトリ内にリンクを作ってください。 例えば Python の場合: ----------------------------------------- +---- $ cd ~/.weechat/python/autoload $ ln -s ../script.py ----------------------------------------- +---- [NOTE] `/script install` コマンドでスクリプトをインストールした場合、'autoload' ディレクトリ内にリンクが自動的に作成されます。 [[differences_with_c_api]] -== C API との違い == +== C API との違い スクリプト API は C プラグイン API とほぼ同じです。API に含まれる各関数の詳細については、'WeeChat プラグイン API リファレンス' @@ -212,28 +212,28 @@ $ ln -s ../script.py 例えば 'test.py' スクリプトが WeeChat API 関数を呼び出す場合、以下の順に呼び出されます: // PLEASE DO NOT TRANSLATE -........................................ +.... ┌──────────────────────┐ ╔══════════════════╗ │ python plugin │ ║ WeeChat "core" ║ ├────────────┬─────────┤ ╟─────────┐ ║ test.py ─────► │ script API │ C API │ ─────► ║ C API │ ║ └────────────┴─────────┘ ╚═════════╧════════╝ -........................................ +.... WeeChat が 'test.py' スクリプトで定義されたコールバックを呼び出す場合、順番は逆になります: // PLEASE DO NOT TRANSLATE -........................................ +.... ╔══════════════════╗ ┌──────────────────────┐ ║ WeeChat "core" ║ │ python plugin │ ║ ┌─────────╢ ├─────────┬────────────┤ ║ │ C API ║ ─────► │ C API │ script API │ ─────► test.py ╚════════╧═════════╝ └─────────┴────────────┘ -........................................ +.... [[pointers]] -=== ポインタ === +=== ポインタ ご存知かもしれませんが、スクリプトには本当の意味での "ポインタ" はありません。このため API 関数がポインタを返す場合、スクリプトでは文字列に変換されます。 @@ -249,9 +249,9 @@ API 関数を呼び出す前に C と解釈されます。例えば、データをコアバッファ (WeeChat メインバッファ) に表示する場合、以下のようになります: [source,python] ----------------------------------------- +---- weechat.prnt("", "hi!") ----------------------------------------- +---- [WARNING] 多くの関数ではスピードの関係で、WeeChat はポインタの値が正当なものか否かの確認を行いません。 @@ -259,7 +259,7 @@ weechat.prnt("", "hi!") 不正なポインタを利用した場合、細かなクラッシュレポートを目にすることになるでしょう ;) [[callbacks]] -=== コールバック === +=== コールバック ほとんど全ての WeeChat コールバックは WEECHAT_RC_OK 又は WEECHAT_RC_ERROR を返さなければいけません (modifier コールバックは例外で、これは文字列を返します)。 @@ -272,18 +272,18 @@ C コールバックはポインタ型の "data" 引数を利用します。ス * python: [source,python] ----------------------------------------- +---- def timer_cb(data, remaining_calls): weechat.prnt("", "timer! data=%s" % data) return weechat.WEECHAT_RC_OK weechat.hook_timer(1000, 0, 1, "timer_cb", "test") ----------------------------------------- +---- * perl: [source,perl] ----------------------------------------- +---- sub timer_cb { my ($data, $remaining_calls) = @_; weechat::print("", "timer! data=$data"); @@ -291,69 +291,69 @@ sub timer_cb { } weechat::hook_timer(1000, 0, 1, "timer_cb", "test"); ----------------------------------------- +---- * ruby: [source,ruby] ----------------------------------------- +---- def timer_cb(data, remaining_calls) Weechat.print("", "timer! data=#{data}"); return Weechat::WEECHAT_RC_OK end Weechat.hook_timer(1000, 0, 1, "timer_cb", "test"); ----------------------------------------- +---- * lua: [source,lua] ----------------------------------------- +---- function timer_cb(data, remaining_calls) weechat.print("", "timer! data="..data) return weechat.WEECHAT_RC_OK end weechat.hook_timer(1000, 0, 1, "timer_cb", "test") ----------------------------------------- +---- * tcl: [source,tcl] ----------------------------------------- +---- proc timer_cb { data remaining_calls } { weechat::print {} "timer! data=$data" return $::weechat::WEECHAT_RC_OK } weechat::hook_timer 1000 0 1 timer_cb test ----------------------------------------- +---- * guile (scheme): [source,lisp] ----------------------------------------- +---- (define (timer_cb data remaining_calls) (weechat:print "" (string-append "timer! data=" data)) weechat:WEECHAT_RC_OK ) (weechat:hook_timer 1000 0 1 "timer_cb" "test") ----------------------------------------- +---- [[script_api]] -== スクリプト API == +== スクリプト API API に含まれる関数の詳しい情報は 'WeeChat プラグイン API リファレンス' をご覧ください。. [[script_api_functions]] -=== 関数 === +=== 関数 スクリプト API に含まれる関数のリスト: [width="100%",cols="^1,10",options="header"] -|======================================== +|=== | カテゴリ | 関数 | 一般 | register @@ -430,15 +430,15 @@ API に含まれる関数の詳しい情報は hdata_pointer, hdata_time, hdata_hashtable, hdata_update, hdata_get_string | アップグレード | upgrade_new, upgrade_write_object, upgrade_read, upgrade_close -|======================================== +|=== [[script_api_constants]] -=== 定数 === +=== 定数 スクリプト API に含まれる定数のリスト: [width="100%",cols="^1,10",options="header"] -|======================================== +|=== | カテゴリ | 定数 | リターンコード | WEECHAT_RC_OK, WEECHAT_RC_OK_EAT, WEECHAT_RC_ERROR @@ -466,20 +466,20 @@ API に含まれる関数の詳しい情報は WEECHAT_HOOK_CONNECT_SOCKET_ERROR | シグナルのフック | WEECHAT_HOOK_SIGNAL_STRING, WEECHAT_HOOK_SIGNAL_INT, WEECHAT_HOOK_SIGNAL_POINTER -|======================================== +|=== [[common_tasks]] -== 良くあるタスク == +== 良くあるタスク この章ではいくつかの良くあるタスクを例を交えて紹介します。ここでは API の一部の機能を使っています。完全なリファレンスは 'WeeChat プラグイン API リファレンス' をご覧ください。 [[buffers]] -=== バッファ === +=== バッファ [[buffers_display_messages]] -==== メッセージの表示 ==== +==== メッセージの表示 WeeChat コアバッファに対して操作する場合、空文字列を使うことが多いです。他のバッファに対して操作する場合には、ポインタ (文字列型、<<pointers,ポインタ>> を参照) を与える必要があります。 @@ -487,7 +487,7 @@ WeeChat コアバッファに対して操作する場合、空文字列を使う 例: [source,python] ----------------------------------------- +---- # "hello" をコアバッファに表示 weechat.prnt("", "hello") @@ -514,13 +514,13 @@ weechat.prnt(buffer, "message on #weechat channel") # (サーバとチャンネルはコンマで区切ってください。) buffer = weechat.info_get("irc_buffer", "freenode,#weechat") weechat.prnt(buffer, "message on #weechat channel") ----------------------------------------- +---- [NOTE] Print 関数は Perl/Ruby/Lua/Tcl では `print` で、Python では `prnt` です。 [[buffers_send_text]] -==== バッファにテキストを送信 ==== +==== バッファにテキストを送信 テキストやコマンドをバッファに送信できます。これはテキストやコマンドをタイプして [Enter] を押すことに対応します。 @@ -528,17 +528,17 @@ Print 関数は Perl/Ruby/Lua/Tcl では `print` で、Python では `prnt` で 例: [source,python] ----------------------------------------- +---- # 現在のバッファでコマンド "/help" を実行 (結果は core バッファに出力されます) weechat.command("", "/help") # テキスト "hello" を #weechat IRC チャンネルに送信 (このチャンネルにいるユーザにはメッセージが見えます。) buffer = weechat.info_get("irc_buffer", "freenode,#weechat") weechat.command(buffer, "hello") ----------------------------------------- +---- [[buffers_new]] -==== 新規バッファの作成 ==== +==== 新規バッファの作成 スクリプトを使って新しいバッファを作成し、このバッファにメッセージを表示させることができます。 @@ -549,7 +549,7 @@ weechat.command(buffer, "hello") 例: [source,python] ----------------------------------------- +---- # データの入力時に呼び出されるコールバック def buffer_input_cb(data, buffer, input_data): # ... @@ -568,28 +568,28 @@ weechat.buffer_set(buffer, "title", "This is title for my buffer.") # ローカル変数 "no_log" に "1" を設定することでログ保存を無効化 weechat.buffer_set(buffer, "localvar_set_no_log", "1") ----------------------------------------- +---- [[buffers_properties]] -==== バッファプロパティ ==== +==== バッファプロパティ 文字列、整数、ポインタ型のバッファプロパティを読むことができます。 例: [source,python] ----------------------------------------- +---- buffer = weechat.current_buffer() number = weechat.buffer_get_integer(buffer, "number") name = weechat.buffer_get_string(buffer, "name") short_name = weechat.buffer_get_string(buffer, "short_name") ----------------------------------------- +---- バッファに対するローカル変数を追加、読み込み、削除することができます: [source,python] ----------------------------------------- +---- # ローカル変数の追加 weechat.buffer_set(buffer, "localvar_set_myvar", "my_value") @@ -598,19 +598,19 @@ myvar = weechat.buffer_get_string(buffer, "localvar_myvar") # ローカル変数の削除 weechat.buffer_set(buffer, "localvar_del_myvar", "") ----------------------------------------- +---- バッファに対するローカル変数を見るには、WeeChat で以下のコマンドを実行してください: ----------------------------------------- +---- /buffer localvar ----------------------------------------- +---- [[hooks]] -=== フック === +=== フック [[hook_command]] -==== 新しいコマンドの追加 ==== +==== 新しいコマンドの追加 カスタムコマンドを追加するには `hook_command` を使ってください。 追加したコマンドに対してカスタム補完テンプレートを定義できます。 @@ -618,7 +618,7 @@ weechat.buffer_set(buffer, "localvar_del_myvar", "") 例: [source,python] ----------------------------------------- +---- def my_command_cb(data, buffer, args): # ... return weechat.WEECHAT_RC_OK @@ -633,35 +633,35 @@ hook = weechat.hook_command("myfilter", "description of myfilter", " || add %(filters_names) %(buffers_plugins_names)|*" " || del %(filters_names)|-all", "my_command_cb", "") ----------------------------------------- +---- 上で定義したコマンドを WeeChat で以下のように使うことができます: ----------------------------------------- +---- /help myfilter /myfilter arguments... ----------------------------------------- +---- [[hook_timer]] -==== タイマーの追加 ==== +==== タイマーの追加 タイマーを追加するには `hook_timer` を使ってください。 例: [source,python] ----------------------------------------- +---- def timer_cb(data, remaining_calls): # ... return weechat.WEECHAT_RC_OK # 1 分毎に (秒が 00 になった時に) 呼び出されるタイマー weechat.hook_timer(60 * 1000, 60, 0, "timer_cb", "") ----------------------------------------- +---- [[hook_process]] -==== バックグラウンドプロセスの実行 ==== +==== バックグラウンドプロセスの実行 `hook_process` を使ってバックグラウンドプロセスを実行できます。 コールバックはデータの準備が整った時点で呼び出されます。複数回呼び出されることもあります。 @@ -672,7 +672,7 @@ weechat.hook_timer(60 * 1000, 60, 0, "timer_cb", "") 例: [source,python] ----------------------------------------- +---- process_output = "" def my_process_cb(data, command, rc, out, err): @@ -684,10 +684,10 @@ def my_process_cb(data, command, rc, out, err): return weechat.WEECHAT_RC_OK weechat.hook_process("/bin/ls -l /etc", 10 * 1000, "my_process_cb", "") ----------------------------------------- +---- [[url_transfer]] -==== URL 転送 ==== +==== URL 転送 _バージョン 0.3.7 に含まれる新機能_ @@ -698,7 +698,7 @@ URL をダウンロードする (又は URL にポストする) には、関数 "out" 引数 (プロセスの標準出力) を通して渡されます。 [source,python] ----------------------------------------- +---- # 現在の WeeChat 安定版のバージョンを表示。 weechat_version = "" @@ -712,7 +712,7 @@ def weechat_process_cb(data, command, rc, out, err): weechat.hook_process("url:http://weechat.org/dev/info/stable/", 30 * 1000, "weechat_process_cb", "") ----------------------------------------- +---- [TIP] WeeChat に関して利用できる情報は全て http://weechat.org/dev/info にあります @@ -721,7 +721,7 @@ WeeChat に関して利用できる情報は全て http://weechat.org/dev/info '/tmp/weechat-devel.tar.gz' にダウンロード: [source,python] ----------------------------------------- +---- def my_process_cb(data, command, rc, out, err): if int(rc) >= 0: weechat.prnt("", "End of transfer (rc=%s)" % rc) @@ -730,16 +730,16 @@ def my_process_cb(data, command, rc, out, err): weechat.hook_process_hashtable("url:http://weechat.org/files/src/weechat-devel.tar.gz", { "file_out": "/tmp/weechat-devel.tar.gz" }, 30 * 1000, "my_process_cb", "") ----------------------------------------- +---- URL 転送に関するより詳しい情報と利用可能なオプションを見るには、 'WeeChat プラグイン API リファレンス' の `hook_process` と `hook_process_hashtable` をご覧ください。 [[config_options]] -=== 設定 / オプション === +=== 設定 / オプション [[config_options_set_script]] -==== スクリプトのオプションを設定 ==== +==== スクリプトのオプションを設定 オプションが設定されているかどうかを確認するには `config_is_set_plugin` 関数、オプションを設定するには `config_set_plugin` 関数を使います。 @@ -747,7 +747,7 @@ URL 転送に関するより詳しい情報と利用可能なオプションを 例: [source,python] ----------------------------------------- +---- script_options = { "option1" : "value1", "option2" : "value2", @@ -756,17 +756,17 @@ script_options = { for option, default_value in script_options.items(): if not weechat.config_is_set_plugin(option): weechat.config_set_plugin(option, default_value) ----------------------------------------- +---- [[config_options_detect_changes]] -==== 変更の検出 ==== +==== 変更の検出 ユーザがスクリプトオプションを変更したことを検出するには `hook_config` を使わなければいけません。 例: [source,python] ----------------------------------------- +---- SCRIPT_NAME = "myscript" # ... @@ -781,17 +781,17 @@ def config_cb(data, option, value): weechat.hook_config("plugins.var.python." + SCRIPT_NAME + ".*", "config_cb", "") # 他のスクリプト言語の場合は "python" を適当なもの ("perl"、"ruby"、"lua"、"tcl") に変更してください。 ----------------------------------------- +---- [[config_options_weechat]] -==== WeeChat オプションの読み込み ==== +==== WeeChat オプションの読み込み `config_get` 関数はオプションへのポインタを返します。オプションの型に従って `config_string` 、`config_boolean` 、`config_integer` 、`config_color` を呼び出さなければいけません。 [source,python] ----------------------------------------- +---- # 文字列型の場合 weechat.prnt("", "value of option weechat.look.item_time_format is: %s" % (weechat.config_string(weechat.config_get("weechat.look.item_time_format")))) @@ -807,13 +807,13 @@ weechat.prnt("", "value of option weechat.look.scroll_page_percent is: %d" # 色型の場合 weechat.prnt("", "value of option weechat.color.chat_delimiters is: %s" % (weechat.config_color(weechat.config_get("weechat.color.chat_delimiters")))) ----------------------------------------- +---- [[irc]] -=== IRC === +=== IRC [[irc_catch_messages]] -==== メッセージのキャッチ ==== +==== メッセージのキャッチ メッセージを受信すると IRC プラグインは 2 つのシグナルを送信します (`xxx` は IRC 内部サーバ名で、`yyy` は JOIN、QUIT、PRIVMSG、301 等の IRC コマンド名です): @@ -825,7 +825,7 @@ xxx,irc_in2_yyy:: メッセージの処理が行われた後に送信されるシグナル [source,python] ----------------------------------------- +---- def join_cb(data, signal, signal_data): # シグナル、例えば: "freenode,irc_in2_join" # signal_data は IRC メッセージ、例えば: ":nick!user@host JOIN :#channel" @@ -840,49 +840,49 @@ def join_cb(data, signal, signal_data): # 全ての IRC サーバに対する JOIN メッセージをキャッチするにはサーバの指定に # "*" を使うと便利です。 weechat.hook_signal("*,irc_in2_join", "join_cb", "") ----------------------------------------- +---- [[irc_modify_messages]] -==== メッセージの修正 ==== +==== メッセージの修正 メッセージを受信すると IRC プラグインは "irc_in_xxx" ("xxx" は IRC コマンド) と呼ばれる "modifier" を送信します。メッセージを修正するにはこのシグナルを使います。 [source,python] ----------------------------------------- +---- def modifier_cb(data, modifier, modifier_data, string): # 全てのメッセージにサーバ名を追加する # (これは役に立ちませんが、例として!) return "%s %s" % (string, modifier_data) weechat.hook_modifier("irc_in_privmsg", "modifier_cb", "") ----------------------------------------- +---- [WARNING] 不正なメッセージは WeeChat をクラッシュさせ、深刻な問題を引き起こします! [[irc_message_parse]] -==== メッセージの構文解析 ==== +==== メッセージの構文解析 _バージョン 0.3.4 の新機能_ "irc_message_parse" と呼ばれる info_hashtable を使って IRC メッセージを構文解析できます。 [source,python] ----------------------------------------- +---- dict = weechat.info_get_hashtable("irc_message_parse", { "message": ":nick!user@host PRIVMSG #weechat :message here" }) weechat.prnt("", "dict: %s" % dict) # 出力: # dict: {'nick': 'nick', 'host': 'nick!user@host', 'command': 'PRIVMSG', 'arguments': '#weechat :message here', 'channel': '#weechat'} ----------------------------------------- +---- [[infos]] -=== 情報 === +=== 情報 [[infos_weechat_version]] -==== WeeChat のバージョン ==== +==== WeeChat のバージョン バージョンを確認する最良の方法は "version_number" を参照し、16 進数のバージョン番号と整数値比較することです。 @@ -890,13 +890,13 @@ weechat.prnt("", "dict: %s" % dict) 例: [source,python] ----------------------------------------- +---- version = weechat.info_get("version_number", "") or 0 if int(version) >= 0x00030200: weechat.prnt("", "This is WeeChat 0.3.2 or newer") else: weechat.prnt("", "This is WeeChat 0.3.1 or older") ----------------------------------------- +---- [NOTE] バージョン 0.3.1.1 以下では 'info_get("version_number")' @@ -905,35 +905,35 @@ else: 文字列でバージョンを使うには: [source,python] ----------------------------------------- +---- # 例えば "Version 0.3.2" のような出力が得られます。 weechat.prnt("", "Version %s" % weechat.info_get("version", "")) ----------------------------------------- +---- [[infos_other]] -==== その他の情報 ==== +==== その他の情報 [source,python] ----------------------------------------- +---- # WeeChat ホームディレクトリ、例えば: "/home/xxxx/.weechat" weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", "")) # キーボードの不使用時間 weechat.prnt("", "Inactivity since %s seconds" % weechat.info_get("inactivity", "")) ----------------------------------------- +---- [[infolists]] -=== 情報リスト === +=== 情報リスト [[infolists_read]] -==== 情報リストの読み込み ==== +==== 情報リストの読み込み WeeChat や他のプラグインによって作られた情報リストを読み込むことができます。 例: [source,python] ----------------------------------------- +---- # バッファのリストを得るために "buffer" 情報リストを読み込む infolist = weechat.infolist_get("buffer", "", "") if infolist: @@ -941,7 +941,7 @@ if infolist: name = weechat.infolist_string(infolist, "name") weechat.prnt("", "buffer: %s" % name) weechat.infolist_free(infolist) ----------------------------------------- +---- [IMPORTANT] WeeChat は自動的にメモリを解放しません、情報リストによって使われたメモリを解放するには、`infolist_free` diff --git a/doc/ja/weechat_tester.ja.txt b/doc/ja/weechat_tester.ja.txt index 6bd3aa0fa..7b461a464 100644 --- a/doc/ja/weechat_tester.ja.txt +++ b/doc/ja/weechat_tester.ja.txt @@ -1,9 +1,9 @@ -= WeeChat テスターガイド = += WeeChat テスターガイド Sébastien Helleu <flashcode@flashtux.org> [[purpose]] -== 目的 == +== 目的 WeeChat 開発への協力に興味を持っていただきありがとうございます。開発に協力する最も簡単 @@ -25,7 +25,7 @@ WeeChat [[prepare_system]] -== システムの準備 == +== システムの準備 Linux の 'core' ファイルを有効にすることはとても役に立ちます: WeeChat がクラッシュすると、Linux は 'core' と呼ばれるファイルを作ります。このファイルには、WeeChat @@ -33,13 +33,13 @@ Linux の 'core' ファイルを有効にすることはとても役に立ちま 'bash' シェルを使っている場合、以下の行を `~/.bashrc` に追記してください: ----------------------------------------- +---- ulimit -c unlimited ----------------------------------------- +---- [[download]] -== 開発版のダウンロード == +== 開発版のダウンロード 最新のコード (最新のバグと最新の機能も含んでいますが) は GIT リポジトリにあります。 @@ -50,55 +50,55 @@ ulimit -c unlimited 安定版を捨てる必要もありません。 [[get_sources]] -=== ソースの取得とビルド === +=== ソースの取得とビルド 最初にディレクトリを作ってください、ここでは 'weechat-git': ----------------------------------------- +---- $ mkdir ~/weechat-git $ cd ~/weechat-git ----------------------------------------- +---- git がインストール済みの場合、git リポジトリを clone してください (推奨): ----------------------------------------- +---- $ git clone git://git.sv.gnu.org/weechat.git $ cd weechat ----------------------------------------- +---- 注意: clone の後、このディレクトリ内で "`git pull`" を実行すれば、最新のアップデートとの差分が更新されます。 他の方法として 'devel' パッケージをダウンロードして展開する方法があります: ----------------------------------------- +---- $ wget http://www.weechat.org/files/src/weechat-devel.tar.bz2 $ tar xvjf weechat-devel.tar.bz2 $ cd weechat-devel ----------------------------------------- +---- ソースをビルドするには cmake を使うことを推奨します: ----------------------------------------- +---- $ mkdir build $ cd build $ cmake .. -DPREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug $ make $ make install ----------------------------------------- +---- cmake が無い場合は autotools を使うことも可能です: ----------------------------------------- +---- $ ./autogen.sh $ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev $ make $ make install ----------------------------------------- +---- [[install_binary_package]] -=== バイナリパッケージのインストール === +=== バイナリパッケージのインストール Linux ディストリビューション別に: @@ -109,16 +109,16 @@ Linux ディストリビューション別に: [[run]] -== WeeChat の実行 == +== WeeChat の実行 `--dir` オプションを使って WeeChat を専用の (安定版とは違う) ディレクトリで実行することを推奨します。 コマンド: ----------------------------------------- +---- $ ~/weechat-git/bin/weechat ----------------------------------------- +---- より万全を期すなら、上の方法を使って WeeChat の最新バージョンを使っていることを確認するべきです ;) @@ -130,7 +130,7 @@ $ ~/weechat-git/bin/weechat [[links]] -== 便利なリンク == +== 便利なリンク * GIT リポジトリ: http://git.savannah.gnu.org/gitweb/?p=weechat.git * バグトラッカー: https://savannah.nongnu.org/bugs/?group=weechat 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 を読んでください。 (ドキュメントとはこの文書のことで、ここまでの全ての内容を読んでいないのであれば、 |