= WeeChat クイックスタートガイド =
Sébastien Helleu <flashcode@flashtux.org>


[[start]]
== WeeChat を起動 ==

X 用ターミナルエミュレータは rxvt-unicode を推奨します (UTF-8
がサポートされており、デフォルトのキーバインドで問題が発生しないためです)。

シェルから "weechat-curses" を実行してください。


[[help_options]]
== オンラインヘルプ / オプション ==

WeeChat は /help を打つことでヘルプを参照できます。
特定のコマンドのヘルプは、`/help コマンド名` で参照可能です。

オプション設定は、`/set config.section.option value`
で設定します (`config` は設定名 (主要オプションでは
`weechat`、それ以外はプラグイン名です)、`section`
は設定名のセクション、`option` はオプション名です)。

オプション設定はすぐに反映されます (設定変更後に
WeeChat を再起動する必要は *ありません*)。

`/set` オプションはすべての指定された文字を含むオプションを表示するために部分一致指定や先頭や最後にワイルドカード
"*" を指定することができます。
例:

`/set`::
    全ての設定名を表示します (WeeChat およびプラグイン)

`/set weechat.*`::
    WeeChat のオプションを表示します

`/set irc.*`::
    IRC プラグインのオプションを表示します

`/help` とオプション名を指定することでヘルプを表示できます、例:
`/help weechat.look.highlight`。

すべての設定は WeeChat の終了時 (または強制的に設定保存を行う
`/save` コマンドを使用した場合) に保存されます。

`/set` コマンド以外の設定方法として、設定ファイル (*.conf)
を直接修正し、`/reload` コマンドで再読込することもできます。


[[core_vs_plugins]]
== コア vs プラグイン ==

WeeChat の "core" にはユーザインタフェースに関わるものだけが含まれているため、
プラグインがなければ使い物になりません (以前からのユーザーへ: IRC
関連はバージョン 0.2.6 までコアに含まれていました)。

IRC 等全てのネットワークプロトコルはそれぞれ異なるプラグインで提供しています。

`/plugin` コマンドで読み込まれているプラグイン一覧を表示できます。"irc"
やその他のプラグインはここから確認してください。


[[create_irc_server]]
== サーバ情報を作成する ==

`/server` コマンドで IRC サーバを追加できます。例:

  /server add oftc irc.oftc.net/6667

書式が思い出せない場合はヘルプを利用してください: `/help server`


[[irc_server_options]]
== IRC サーバのオプションを設定する ==

もしサーバオプションが特に設定されていない場合、WeeChat
はデフォルト設定をすべてのサーバに適用します
(フォールバック方式)。これらのデフォルト設定は "irc.server_default.*" です。

サーバオプションが定義されていれば ("null" でなければ) それを使用します。定義されていなければ、WeeChat
はデフォルト設定を使用します ("irc.server_default.xxx")。

例えばデフォルトでは (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`
を使わずに新しいサーバの作成および接続ができます (`/help connect`
でこのコマンドのヘルプを確認することができます)。

デフォルトでは、サーババッファは Weechat の 'core' バッファとマージされます。'core'
バッファとサーババッファ間で切り替えたい場合は、ctrl-X が使用できます。

サーババッファへの自動マージを無効にして
独立したサーババッファにすることができます:

  /set irc.look.server_buffer independent


[[join_part_irc_channels]]
== チャンネルに接続 / 切断する ==

`/join #channel`::
    チャンネルに接続する

`/part [切断メッセージ]`::
    チャンネルから切断する (バッファは開いたままにする)

`/close`::
    チャンネルから切断し、バッファを閉じる (`/close` は `/buffer close` の別名)


[[buffer_window]]
== バッファ / ウィンドウ管理 ==

バッファは番号、カテゴリおよび名前とともにプラグインに関連づけられたあるコンポーネントです。
バッファは画面に表示するデータを含んでいます。

ウィンドウはバッファを表示するためにあります。デフォルトでは、1
つのウィンドウは 1 つのバッファだけを表示できます。画面を分割することで、
同時に複数のウィンドウと関連するバッファを見ることができるでしょう。

バッファ / ウィンドウを管理するためのコマンド:

  /buffer
  /window

(言うまでもありませんが /help でこれらのコマンドもヘルプを確認することができます)

例えば、ウィンドウを垂直方向に小さいウィンドウ (1/3 幅) と大きいウィンドウ
(2/3 幅) に分割する場合は次のコマンドを実行します:

  /window splitv 33


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

WeeChat はデフォルトでたくさんのショートカットキーが設定されています。
これらはドキュメントに記載されていますが、いくつか重要なキーがあります:

- 'alt + 左右矢印キー' (または 'F5'/'F6'): 前後のバッファに切り替える
- 'F7'/'F8': 前後のウィンドウに切り替える(画面分割時)
- 'F9'/'F10': タイトルバーをスクロール表示
- 'F11'/'F12': ニックネーム一覧をスクロール表示
- 'Tab': 入力バーでシェルと同様のテキスト補完を行う
- 'page up/Down': 現在のバッファのテキストをスクロール表示
- 'alt + A': (ホットリスト内の) アクティブなバッファに移動する

必要であれば、`/key`
コマンドでショートカットキーの割り当てを変更することができます。
キーコードを調べるには、meta-k (alt-k) が役に立つでしょう。

例えば、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)。
見つかったプラグインは自動的に読み込まれます (プラグイン /
スクリプトの読み込み、有効 / 無効は WeeChat のドキュメントを参照してください)。

WeeChat では多くの外部スクリプト (貢献者の作った) が利用可能です:
http://www.weechat.org/scripts

WeeChat ではコマンド `/script` を使うことで、スクリプトの管理ができます
(より詳しい情報を見るには `/help script` を参照してください)。


[[more_doc]]
== 詳しいドキュメント情報 ==

FAQ やその他の質問に関するドキュメントはこちらで参照できます:
http://www.weechat.org/doc

WeeChat を楽しんでください!