翻訳者:
-
Ryuunosuke Ayanokouzi <i38w7i3@yahoo.co.jp>, 2009-2019
1. WeeChat を起動
X 用端末エミュレータは rxvt-unicode を推奨します: UTF-8 がサポートされており、デフォルトのキーバインドで問題が発生しないためです。
シェルから起動するには:
weechat
2. オンラインヘルプ
WeeChat はすべてのコマンドにヘルプがあります。ヘルプを見るには、以下のコマンドを入力してください:
/help
特定のコマンドに対するヘルプを見るには、以下のコマンドを入力してください:
/help command
各オプションに関するヘルプもあります:
/help config.section.option
(ここで config
は設定名 (core の場合は
weechat
もしくはプラグイン名)、section
はこの設定のセクション、option
はオプション名)。
3. オプションの設定
オプションを設定するには以下のコマンドを入力してください:
/set config.section.option value
オプション設定はすぐに反映されます (設定変更後に WeeChat を再起動する必要は ありません)。
すべての設定は WeeChat の終了時 (または強制的に設定保存を行う
/save
コマンドを使用した場合) に保存されます。
手作業で設定ファイルを編集することは 推奨されません。なぜなら
WeeChat は常時 (例えば /quit コマンドの実行時など)
設定ファイルに書き込む可能性がありますし、手作業で修正を加えた後には必ず /reload
コマンドを実行しなければいけない (これには /save
を使って保存されていない変更を失うリスクがある) からです。設定を編集するには /set
コマンドを使ってください。これは値を検査し、設定の変更をすぐに適用します。
|
fset プラグインを使えばオプションを簡単に閲覧、変更できます。
WeeChat オプションの表示:
/fset weechat.*
IRC オプションの表示:
/fset irc.*
/fset
コマンドに対してもオプション名の部分補完機能が使えるため、例えば /fset hot
を入力した後、Tab を押すことで、/fset hotlist
のように補完されます。その後
Enter を押すことで、ホットリストに関するオプションが表示されます。
/fset
コマンドとキーについては /help fset
を参照してください。
4. コア vs プラグイン
WeeChat の "core" にはユーザインタフェースに関わるものだけが含まれているため、プラグインがなければ使い物になりません (以前からのユーザーへ: IRC 関連は WeeChat バージョン 0.2.6 までコアに含まれていました)。
IRC 等全てのネットワークプロトコルはそれぞれ異なるプラグインで提供しています。
/plugin
コマンドで読み込まれているプラグイン一覧を表示できます。"irc"
やその他のプラグインはここから確認してください。
5. IRC サーバを追加する
IRC サーバを追加するには /server
コマンドを使ってください、例:
/server add libera irc.libera.chat/6697 -tls
このコマンドにおいて、libera
は WeeChat が使う内部サーバ名です:
接続時には /connect libera
を使うことが可能で、このサーバに関するオプションは
irc.server.libera.xxx になります。
書式が思い出せない場合はヘルプを利用してください:
/help server
6. IRC サーバのオプションを設定する
もしサーバオプションが特に設定されていない場合、WeeChat はデフォルト設定をすべてのサーバに適用します (フォールバック方式)。これらのデフォルト設定は "irc.server_default.*" です。
サーバオプションが定義されていれば ("null" でなければ) それを使用します。定義されていなければ、WeeChat はデフォルト設定を使用します ("irc.server_default.xxx")。
例えばデフォルトでは (un*x ログイン名をベースにした) ニックネームが設定されますが、以下のコマンドで libera サーバ用の設定として上書きすることが可能です:
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
ユーザ名と実名を設定する場合:
/set irc.server.libera.username "My user name" /set irc.server.libera.realname "My real name"
サーバへの自動接続を設定する場合:
/set irc.server.libera.autoconnect on
サーバで SASL を利用可能な場合、SASL を利用してニックネーム認証することができます (チャンネル参加前にニックネーム認証が行われるでしょう):
/set irc.server.libera.sasl_username "mynick" /set irc.server.libera.sasl_password "xxxxxxx"
例えば nickserv との認証などを行うためにサーバ接続後にコマンドを実行するには (SASL を利用して認証を行わない場合):
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
command オプションに複数のコマンドを含める場合は ; (セミコロン) で区切ってください。
|
設定ファイル内にパスワードを直接書きたくない場合、保護データを使うことが可能です。
最初にパスフレーズを登録します:
/secure passphrase this is my secret passphrase
その後に libera のパスワードを含む保護データを追加します:
/secure set libera_password xxxxxxx
こうすることで前述したようにパスワードを IRC オプションに直接書くのではなく
${sec.data.libera_password}
を指定可能になります。例えば以下のように設定します:
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
チャンネルへの自動参加を設定する場合:
/set irc.server.libera.autojoin "#channel1,#channel2"
The /autojoin
command lets you configure the autojoin option easily
(see /help autojoin
).
You can also configure WeeChat to automatically update the autojoin option when you join or leave channels:
/set irc.server_default.autojoin_dynamic on
サーバオプションの代わりにデフォルトの値を使用する、例えばデフォルトのニックネーム (irc.server_default.nicks) を使用する場合:
/unset irc.server.libera.nicks
その他設定: その他のオプションも以下のコマンドで設定できます ("xxx" は設定名です):
/set irc.server.libera.xxx value
オプションの名前と値を補完するには Tab キーを使います。さらに Shift+Tab キーを使えば部分的に補完することも可能です (これは オプション名などの長い単語を補完する際に役立ちます)。 |
7. Connect to IRC server
/connect libera
With this command, WeeChat connects to the libera server and auto-joins the channels configured in the "autojoin" server option.
このコマンドは、/server
を使わずに新しいサーバの作成および接続ができます (/help connect を参照してください)。
|
デフォルトでは、サーババッファは WeeChat の core バッファとマージされます。core バッファとサーババッファ間で切り替えたい場合は、Ctrl+x が使用できます。
サーババッファへの自動マージを無効にして 独立したサーババッファにすることができます:
/set irc.look.server_buffer independent
8. チャンネルに参加/退出する
チャンネルに参加します
/join #channel
チャンネルから退出します (バッファは開いたままにします):
/part [切断メッセージ]
サーバから切断し、チャンネルやプライベートバッファを閉じます (/close
は
/buffer close
の別名です):
/close
/close を用いてサーバから切断した場合、すべてのチャンネルおよびプライベートバッファは閉じられます。
|
サーババッファ上で実行することで、サーバから切断します:
/disconnect
9. IRC プライベートメッセージ
バッファを開いてメッセージを他のユーザ (ニックネーム foo) 宛に送信する:
/query foo this is a message
プライベートバッファを閉じる:
/close
10. バッファ/ウィンドウの管理
バッファは番号、カテゴリおよび名前とともにプラグインに関連づけられたあるコンポーネントです。バッファは画面に表示するデータを含んでいます。
ウィンドウはバッファを表示するためにあります。デフォルトでは、1 つのウィンドウは 1 つのバッファだけを表示できます。画面を分割することで、同時に複数のウィンドウと関連するバッファを見ることができるでしょう。
バッファとウィンドウを管理するためのコマンド:
/buffer /window
例えば、ウィンドウを垂直方向に小さいウィンドウ (1/3 幅) と大きいウィンドウ (2/3 幅) に分割する場合は次のコマンドを実行します:
/window splitv 33
分割を元に戻す:
/window merge
11. キー割り当て設定
WeeChat はデフォルトでたくさんのショートカットキーが設定されています。これらはドキュメントに記載されていますが、いくつか重要なキーがあります:
-
Alt+← / Alt+→ または F5 / F6: 前後のバッファに切り替える
-
F1 / F2: バッファリストを含むバー ("buflist") をスクロール表示
-
F7 / F8: 前後のウィンドウに切り替える (画面分割時)
-
F9 / F10: タイトルバーをスクロール表示
-
F11 / F12: ニックネーム一覧をスクロール表示
-
Tab: 入力バーでシェルと同様のテキスト補完を行う
-
PgUp / PgDn: 現在のバッファのテキストをスクロール表示
-
Alt+a: (ホットリスト内の) アクティブなバッファに移動する
必要であれば、/key
コマンドでショートカットキーの割り当てを変更することができます。キーコードを調べるには、Alt+k
が役に立つでしょう。
例えば、Alt+! に /buffer close
を割り当てる場合:
/key bind (alt-kを押下) (alt-!を押下) /buffer close
コマンドラインには以下のように表示されます:
/key bind meta-! /buffer close
キー割り当てを解除する場合:
/key unbind meta-!
12. プラグイン/スクリプト
Debian のようにいくつかのディストリビューションでは、プラグイン用パッケージが独立して用意されています (例えば weechat-plugins)。 見つかったプラグインは自動的に読み込まれます (プラグインやスクリプトのロード、有効/無効は WeeChat のドキュメントを参照してください)。
WeeChat では多くの外部スクリプト (貢献者の作った)
を利用できます、スクリプトをリポジトリからダウンロードしてインストールするには、/script
コマンドを使ってください、例:
/script install go.py
より詳しい情報を参照するには /help script
を使ってください。
A list of scripts is available in WeeChat with /script
or on
this page ↗.
13. 詳しいドキュメント情報
You can now use WeeChat and read FAQ/documentation ↗ for any other questions.
WeeChat をお楽しみください!