diff --git a/doc/ja/weechat.1.ja.adoc b/doc/ja/weechat.1.ja.adoc index 150566098..f55c6f0e2 100644 --- a/doc/ja/weechat.1.ja.adoc +++ b/doc/ja/weechat.1.ja.adoc @@ -32,7 +32,7 @@ include::cmdline_options.ja.adoc[] == プラグインオプション プラグインオプションに関する完全な文書は -https://weechat.org/doc[WeeChat ユーザーガイド] のプラグインリファレンスを参照してください。 +https://weechat.org/doc[WeeChat ユーザーズガイド] のプラグインの章を参照してください。 irc プラグインでは以下の様な URL で一時的なサーバに接続することができます: diff --git a/doc/ja/weechat_dev.ja.adoc b/doc/ja/weechat_dev.ja.adoc index 438c36797..55599adf8 100644 --- a/doc/ja/weechat_dev.ja.adoc +++ b/doc/ja/weechat_dev.ja.adoc @@ -46,7 +46,7 @@ weechat:: ソースコードと文書を含むコアリポジトリ scripts:: - weechat.org に投稿された _公式_ スクリプト + weechat.org に投稿された _公式_スクリプト weechat.org:: WeeChat ウェブサイトのソースコード: https://weechat.org/ @@ -348,7 +348,7 @@ WeeChat "core" は以下のディレクトリに配置されています: |    docinfo.html | asciidoctor スタイル |    docgen.py | _autogen/_ ディレクトリ内のファイルを作成する Python スクリプト (以下を参照) |    XX/ | 言語コード XX (言語コード: en、fr、de、it、...) 用のディレクトリ -|       cmdline_options.XX.adoc | コマンドラインオプション (man ページとユーザガイドに含まれるファイル) +|       cmdline_options.XX.adoc | コマンドラインオプション (man ページとユーザーズガイドに含まれるファイル) |       weechat.1.XX.adoc | man ページ (`man weechat`) |       weechat_dev.XX.adoc | 開発者リファレンス (この文書) |       weechat_faq.XX.adoc | FAQ @@ -357,10 +357,10 @@ WeeChat "core" は以下のディレクトリに配置されています: |       weechat_relay_protocol.XX.adoc | リレープロトコル (リモートインターフェイス用) |       weechat_scripting.XX.adoc | スクリプト作成ガイド |       weechat_tester.XX.adoc | テスターガイド -|       weechat_user.XX.adoc | ユーザーガイド +|       weechat_user.XX.adoc | ユーザーズガイド |       autogen/ | docgen.py スクリプトが自動生成するファイル -|          user/ | ユーザーガイド用の自動生成ファイル (手作業による編集は*禁止* !) -|          plugin_api/ | プラグイン API 用の自動生成ファイル (手作業による編集は*禁止* !) +|          user/ | ユーザーズガイド用の自動生成ファイル (手作業による編集は *禁止*!) +|          plugin_api/ | プラグイン API 用の自動生成ファイル (手作業による編集は *禁止*!) |=== WeeChat とプラグインの翻訳は gettext で行います、ファイルは _po/_ ディレクトリに含まれています: @@ -380,7 +380,7 @@ WeeChat とプラグインの翻訳は gettext で行います、ファイルは === 一般的なルール * ソースコード内で使用する、コメント、変数名、... - は必ず*英語* で記述してください (他の言語を使わないでください) + は必ず *英語*で記述してください (他の言語を使わないでください) * 新しいファイルにはコピーライトヘッダを入れ、以下の情報を含めてください: ** ファイルの短い説明 (1 行)、 ** 日付、 @@ -415,7 +415,7 @@ WeeChat とプラグインの翻訳は gettext で行います、ファイルは [[coding_c_style]] === C 言語スタイル -C 言語のコードを書く際には以下の基本的なルールを*必ず* 守ってください。: +C 言語のコードを書く際には以下の基本的なルールを *必ず*守ってください。: * インデントは空白文字を 4 個使ってください。タブ文字を使わないでください、タブ文字は良くありません。 * 読みやすくする必要がある場合を除いて、1 @@ -724,7 +724,7 @@ gui_window_new (struct t_gui_window *parent_window, struct t_gui_buffer *buffer, === シングルスレッド WeeChat はシングルスレッドです。これはつまり、コードの全ての部分を非常に高速に実行する必要があり、`sleep` -などの関数を呼び出すことは*厳格に禁止* されているということです (この点は +などの関数を呼び出すことは *厳格に禁止*されているということです (この点は WeeChat コアだけでなく、C 言語プラグインとスクリプトでも同じことが言えます)。 何らかの理由でしばらく sleep したい場合は、`hook_timer` をコールバックと併せて使ってください。 @@ -790,7 +790,7 @@ WeeChat は文字列中に独自の色コードを使うことで、属性 * `(A)STD`: 任意属性を含めた標準色 (属性 + 2 桁の番号) * `EXT`: 拡張色 (`+@+` + 5 桁の番号) * `(A)EXT`:任意属性を含めた拡張色 (`+@+` + 属性 + 5 桁の番号) -* `ATTR`: 属性指定の 1 文字 (`+*+` 、`+!+` 、`+/+` 、`+_+` 、`+|+`) +* `ATTR`: 属性指定の 1 文字 (`+*+`、`+!+`、`+/+`、`+_+`、`+|+`) 以下の表にすべての組み合わせをまとめています: @@ -991,7 +991,7 @@ _component_ には以下から 1 つ選んで記入してください: * WeeChat コア: _core_ (ルートディレクトリ、_po/_ ディレクトリ、_src/_ ディレクトリに含まれるファイル、ただし _src/plugins/_ 内のファイルを除く) * 文書ファイル: _doc_ (_doc/_ ディレクトリに含まれるファイル) -* プラグインの名前: _irc_ 、_python_ 、_relay_ 、... (_src/plugins/_ ディレクトリに含まれるファイル) +* プラグインの名前: _irc_、_python_、_relay_、... (_src/plugins/_ ディレクトリに含まれるファイル) 以下のルールに従ってください: diff --git a/doc/ja/weechat_faq.ja.adoc b/doc/ja/weechat_faq.ja.adoc index 01cd5060a..abf779207 100644 --- a/doc/ja/weechat_faq.ja.adoc +++ b/doc/ja/weechat_faq.ja.adoc @@ -89,14 +89,14 @@ https://weechat.org/doc [[charset]] === いくつかの文字が見えません。どうすれば良いですか。 -これは良くある問題です。以下の内容をよく読んで、*全ての* 解決策をチェックしてください: +これは良くある問題です。以下の内容をよく読んで、*全ての*解決策をチェックしてください: * weechat が libncursesw にリンクされていることの確認 (警告: 全てではありませんが、ほとんどのディストリビューションで必要です): `ldd /path/to/weechat` * `/plugin` コマンドで "charset" プラグインがロード済みであることの確認 (ロードされていない場合、"weechat-plugins" パッケージが必要かもしれません)。 * `/charset` コマンドの出力を確認 (core バッファ上で)。端末の文字セットとして _ISO-XXXXXX_ - 又は _UTF-8_ があるはずです。その他の値がある場合は、ロケールが間違っている可能性があります + または _UTF-8_ があるはずです。その他の値がある場合は、ロケールが間違っている可能性があります ($LANG を修正してください)。 * グローバルデコードを設定、例えば: `/set charset.default.decode "ISO-8859-15"` @@ -104,14 +104,14 @@ https://weechat.org/doc ** 端末で UTF-8 が使えることを確認 (UTF-8 対応の端末としては rxvt-unicode を推奨) ** screen を使っている場合は、UTF-8 モードで起動されていることを確認 - (~/.screenrc に "`defutf8 on`" の記述があるか又は `screen -U` のようにして起動)。 + (~/.screenrc に "`defutf8 on`" の記述があるかまたは `screen -U` のようにして起動)。 * _weechat.look.eat_newline_glitch_ オプションが off であることを確認してください (このオプションは表示上のバグを引き起こす可能性があります) [NOTE] WeeChat は UTF-8 ロケールを推奨します。ISO -又はその他のロケールを使う場合、*全ての* 設定 (端末、screen、..) -が ISO であり、UTF-8 *でない* ことを確認してください。 +またはその他のロケールを使う場合、*全ての*設定 (端末、screen、..) +が ISO であり、UTF-8 *でない*ことを確認してください。 [[unicode_chars]] === 端末で表示されるユニコード文字が WeeChat では表示されない場合があります。なぜでしょうか。 @@ -135,10 +135,10 @@ WeeChat を起動した場所に依存しますが、以下の値を持つはず * WeeChat を screen および tmux を使わずにローカルまたはリモートマシンで実行している場合、使用中の端末に依存します: - _xterm_ 、_xterm-256color_ 、_rxvt-unicode_ 、_rxvt-256color_ 、... + _xterm_、_xterm-256color_、_rxvt-unicode_、_rxvt-256color_、... * WeeChat を screen 内で実行している場合、_screen_ または _screen-256color_ です、 * WeeChat を tmux - 内で実行している場合、_tmux_ 、_tmux-256color_、_screen_ 、_screen-256color_ です。 + 内で実行している場合、_tmux_、_tmux-256color_、_screen_、_screen-256color_ です。 もし必要であれば、TERM 変数を修正してください: `export TERM="xxx"` @@ -146,7 +146,7 @@ WeeChat を起動した場所に依存しますが、以下の値を持つはず === weechat を screen/tmux の中で使っている場合、おかしなランダム文字列が表示されます。どうすれば直りますか。 シェルの TERM 変数に間違った値が設定されている可能性があります -(端末、*screen/tmux の外* で `echo $TERM` の出力を確認してください)。 +(端末、*screen/tmux の外*で `echo $TERM` の出力を確認してください)。 例えば、_xterm-color_ の場合、おかしな文字列が表示される可能性があります。_xterm_ と設定すればこのようなことは起こらないので (その他多くの値でも問題は起きません)、これを使ってください。 @@ -165,7 +165,7 @@ WeeChat をインストールすることをお勧めします。 [[buffer_vs_window]] === 「バッファ」と「ウィンドウ」の違いは何ですか。 -_バッファ_ とは番号、名前、表示行 (とその他のデータ) +_バッファ_とは番号、名前、表示行 (とその他のデータ) からなります。 _ウィンドウ_ @@ -213,7 +213,7 @@ kbd:[F1]、kbd:[F2]、kbd:[Alt+F1]、kbd:[Alt+F2] を定義しています: kbd:[Alt+k] の後にキーを押してください。 [[customize_prefix]] -=== どうすればチャットエリア内のニックネームの最大長さを短く、又はニックネーム整列機能を無効化できますか。 +=== どうすればチャットエリア内のニックネームの最大長さを短く、またはニックネーム整列機能を無効化できますか。 チャットエリアのニックネームの最大長を短くするには: @@ -227,40 +227,37 @@ kbd:[Alt+k] の後にキーを押してください。 /set weechat.look.prefix_align none ---- -// TRANSLATION MISSING [[status_hotlist]] -=== What does mean the [H: 3(1,8), 2(4)] in status bar? +=== ステータスバーに表示される [H: 3(1,8), 2(4)] の意味を教えてください。 -This is called the "hotlist", a list of buffers with the number of unread -messages, by order: highlights, private messages, messages, other messages -(like join/part). + -The number of "unread message" is the number of new messages displayed/received -since you visited the buffer. +これは「ホットリスト」と呼ばれ、ここにはバッファ番号およびそのバッファの未読メッセージカウンタが表示されます。未読メッセージカウンタの表示順はハイライト、プライベートメッセージ、一般メッセージ、その他のメッセージ +(参加/退出メッセージなど) +の順です。 + +バッファの「未読メッセージ」とは、最後にそのバッファにフォーカスが移された以降に表示されたり受信した新しいメッセージを意味します。 -In the example `[H: 3(1,8), 2(4)]`, there are: +上記の例 `[H: 3(1,8), 2(4)]` の場合: -* one highlight and 8 unread messages on buffer #3, -* 4 unread messages on buffer #2. +* バッファ 3 番にハイライトが 1 通、未読が 8 通あり、 +* バッファ 2 番に未読が 4 通あることを意味します。 -The color of the buffer/counter depends on the type of message, default colors -are: +バッファおよびカウンタのテキスト色はメッセージの種類を意味します。色のデフォルト設定は以下です: -* highlight: `lightmagenta` / `magenta` -* private message: `lightgreen` / `green` -* message: `yellow` / `brown` -* other message: `default` / `default` (color of text in terminal) +* ハイライト: `lightmagenta` および `magenta` +* プライベートメッセージ: `lightgreen` および `green` +* 一般メッセージ: `yellow` および `brown` +* その他のメッセージ: `default` および `default` (端末のテキスト色) -These colors can be changed with the options __weechat.color.status_data_*__ -(buffers) and __weechat.color.status_count_*__ (counters). + -Other hotlist options can be changed with the options __weechat.look.hotlist_*__. +これらの色を変えるには、__weechat.color.status_data_*__ オプション (バッファ) +および __weechat.color.status_count_*__ オプション (カウンタ) を設定します。 + +その他のホットリスト関連オプションは __weechat.look.hotlist_*__ オプションを使って変更します。 -See user's guide for more info about the hotlist (screen layout). +ホットリストに関する詳しい情報はユーザーズガイド (画面レイアウト) をご覧ください。 [[input_bar_size]] === コマンドラインの行数を増やすにはどうすればいいですか。 インプットバーの _size_ オプションには 1 (サイズ固定、デフォルト値) -以上の値又は動的なサイズの意味で 0 を設定できます。_size_max_ +以上の値または動的なサイズの意味で 0 を設定できます。_size_max_ オプションではサイズの最大値を設定できます (0 = 制限なし)。 動的サイズを設定する例: @@ -371,7 +368,7 @@ WeeChat バージョン 0.3.4 以上の場合、256 色がサポートされま * screen 内の場合: _screen-256color_ * tmux 内の場合: _screen-256color_ または _tmux-256color_ -* screen および tmux の外の場合: _xterm-256color_ 、_rxvt-256color_ 、_putty-256color_ 、... +* screen および tmux の外の場合: _xterm-256color_、_rxvt-256color_、_putty-256color_、... [NOTE] これらの値を _TERM_ に設定するには、"ncurses-term" @@ -396,7 +393,7 @@ WeeChat バージョン 0.3.4 の場合、新しい色を追加するには `/co WeeChat バージョン 0.3.5 以上の場合、任意の色番号を利用できます (オプション: 色の別名を追加するには `/color` コマンドを使ってください)。 -色管理に関するより詳しい情報はユーザーガイドを読んでください。 +色管理に関するより詳しい情報はユーザーズガイドを読んでください。 [[search_text]] === どうすればバッファ内の文字列を検索できますか (irssi の /lastlog の様に)。 @@ -404,7 +401,7 @@ WeeChat バージョン 0.3.5 以上の場合、任意の色番号を利用で デフォルトのキーは kbd:[Ctrl+r] です (コマンドは: `/input search_text_here`)。 ハイライト部分へのジャンプは: kbd:[Alt+p] / kbd:[Alt+n] -この機能に関するより詳しい情報はユーザーガイドを参照してください (デフォルトのキー割り当て)。 +この機能に関するより詳しい情報はユーザーズガイドを参照してください (デフォルトのキー割り当て)。 [[terminal_focus]] === どうすれば端末にフォーカスが合った時や外れた時にコマンドを実行できますか。 @@ -413,8 +410,8 @@ WeeChat バージョン 0.3.5 以上の場合、任意の色番号を利用で *重要*: -* 現時点では、_xterm_ を除いてこの機能をサポートする端末は*存在しない* ようです。 -* screen および tmux ではこの機能を*使うことができません* 。 +* 現時点では、_xterm_ を除いてこの機能をサポートする端末は *存在しない*ようです。 +* screen および tmux ではこの機能を *使うことができません*。 WeeChat の開始時にコードを送信するには: @@ -431,7 +428,7 @@ WeeChat の開始時にコードを送信するには: ---- [[screen_paste]] -=== WeeChat を screen の内部で実行している場合、別の screen ウィンドウ内に貼り付けられるテキストの周りに ~0 と ~1 が追加されます。なぜでしょうか。 +=== WeeChat を screen の内部で実行している場合、別の screen ウィンドウ内にペーストされるテキストの周りに ~0 と ~1 が追加されます。なぜでしょうか。 scrreen がデフォルトで有効化されている括弧付きペーストオプションの挙動を別のウィンドウ内で適切に処理できないことが原因です。 @@ -460,7 +457,7 @@ XTerm*metaSendsEscape: true UXTerm*metaSendsEscape: true ---- -このファイルを再読み込みするか (`xrdb -override ~/.Xresources`) 又は X を再起動してください。 +このファイルを再読み込みするか (`xrdb -override ~/.Xresources`) または X を再起動してください。 [[customize_key_bindings]] === どうすればキー割り当てをカスタマイズできますか。 @@ -470,7 +467,7 @@ UXTerm*metaSendsEscape: true デフォルトキー kbd:[Alt+k] でキーコードを取り込み、これをコマンドラインに入力できます。 [[jump_to_buffer_11_or_higher]] -=== バッファ 11 番 (又はそれ以上の番号) にジャンプするキーは何ですか。 +=== バッファ 11 番 (またはそれ以上の番号) にジャンプするキーは何ですか。 キー kbd:[Alt+j] の後に 2 桁の数字を入力します、例えば kbd:[Alt+j] その後に kbd:[1]、kbd:[1] でバッファ 11 番にジャンプします。 @@ -481,7 +478,7 @@ UXTerm*metaSendsEscape: true /key bind meta-q /buffer *11 ---- -デフォルトキー割り当てのリストはユーザーガイドを参照してください。 +デフォルトキー割り当てのリストはユーザーズガイドを参照してください。 [[global_history]] === どうすればグローバルヒストリを (バッファヒストリの代わりに) 上下矢印キーで使えますか。 @@ -533,7 +530,7 @@ $ printf '\033[?1002l' ---- [[mouse_coords]] -=== マウスの位置座標 X 又は Y が 94 (または 222) よりも大きい場合にマウス機能が正しく動きません。 +=== マウスの位置座標 X または Y が 94 (または 222) よりも大きい場合にマウス機能が正しく動きません。 一部の端末ではマウスの位置座標を指定するために ISO 文字だけを使います、 このため X/Y が 94 (または 222) よりも大きい場合は正しく動きません。 @@ -815,7 +812,7 @@ OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Li * 使わないプラグインのロードを禁止する、例えば: aspell、fifo、logger、perl、python、ruby、lua、tcl、guile、javascript、xfer (DCC で使用) * 本当に必要なスクリプトだけをロード -* SSL を*使わない* なら、証明書を読み込まないでください: オプション +* SSL を *使わない*なら、証明書を読み込まないでください: オプション _weechat.network.gnutls_ca_file_ に空文字列を設定してください。 * _weechat.history.max_buffer_lines_number_ オプションの値を減らすか、_weechat.history.max_buffer_lines_minutes_ オプションに値を設定してください。 diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc index 6d2d7f4e3..c33d54956 100644 --- a/doc/ja/weechat_plugin_api.ja.adoc +++ b/doc/ja/weechat_plugin_api.ja.adoc @@ -1968,7 +1968,7 @@ _WeeChat バージョン 0.4.0 以上で利用可、バージョン 0.4.2、1.0 [NOTE] WeeChat バージョン 1.0 以上の場合、入れ子変数を使えるようになりました、例: -`+${color:${variable}}+` 。 +`+${color:${variable}}+`。 プロトタイプ: @@ -4908,7 +4908,7 @@ option5 = weechat.config_new_option(config_file, section, "option5", "color", [NOTE] Ruby では、3 組のコールバックとデータ (合わせて 6 つの文字列) を渡すために必ず 6 つの文字列をからなる配列を 1 つ渡してください (これは Ruby が 関数に 15 個以上の引数を渡せないことが原因です)、より詳しい内容は -_WeeChat スクリプト作成ガイド_ を参照してください _(WeeChat バージョン 0.4.1 で修正済み)_ 。 +_WeeChat スクリプト作成ガイド_ を参照してください _(WeeChat バージョン 0.4.1 で修正済み)_。 ==== config_search_option @@ -7457,7 +7457,7 @@ WeeChat バージョン 0.3.9.2 分割 (クォートに基づくコマンド分割) に失敗する場合、またはシェルを使いたい場合は、ハッシュテーブル _options_ に引数を入れて <<_hook_process_hashtable,hook_process_hashtable>> -関数を使ってください _(WeeChat バージョン 0.4.0 以上で利用可)_ 。 +関数を使ってください _(WeeChat バージョン 0.4.0 以上で利用可)_。 プロトタイプ: @@ -7517,11 +7517,11 @@ struct t_hook *weechat_hook_process (const char *command, (プロセスが実行中であればプロセスを kill します)。 コマンドを "url:http://www.example.com" の書式に従う URL にすることで、URL -の内容がダウンロードされます _(WeeChat バージョン 0.3.7 以上で利用可)_ 。<<_hook_process_hashtable,hook_process_hashtable>> +の内容がダウンロードされます _(WeeChat バージョン 0.3.7 以上で利用可)_。<<_hook_process_hashtable,hook_process_hashtable>> 関数を使えば URL に対してオプションを与えることもできます。 _command_ には関数名を指定することも可能です。"name" という関数を実行するには "func:name" -のように指定します _(WeeChat バージョン 1.5 以上で利用可)_ 。ここで指定した関数 "name" は単独の引数 (_data_) +のように指定します _(WeeChat バージョン 1.5 以上で利用可)_。ここで指定した関数 "name" は単独の引数 (_data_) を受け取り、文字列を返すものでなければいけません。関数から返された文字列が _callback_ コールバックに送られます。 + C API の場合、_callback_ コールバックが _return_code_ リターンコードに _WEECHAT_HOOK_PROCESS_CHILD_ が設定された状態で呼び出されます。すなわち (フォークの後に) @@ -8244,12 +8244,12 @@ WeeChat とプラグインが送信するシグナルのリスト: | irc | xxx,irc_in_yyy ^(1)^ | String: メッセージ | - サーバから IRC メッセージを受信 (メッセージを*無視しない* 場合のみ irc + サーバから IRC メッセージを受信 (メッセージを *無視しない*場合のみ irc プラグインがメッセージを処理する前に、シグナルが送信される) | irc | xxx,irc_in2_yyy ^(1)^ | String: メッセージ | - サーバから IRC メッセージを受信 (メッセージを*無視しない* 場合のみ irc + サーバから IRC メッセージを受信 (メッセージを *無視しない*場合のみ irc プラグインがメッセージを処理した後に、シグナルが送信される) | irc | xxx,irc_raw_in_yyy ^(1)^ + @@ -9313,7 +9313,7 @@ hsignal "irc_redirect_command" は irc コマンドに対する応答を完全に受信したら、hsignal が送信されます。この hsignal は _irc_redirection_xxx_yyy_ という名前で、ここで _xxx_ は -_signal_ 、_yyy_ は _pattern_ で指定したものになります。 +_signal_、_yyy_ は _pattern_ で指定したものになります。 以下の内容からなるハッシュテーブルが hsignal で送信されます (キーと値は文字列): @@ -9392,7 +9392,7 @@ hsignal "irc_redirect_pattern" は irc 転送用のパターンを作成する * _cmd_extra_: コマンドを停止した後に受信する可能性のあるコマンドのコンマ区切りリスト (任意) -_cmd_start_ 、_cmd_stop_ 、_cmd_extra_ +_cmd_start_、_cmd_stop_、_cmd_extra_ には受け取ったメッセージに必ず含まれていなければいけない "string" の位置を示す整数を与えることが可能、例: @@ -9573,7 +9573,7 @@ struct t_hook *weechat_hook_completion (const char *completion_item, [IMPORTANT] コールバックは <<_hook_completion_list_add,hook_completion_list_add>> -関数を呼び出すだけで、コマンドラインをコールバックで絶対に*変更しない* でください。 + +関数を呼び出すだけで、コマンドラインをコールバックで絶対に *変更しない*でください。 + key[Tab] が押された時にコマンドラインを更新するためには、関数 <<_hook_command_run,hook_command_run>> を使ってコマンド "/input complete_next" をフックしてください (コールバックがコマンドラインを更新する場合は必ず @@ -10312,7 +10312,7 @@ struct t_hook *weechat_hook_focus (const char *area, マウスジェスチャの場合、コールバックを 2 回呼び出します: 1 回目はボタンが押された時 (この時のエリアはジェスチャ対象のエリアです)、2 回目はボタンが離された時 (この時のエリアはマスジェスチャを開始したエリアとは異なる場合があります): -このため、必ず*毎回* コールバックをテストして、ハッシュテーブルに含まれる +このため、必ず *毎回*コールバックをテストして、ハッシュテーブルに含まれる info を使う前にエリアが一致していることを確認して下さい。 コールバックに送られるハッシュテーブルの内容 (キーと値は "string" 型): @@ -10508,19 +10508,19 @@ void weechat_hook_set (struct t_hook *hook, const char *property, | stdin + _(WeeChat バージョン 0.4.3 以上で利用可)_ | - _process_ 、_process_hashtable_ | 任意の文字列 | + _process_、_process_hashtable_ | 任意の文字列 | 子プロセスの標準入力 (_stdin_) にデータを送信 | stdin_close + _(WeeChat バージョン 0.4.3 以上で利用可)_ | - _process_ 、_process_hashtable_ | (非使用) | + _process_、_process_hashtable_ | (非使用) | 子プロセスの標準入力 (_stdin_) にデータを送信するパイプを閉じる | signal + _(WeeChat バージョン 1.0 以上で利用可)_ | - _process_ 、_process_hashtable_ | + _process_、_process_hashtable_ | シグナル番号または以下の名前から 1 つ: - `hup` 、`int` 、`quit` 、`kill` 、`term` 、`usr1` 、`usr2` | + `hup`、`int`、`quit`、`kill`、`term`、`usr1`、`usr2` | 子プロセスにシグナルを送信 |=== @@ -11109,7 +11109,7 @@ const char *weechat_buffer_get_string (struct t_gui_buffer *buffer, ** _name_: バッファの名前 ** _full_name_: バッファの完全な名前 ("plugin.name") _(WeeChat バージョン 0.3.7 以上で利用可)_ ** _short_name_: バッファの短縮名 (注意: - 表示目的以外に使用するのは禁止、ユーザは書き換えることが可能、バッファを検索する際にこれを使ってはいけない、_name_ 、_full_name_ 、またはローカル変数 + 表示目的以外に使用するのは禁止、ユーザは書き換えることが可能、バッファを検索する際にこれを使ってはいけない、_name_、_full_name_、またはローカル変数 _channel_ を使うこと) ** _title_: バッファのタイトル ** _input_: 入力テキスト @@ -12720,7 +12720,7 @@ struct t_gui_bar_item *my_item = weechat_bar_item_new ("myitem", [IMPORTANT] WeeChat バージョン 0.4.1 以下に対する互換性のために、デフォルトのコールバックに渡す引数の個数は -3 個です: _data_ 、_item_ 、_window_ (_buffer_ と _extra_info_ は渡されません)。 + +3 個です: _data_、_item_、_window_ (_buffer_ と _extra_info_ は渡されません)。 + 全ての引数を受け取るコールバックを使う場合は、名前の前に "(extra)" をつけてください、以下の例を参照 (WeeChat バージョン 0.4.2 以上で利用可)。 @@ -12884,8 +12884,8 @@ struct t_gui_bar *weechat_bar_new (const char *name, ** _active_: アクティブウィンドウのみに表示されているバー ** _inactive_: 非アクティブウィンドウのみに表示されているバー ** _nicklist_: ニックネームリストを持つウィンドウに表示されているバー -** 評価された式: _WeeChat ユーザガイド_ のバーに関する章を参照 -* _position_: _top_ 、_bottom_ 、_left_ 、_right_ +** 評価された式: _WeeChat ユーザーズガイド_のバーに関する章を参照 +* _position_: _top_、_bottom_、_left_、_right_ * _filling_top_bottom_: ** _horizontal_: 要素は水平方向に詰め込まれている (各要素の後に間隔) ** _vertical_: 要素は垂直方向に詰め込まれている (各要素の後に行) @@ -14151,7 +14151,7 @@ hdata に対する関数 (WeeChat またはプラグインデータへの直ア [IMPORTANT] hdata を使うことで読み取り専用でデータにアクセスできます。hdata -変数が示すメモリ領域に何かを書き込むことは*厳禁* です。 + +変数が示すメモリ領域に何かを書き込むことは *厳禁*です。 + データを更新する場合は必ず関数 <<_hdata_update,hdata_update>> を使ってください。 @@ -14197,7 +14197,7 @@ struct t_hdata *weechat_hdata_new (const char *hdata_name, const char *var_prev, * _delete_allowed_: 構造体の削除を許可する場合は 1、それ以外の場合は 0 _(WeeChat バージョン 0.3.9 以上で利用可)_ * _callback_update_: hdata 内のデータを更新する際のコールバック関数、データの更新を禁止する場合は NULL - _(WeeChat バージョン 0.3.9 以上で利用可)_ 、引数と戻り値: + _(WeeChat バージョン 0.3.9 以上で利用可)_、引数と戻り値: ** _void *data_: ポインタ ** _struct t_hdata *hdata_: hdata へのポインタ ** _struct t_hashtable *hashtable_: 更新する変数を含むハッシュテーブル @@ -14811,7 +14811,7 @@ int weechat_hdata_check_pointer (struct t_hdata *hdata, void *list, void *pointe 引数: * _hdata_: hdata へのポインタ -* _list_: リストポインタ; NULL の場合 _(WeeChat バージョン 1.0 以上)_ 、ポインタは +* _list_: リストポインタ; NULL の場合 _(WeeChat バージョン 1.0 以上)_、ポインタは hdata に含まれる "check pointers" フラグを持つリストでチェックされます (<<_hdata_new_list,hdata_new_list>> を参照)、このフラグを持つリストがない場合、ポインタは妥当とされます。 @@ -14934,7 +14934,7 @@ void *weechat_hdata_search (struct t_hdata *hdata, void *pointer, const char *se * _pointer_: WeeChat および plugin オブジェクトへのポインタ * _search_: 評価する式、式中のデフォルトポインタは hdata の名前 (デフォルトポインタはリストに含まれる各要素で置換される); 式に関する詳細は - _WeeChat ユーザガイド_ のコマンド `/eval` を参照 + _WeeChat ユーザーズガイド_のコマンド `/eval` を参照 * _move_: 検索に失敗した後に移動を実行する回数 (負および正の整数、ゼロは禁止) @@ -15379,7 +15379,7 @@ int weechat_hdata_update (struct t_hdata *hdata, void *pointer, struct t_hashtab 1、許可しない場合は 0 を返す _(WeeChat バージョン 0.4.0 以上で利用可)_ ** キー `__delete_allowed` (値は任意): 構造体の削除を許可する場合は 1、許可しない場合は 0 を返す -** キー `__update_allowed` 、値は変数の名前: この変数の更新を許可する場合は +** キー `__update_allowed`、値は変数の名前: この変数の更新を許可する場合は 1、許可しない場合は 0 を返す ** キー `__delete` (値は任意): 構造体を削除 (許可されている場合) diff --git a/doc/ja/weechat_relay_protocol.ja.adoc b/doc/ja/weechat_relay_protocol.ja.adoc index 503283f9b..2029e8bd7 100644 --- a/doc/ja/weechat_relay_protocol.ja.adoc +++ b/doc/ja/weechat_relay_protocol.ja.adoc @@ -27,14 +27,14 @@ この文書では以下の用語を利用します: * _リレー_: これは relay プラグインを備えた WeeChat を指し、"サーバ" - のように振る舞い、_クライアント_ からの接続を受け付けます -* _クライアント_: これは他のソフトウェアのことを指し、ネットワークを介して _リレー_ - に接続します; 多くの場合、_クライアント_ はリモートインターフェイスのことを指します。 + のように振る舞い、_クライアント_からの接続を受け付けます +* _クライアント_: これは他のソフトウェアのことを指し、ネットワークを介して _リレー_に接続します; + 多くの場合、_クライアント_はリモートインターフェイスのことを指します。 [[network_diagram]] === ネットワーク図 -以下の図に示すように_クライアント_ は_リレー_ に接続しています: +以下の図に示すように _クライアント_は _リレー_に接続しています: .... ┌────────────────┐ ワークステーション @@ -55,21 +55,21 @@ .... [NOTE] -この文書で述べる全てのクライアントは_リレー_ プラグインの _weechat_ プロトコルを使っています。また_リレー_ -プラグインは IRC クライアントからの接続を受け入れることができます、この場合_リレー_ -プラグインは _IRC プロキシ_ のように振舞います (この文書では説明しません)。 +この文書で述べる全てのクライアントは _リレー_プラグインの _weechat_ プロトコルを使っています。また +_リレー_プラグインは IRC クライアントからの接続を受け入れることができます、この場合 +_リレー_プラグインは _IRC プロキシ_のように振舞います (この文書では説明しません)。 [[protocol_generalities]] == プロトコルの一般的説明 -* _リレー_ プラグインは新しい接続を受け入れるために IP/port をリッスンし、_クライアント_ - は TCP ソケットを使って_リレー_ に接続します。 -* _クライアント_ の数はオプション _relay.network.max_clients_ で制限されています。 -* それぞれの_クライアント_ が自分以外のクライアントと協調して動くことはできません。 -* _クライアント_ から_リレー_ へのメッセージを_コマンド_ - と呼び、これはテキスト形式 (文字列) で送信されます。 -* _リレー_ から_クライアント_ へのメッセージを_メッセージ_ - と呼び、これはバイナリデータとして送信されます。 +* _リレー_プラグインは新しい接続を受け入れるために IP/port をリッスンし、_クライアント_は + TCP ソケットを使って _リレー_に接続します。 +* _クライアント_の数はオプション _relay.network.max_clients_ で制限されています。 +* それぞれの _クライアント_が自分以外のクライアントと協調して動くことはできません。 +* _クライアント_から _リレー_へのメッセージを + _コマンド_と呼び、これはテキスト形式 (文字列) で送信されます。 +* _リレー_から _クライアント_へのメッセージを + _メッセージ_と呼び、これはバイナリデータとして送信されます。 [[commands]] == コマンド (クライアント → リレー) @@ -78,7 +78,7 @@ フィールドは: -* _id_: _リレー_ からの応答に含まれる任意指定のメッセージ識別子; +* _id_: _リレー_からの応答に含まれる任意指定のメッセージ識別子; 識別子は必ず括弧で括り、アンダースコア ("_") を最初につけるのは禁止されています (アンダースコアが最初についている識別子は WeeChat _event_ メッセージ用に予約されています) * _command_: コマンド (以下のテーブルを参照) @@ -90,23 +90,21 @@ [width="80%",cols="^3m,14",options="header"] |=== | コマンド | 説明 -| init | _リレー_ 接続を初期化 +| init | _リレー_接続を初期化 | hdata | _hdata_ を要求 -| info | _インフォ_ を要求 -| infolist | _インフォリスト_ を要求 -| nicklist | _ニックネームリスト_ を要求 +| info | _インフォ_を要求 +| infolist | _インフォリスト_を要求 +| nicklist | _ニックネームリスト_を要求 | input | バッファにデータを送信 (テキストまたはコマンド) | sync | バッファを同期 (バッファの最新情報を取得) | desync | バッファを非同期 (バッファの更新を止める) -| quit | _リレー_ から切断 +| quit | _リレー_から切断 |=== [[command_init]] === init -_リレー_ 接続を初期化。_リレー_ -に送るコマンドは必ずこのコマンドから始めてください。_リレー_ -がこのコマンドを受信していない場合、_リレー_ は最初のコマンドを受け取った時点で警告無しに接続を閉じます。 +_リレー_接続を初期化。_リレー_に送るコマンドは必ずこのコマンドから始めてください。_リレー_がこのコマンドを受信していない場合、_リレー_は最初のコマンドを受け取った時点で警告無しに接続を閉じます。 構文: @@ -117,11 +115,11 @@ init [