summaryrefslogtreecommitdiff
path: root/doc/ja/includes
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ja/includes')
-rw-r--r--doc/ja/includes/autogen_api_infos.ja.adoc10
-rw-r--r--doc/ja/includes/autogen_user_commands.ja.adoc140
-rw-r--r--doc/ja/includes/autogen_user_options.ja.adoc32
3 files changed, 95 insertions, 87 deletions
diff --git a/doc/ja/includes/autogen_api_infos.ja.adoc b/doc/ja/includes/autogen_api_infos.ja.adoc
index b1f3f65dd..f328cdcb5 100644
--- a/doc/ja/includes/autogen_api_infos.ja.adoc
+++ b/doc/ja/includes/autogen_api_infos.ja.adoc
@@ -134,9 +134,15 @@
| weechat | version_number | WeeChat のバージョン (数字) | -
+| weechat | weechat_cache_dir | WeeChat cache directory | -
+
+| weechat | weechat_config_dir | WeeChat config directory | -
+
| weechat | weechat_daemon | 1 if WeeChat is running in daemon mode (headless, in background) | -
-| weechat | weechat_dir | WeeChat ディレクトリ | -
+| weechat | weechat_data_dir | WeeChat data directory | -
+
+| weechat | weechat_dir | WeeChat directory (*deprecated* since version 3.2, replaced by "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" and "weechat_runtime_dir") | -
| weechat | weechat_headless | 1 if WeeChat is running headless | -
@@ -144,6 +150,8 @@
| weechat | weechat_localedir | WeeChat "locale" ディレクトリ | -
+| weechat | weechat_runtime_dir | WeeChat runtime directory | -
+
| weechat | weechat_sharedir | WeeChat "share" ディレクトリ | -
| weechat | weechat_site | WeeChat サイト | -
diff --git a/doc/ja/includes/autogen_user_commands.ja.adoc b/doc/ja/includes/autogen_user_commands.ja.adoc
index 0ace26e69..7a9bded40 100644
--- a/doc/ja/includes/autogen_user_commands.ja.adoc
+++ b/doc/ja/includes/autogen_user_commands.ja.adoc
@@ -1958,30 +1958,30 @@ option: オプションの名前
----
/upgrade [-yes] [<path_to_binary>|-quit]
- -yes: "weechat.look.confirm_upgrade" オプションが有効化されていた場合、このオプションは必須です。
-path_to_binary: WeeChat バイナリへのパス (デフォルトは現在のバイナリ)
- -dummy: 何もしない (補完された "-quit" オプションを不用意に使わないためのオプション)
- -quit: *すべての* 接続を閉じ、セッションを保存して WeeChat を終了。遅延復帰 (詳しくは後述) が可能になります。
+ -yes: required if option "weechat.look.confirm_upgrade" is enabled
+path_to_binary: path to WeeChat binary (default is current binary)
+ -dummy: do nothing (option used to prevent accidental completion with "-quit")
+ -quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)
-このコマンドは起動中の WeeChat セッションのアップグレードとリロードを行います。このコマンドを実行する前に、新しい WeeChat バイナリをコンパイルするか、パッケージマネージャでインストールしなければいけません。
+This command upgrades and reloads a running WeeChat session. The new WeeChat binary must have been compiled or installed with a package manager before running this command.
-注意: SSL 接続はアップグレード中に破棄されます、これは今のところ GnuTLS では SSL セッションのリロードができないからです。アップグレードの後に自動的に再接続されます。
+Note: SSL connections are lost during upgrade, because reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
-アップグレードは 4 つの手順を踏みます:
- 1. コアとプラグイン (バッファ、履歴、...) のセッションをファイルに保存
- 2. 全てのプラグインをアンロード (設定ファイル (*.conf) はディスクに書き込まれます)
- 3. WeeChat 設定を保存 (weechat.conf)
- 4. 新しい WeeChat バイナリを実行してセッションをリロード。
+Upgrade process has 4 steps:
+ 1. save session into files for core and plugins (buffers, history, ..)
+ 2. unload all plugins (configuration files (*.conf) are written on disk)
+ 3. save WeeChat configuration (weechat.conf)
+ 4. execute new WeeChat binary and reload session.
-オプション "-quit" を使うと、上の挙動が少し変わります:
- 1. *すべての* 接続を閉じる (irc、xfer、relay、...)
- 2. すべてのセッションをファイルに保存 (*.upgrade)
- 3. すべてのプラグインをアンロード
- 4. WeeChat 設定を保存
- 5. WeeChat を終了
-この後、セッションを回復させるには weechat --upgrade を使ってください。
-重要: 完全に同一の設定で (*.conf ファイルで) セッションを回復させてください。
-"~/.weechat" ディレクトリの内容をコピーすれば異なるマシンで WeeChat のセッションを回復することも可能です。
+With option "-quit", the process is slightly different:
+ 1. close *ALL* connections (irc, xfer, relay, ...)
+ 2. save session into files (*.upgrade)
+ 3. unload all plugins
+ 4. save WeeChat configuration
+ 5. quit WeeChat
+Then later you can restore session with command: weechat --upgrade
+IMPORTANT: you must restore the session with exactly same configuration (files *.conf).
+It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
----
[[command_weechat_uptime]]
@@ -2267,23 +2267,23 @@ Examples:
----
/fifo enable|disable|toggle
- enable: FIFO パイプを有効化します
-disable: FIFO パイプを無効化します
- toggle: FIFO パイプの有効無効を切り替えます
+ enable: enable FIFO pipe
+disable: disable FIFO pipe
+ toggle: toggle FIFO pipe
-FIFO パイプは WeeChat をリモート操作する際に使われます: FIFO パイプを通じてシェルからコマンドやテキストを送信できます。
-デフォルトの場合 FIFO パイプは ~/.weechat/weechat_fifo です。
+FIFO pipe is used as remote control of WeeChat: you can send commands or text to the FIFO pipe from your shell.
+By default the FIFO pipe is called weechat_fifo_xxx (where xxx is the WeeChat process id) and located in the WeeChat runtime directory (see /debug dirs).
-書式は次のうちのどれか 1 つを使ってください:
- plugin.buffer *テキストまたはコマンド
- *テキストまたはコマンド
+The expected format is one of:
+ plugin.buffer *text or command here
+ *text or command here
-freenode のニックネームを変更する例:
- echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
+For example to change your freenode nick:
+ echo 'irc.server.freenode */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
-詳しい情報と例はユーザーズガイドを参照してください。
+Please read the user's guide for more info and examples.
-例:
+Examples:
/fifo toggle
----
// end::fifo_commands[]
@@ -2706,53 +2706,53 @@ filename: ロードするスクリプト (ファイル)
raw
sslcertkey
- list: リレーするクライアントをリストアップ (アクティブなもののみ)
- listfull: リレーするクライアントをリストアップ (詳細、全てのリレー)
- listrelay: リレーをリストアップ (名前とポート番号)
- add: リレーを追加 (ポート/パスで接続を待ち受ける)
- del: リレーを削除 (クライアントとの接続は保持)
- start: ポートリッスンを開始する
- restart: サーバソケットを閉じて同じポートで接続を待つ (クライアントとの接続は保持)
- stop: サーバソケットを閉じる (クライアントとの接続は保持)
- name: リレー名 (以下の書式を参照してください)
- port: リレーが使うポート
- path: リレーが使うパス (UNIX ドメインソケット); 文字列先頭の "%h" は WeeChat ホーム (デフォルトは "~/.weechat") で置き換えられ、内容は評価されます (/help eval を参照してください)
- raw: 生リレーデータを表示するバッファを開く
- sslcertkey: オプション relay.network.ssl_cert_key のパスを使って SSL 証明書/鍵を指定
-
-リレー名の書式: [ipv4.][ipv6.][ssl.]<protocol.name> または unix.[ssl.]<protocol.name>
- ipv4: IPv4 を強制的に利用
- ipv6: IPv6 を強制的に利用
- ssl: SSL を有効化
- unix: UNIX ドメインソケットを利用
-protocol.name: リレーするプロトコルと名前:
- - "irc" プロトコル: name は共有するサーバ名 (任意指定、指定しない場合、サーバ名は "PASS" コマンドでクライアントが送信するものと同じでなければいけません、"PASS" コマンドの書式は "PASS server:password")
- - "weechat" プロトコル (name は使われません)
-
-"irc" プロトコルを指定した場合、どんな IRC クライアント (WeeChat 自身を含めて) でもポートに接続することができます。
-"weechat" プロトコルを指定した場合、リモートインターフェースを使ってポートに接続することができます、参照: https://weechat.org/about/interfaces
-
-引数無しの場合、リレークライアントのリストを含むバッファを開く
+ list: list relay clients (only active relays)
+ listfull: list relay clients (verbose, all relays)
+ listrelay: list relays (name and port)
+ add: add a relay (listen on a port/path)
+ del: remove a relay (clients remain connected)
+ start: listen on port
+ restart: close the server socket and listen again on port (clients remain connected)
+ stop: close the server socket (clients remain connected)
+ name: relay name (see format below)
+ port: port used for relay
+ path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
+ raw: open buffer with raw Relay data
+ sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
+
+Relay name is: [ipv4.][ipv6.][ssl.]<protocol.name> or unix.[ssl.]<protocol.name>
+ ipv4: force use of IPv4
+ ipv6: force use of IPv6
+ ssl: enable SSL
+ unix: use UNIX domain socket
+protocol.name: protocol and name to relay:
+ - protocol "irc": name is the server to share (optional, if not given, the server name must be sent by client in command "PASS", with format: "PASS server:password")
+ - protocol "weechat" (name is not used)
+
+The "irc" protocol allows any IRC client (including WeeChat itself) to connect on the port.
+The "weechat" protocol allows a remote interface to connect on the port, see the list here: https://weechat.org/about/interfaces
+
+Without argument, this command opens buffer with list of relay clients.
-例:
- サーバ "freenode" に対する irc プロキシを設定:
+Examples:
+ irc proxy, for server "freenode":
/relay add irc.freenode 8000
- サーバ "freenode" に対する SSL を有効化した irc プロキシを設定:
+ irc proxy, for server "freenode", with SSL:
/relay add ssl.irc.freenode 8001
- SSL を有効化してすべてのサーバに対する irc プロキシを設定 (クライアントがサーバを選ぶ):
+ irc proxy, for all servers (client will choose), with SSL:
/relay add ssl.irc 8002
- weechat プロトコル:
+ weechat protocol:
/relay add weechat 9000
- SSL を有効化した weechat プロトコル:
+ weechat protocol with SSL:
/relay add ssl.weechat 9001
- SSL を有効にした weechat プロトコル、IPv4 だけを利用:
+ weechat protocol with SSL, using only IPv4:
/relay add ipv4.ssl.weechat 9001
- SSL を有効にした weechat プロトコル、IPv6 だけを利用:
+ weechat protocol with SSL, using only IPv6:
/relay add ipv6.ssl.weechat 9001
- SSL を有効にした weechat プロトコル、IPv4 と IPv6 を利用:
+ weechat protocol with SSL, using IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
- UNIX ドメインソケットを介した weechat プロトコル:
- /relay add unix.weechat %h/relay_socket
+ weechat protocol over UNIX domain socket:
+ /relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
diff --git a/doc/ja/includes/autogen_user_options.ja.adoc b/doc/ja/includes/autogen_user_options.ja.adoc
index 9d0e3d54b..5821c5ab0 100644
--- a/doc/ja/includes/autogen_user_options.ja.adoc
+++ b/doc/ja/includes/autogen_user_options.ja.adoc
@@ -1261,7 +1261,7 @@
** デフォルト値: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
-** 説明: pass:none[認証局を含むファイル ("%h" は WeeChat ホームに置換されます、デフォルトでは "~/.weechat" です)]
+** 説明: pass:none[file containing the certificate authorities (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"/etc/ssl/certs/ca-certificates.crt"+`
@@ -1297,10 +1297,10 @@
** デフォルト値: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
-** 説明: pass:none[プラグイン検索パス ("%h" は WeeChat ホームに置換されます、デフォルトでは "~/.weechat" です)]
+** 説明: pass:none[path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
-** デフォルト値: `+"%h/plugins"+`
+** デフォルト値: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** 説明: pass:none[プラグインをアンロードする際に設定ファイルをセーブ]
@@ -1451,10 +1451,10 @@
** デフォルト値: `+""+`
* [[option_logger.file.path]] *logger.file.path*
-** 説明: pass:none[WeeChat ログファイルのパス; 文字列最初の "%h" は WeeChat ホームに置換 (デフォルトでは "~/.weechat" に置換); 日付指定子を使える (strftime の man を参照してください) (注意: 内容は評価されます、/help eval 参照)]
+** 説明: pass:none[path for WeeChat log files; date specifiers are permitted (see man strftime) (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
-** デフォルト値: `+"%h/logs/"+`
+** デフォルト値: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** 説明: pass:none[マスクと一緒に使われたときのファイル名に含まれる特殊文字に対応する置換文字 (ディレクトリ区切りのようなもの)]
@@ -1827,10 +1827,10 @@
** デフォルト値: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
-** 説明: pass:none[FIFO ファイルのパス; 文字列最初の "%h" は WeeChat ホーム に置換されます (デフォルトでは "~/.weechat" に置換されます); ${info:pid} を使えば WeeChat の PID を設定することも可能です (注意: 内容は評価されます、/help eval 参照)]
+** 説明: pass:none[path for FIFO file; WeeChat PID can be used in path with ${info:pid} (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
-** デフォルト値: `+"%h/weechat_fifo"+`
+** デフォルト値: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1931,10 +1931,10 @@
** デフォルト値: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
-** 説明: pass:none[受信ファイルのパス: 文字列最初の "%h" は WeeChat ホーム に置換されます (デフォルトでは "~/.weechat" に置換されます) (注意: 内容は評価されます、/help eval 参照)]
+** 説明: pass:none[path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
-** デフォルト値: `+"%h/xfer"+`
+** デフォルト値: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** 説明: pass:none[temporary filename suffix used during the transfer for a file received, it is removed after successful transfer; if empty string, no filename suffix is used during the transfer]
@@ -1943,7 +1943,7 @@
** デフォルト値: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
-** 説明: pass:none[送信時に読み込むファイルのパス (ユーザがパスを指定しなかった場合に使われます): 文字列最初の "%h" は WeeChat ホームに置換されます (デフォルトでは "~/.weechat" に置換されます) (注意: 内容は評価されます、/help eval 参照)]
+** 説明: pass:none[path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"~"+`
@@ -2743,7 +2743,7 @@
** デフォルト値: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
-** 説明: pass:none["ecdsa-nist256p-challenge" メカニズム用の ECC 秘密鍵を含むファイル ("%h" は WeeChat ホームに置換されます、デフォルトでは "~/.weechat" です)]
+** 説明: pass:none[file with ECC private key for mechanism "ecdsa-nist256p-challenge" (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -2785,7 +2785,7 @@
** デフォルト値: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
-** 説明: pass:none[自動的にニックネームの身元確認を行うために使われる SSL 証明書ファイル ("%h" は WeeChat ホームで置換、デフォルトは "~/.weechat" です)]
+** 説明: pass:none[SSL certificate file used to automatically identify your nick (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+""+`
@@ -3009,10 +3009,10 @@
** デフォルト値: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
-** 説明: pass:none[SSL 証明書と秘密鍵のファイル (SSL 接続を利用するクライアント用)]
+** 説明: pass:none[file with SSL certificate and private key (for serving clients with SSL) (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
-** デフォルト値: `+"%h/ssl/relay.pem"+`
+** デフォルト値: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** 説明: pass:none[gnutls の優先度を示した文字列 (構文は、gnutls マニュアルの gnutls_priority_init 関数のドキュメントを参照してください、通例: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3393,10 +3393,10 @@
** デフォルト値: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
-** 説明: pass:none[スクリプト用のローカルキャッシュディレクトリ; 文字列最初の "%h" は WeeChat ホーム に置換されます (デフォルトでは "~/.weechat" に置換されます) (注意: 内容は評価されます、/help eval 参照)]
+** 説明: pass:none[local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)]
** タイプ: 文字列
** 値: 未制約文字列
-** デフォルト値: `+"%h/script"+`
+** デフォルト値: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** 説明: pass:none[スクリプトのリストを含むファイルの URL]