Starting to translate reference of the command line tools

droonga · Apr 30, 2015 · dbcadda · dbcadda
1 parent 60dade4
commit dbcadda
Show file tree

Hide file tree

Showing 7 changed files with 393 additions and 0 deletions.
diff --git a/_po/ja/reference/1.1.1/command-line-tools/droonga-add/index.po b/_po/ja/reference/1.1.1/command-line-tools/droonga-add/index.po
@@ -0,0 +1,158 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"PO-Revision-Date: 2014-11-30 23:19+0900\n"
+"Language: ja\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+msgid ""
+"---\n"
+"title: droonga-add\n"
+"layout: en\n"
+"---"
+msgstr ""
+
+msgid ""
+"* TOC\n"
+"{:toc}"
+msgstr ""
+
+msgid "## Abstract {#abstract}"
+msgstr "## 概要 {#abstract}"
+
+msgid ""
+"`droonga-add` adds a new record or updates an existing record, to the specifie"
+"d table in a Droonga cluster."
+msgstr ""
+
+msgid ""
+"For example, if there is a Droonga node `192.168.100.50` and your are logged i"
+"n to a computer `192.168.100.10` in the same network segment, the command line"
+" to add a new record to the table `User` in the cluster is:"
+msgstr ""
+
+msgid ""
+"~~~\n"
+"(on 192.168.100.10)\n"
+"$ droonga-add --host 192.168.100.50 --receiver-host 192.168.100.10 \\\n"
+"    --table User --key id1 --name Adam --age 20\n"
+"~~~"
+msgstr ""
+
+msgid ""
+"This command is just a shorthand of [`droonga-request`](../droonga-request/) w"
+"ith a message with the type [`add`](../../commands/add/).\n"
+"The result produced by the following command line completely equals to the one"
+" of above:"
+msgstr ""
+
+msgid ""
+"~~~\n"
+"(on 192.168.100.10)\n"
+"$ echo '{\"type\":\"key\",\"key\":\"id1\",\"values\":{\"name\":\"Adam\",\"age\":20}}' |\n"
+"    droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10\n"
+"~~~"
+msgstr ""
+
+msgid "### Parameters {#parameters}"
+msgstr ""
+
+msgid ""
+"`--table=TABLE` *(required)*\n"
+": Name of the target table."
+msgstr ""
+
+msgid ""
+"`--key=KEY`\n"
+": A unique key of the adding or updating record."
+msgstr ""
+
+msgid ""
+"`--(COLUMN NAME)=(VALUE)`, `--value:(COLUMN NAME)=(VALUE)`\n"
+": Value of the column for the record.\n"
+"  Columns with names same to other existing parameter like `host` must be spec"
+"ified with the prefix `--value:`."
+msgstr ""
+
+msgid ""
+"`--host=NAME`\n"
+": Host name of the engine node.\n"
+"  A guessed host name of the computer you are running the command, by default."
+msgstr ""
+
+msgid ""
+"`--port=PORT`\n"
+": Port number to communicate with the engine.\n"
+"  `10031` by default."
+msgstr ""
+
+msgid ""
+"`--tag=TAG`\n"
+": Tag name to communicate with the engine.\n"
+"  `droonga` by default."
+msgstr ""
+
+msgid ""
+"`--dataset=NAME`\n"
+": Dataset name for the sending message.\n"
+"  `Default` by default."
+msgstr ""
+
+msgid ""
+"`--receiver-host=NAME`\n"
+": Host name of the computer you are running the command.\n"
+"  A guessed host name of the computer, by default."
+msgstr ""
+
+msgid ""
+"`--target-role=ROLE`\n"
+": Role of engine nodes which should process the message.\n"
+"  Possible values:"
+msgstr ""
+
+msgid ""
+"  * `service-provider`:\n"
+"    The message is processed by service provider nodes in the cluster.\n"
+"    For absorb-source nodes and absrob-destination nodes, the message will be "
+"dispatched later.\n"
+"  * `absorb-source`:\n"
+"    The message is processed by absorb-source nodes in the cluster.\n"
+"    For service provider nodes and absrob-destination nodes, the message is ne"
+"ver dispatched.\n"
+"  * `absorb-destination`:\n"
+"    The message is processed by absorb-destination nodes in the cluster.\n"
+"    For service provider nodes and absrob-source nodes, the message is never d"
+"ispatched.\n"
+"  * `any`:\n"
+"    The message is always processed by the node specified via the option `--ho"
+"st`."
+msgstr ""
+
+msgid "  `any` by default."
+msgstr ""
+
+msgid ""
+"`--timeout=SECONDS`\n"
+": Time to terminate unresponsive connections, in seconds.\n"
+"  `3` by default."
+msgstr ""
+
+msgid ""
+"`-h`, `--help`\n"
+": Shows the usage of the command."
+msgstr ""
+
+msgid "### How to install {#install}"
+msgstr ""
+
+msgid "This is installed as a part of a rubygems package `droonga-client`."
+msgstr ""
+
+msgid ""
+"~~~\n"
+"# gem install droonga-client\n"
+"~~~"
+msgstr ""
diff --git a/_po/ja/reference/1.1.1/command-line-tools/index.po b/_po/ja/reference/1.1.1/command-line-tools/index.po
@@ -0,0 +1,70 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"PO-Revision-Date: 2014-11-30 23:19+0900\n"
+"Language: ja\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+msgid ""
+"---\n"
+"title: Command line tools\n"
+"layout: en\n"
+"---"
+msgstr ""
+"---\n"
+"title: コマンドラインツール\n"
+"layout: en\n"
+"---"
+
+msgid ""
+"Droonga provides some command line tools.\n"
+"This section describes usage of them."
+msgstr ""
+"Droongaはいくつかのコマンドラインツールを提供しています。\n"
+"このセクションでは、それらの使い方を説明しています。"
+
+msgid "## Communicating with Droonga cluster"
+msgstr "## Droongaクラスタとの通信"
+
+msgid ""
+" * [droonga-add](droonga-add/): Adds a new record to a cluster.\n"
+" * [droonga-groonga](droonga-groonga/): Sends Groonga commands to a cluster.\n"
+" * [droonga-system-status](droonga-system-status/): Reports status of members "
+"in a cluster.\n"
+" * [droonga-request](droonga-request/): Sends any message to a cluster and rep"
+"orts the response.\n"
+" * [droonga-send](droonga-send/): Sends any message to a cluster.\n"
+" * [drndump](drndump/): Extracts all schema definitions and records from a clu"
+"ster."
+msgstr ""
+
+msgid "## Cluster management"
+msgstr "## クラスタの管理"
+
+msgid ""
+" * [droonga-engine-join](droonga-engine-join/): Adds a new replica node to a c"
+"luster.\n"
+" * [droonga-engine-unjoin](droonga-engine-unjoin/): Removes an existing replic"
+"a node from a cluster.\n"
+" * [droonga-engine-absorb-data](droonga-engine-absorb-data/): Copy all schema "
+"definitions and records from a cluster to another.\n"
+" * [droonga-engine-set-role](droonga-engine-set-role/): Sets the role of a nod"
+"e in a cluster."
+msgstr ""
+
+msgid "## Low level system administration"
+msgstr "## 低レイヤのシステム管理"
+
+msgid ""
+" * [droonga-engine-configure](droonga-engine-configure/): Configures the `droo"
+"nga-engine` service on a computer.\n"
+" * [droonga-engine-catalog-generate](droonga-engine-catalog-generate/): Genera"
+"tes a new cluster definition file.\n"
+" * [droonga-engine-catalog-modify](droonga-engine-catalog-modify/): Modifies a"
+"n existing cluster definition file.\n"
+" * [droonga-http-server-configure](droonga-http-server-configure/): Configures"
+" the `droonga-http-server` service on a computer."
+msgstr ""
diff --git a/_po/ja/reference/1.1.1/index.po b/_po/ja/reference/1.1.1/index.po
@@ -41,6 +41,11 @@ msgstr ""
 "[コマンドリファレンス](commands/)\n"
 ": Droonga Engineで利用可能な組み込みのコマンドの詳細。"
 
+msgid ""
+"[Command line tools](command-line-tools/)\n"
+": Describes details of built-in commands available on the Droonga Engines."
+msgstr ""
+
 msgid ""
 "[HTTP Server](http-server/)\n"
 ": Describes usage of the [droonga-http-server](https://github.com/droonga/droo"

diff --git a/ja/reference/1.1.1/command-line-tools/droonga-add/index.md b/ja/reference/1.1.1/command-line-tools/droonga-add/index.md
@@ -0,0 +1,104 @@
+---
+title: droonga-add
+layout: en
+---
+
+{% comment %}
+##############################################
+  THIS FILE IS AUTOMATICALLY GENERATED FROM
+  "_po/ja/reference/1.1.1/command-line-tools/droonga-add/index.po"
+  DO NOT EDIT THIS FILE MANUALLY!
+##############################################
+{% endcomment %}
+
+
+* TOC
+{:toc}
+
+## 概要 {#abstract}
+
+`droonga-add` adds a new record or updates an existing record, to the specified table in a Droonga cluster.
+
+For example, if there is a Droonga node `192.168.100.50` and your are logged in to a computer `192.168.100.10` in the same network segment, the command line to add a new record to the table `User` in the cluster is:
+
+~~~
+(on 192.168.100.10)
+$ droonga-add --host 192.168.100.50 --receiver-host 192.168.100.10 \
+    --table User --key id1 --name Adam --age 20
+~~~
+
+This command is just a shorthand of [`droonga-request`](../droonga-request/) with a message with the type [`add`](../../commands/add/).
+The result produced by the following command line completely equals to the one of above:
+
+~~~
+(on 192.168.100.10)
+$ echo '{"type":"key","key":"id1","values":{"name":"Adam","age":20}}' |
+    droonga-request --host 192.168.100.50 --receiver-host 192.168.100.10
+~~~
+
+### Parameters {#parameters}
+
+`--table=TABLE` *(required)*
+: Name of the target table.
+
+`--key=KEY`
+: A unique key of the adding or updating record.
+
+`--(COLUMN NAME)=(VALUE)`, `--value:(COLUMN NAME)=(VALUE)`
+: Value of the column for the record.
+  Columns with names same to other existing parameter like `host` must be specified with the prefix `--value:`.
+
+`--host=NAME`
+: Host name of the engine node.
+  A guessed host name of the computer you are running the command, by default.
+
+`--port=PORT`
+: Port number to communicate with the engine.
+  `10031` by default.
+
+`--tag=TAG`
+: Tag name to communicate with the engine.
+  `droonga` by default.
+
+`--dataset=NAME`
+: Dataset name for the sending message.
+  `Default` by default.
+
+`--receiver-host=NAME`
+: Host name of the computer you are running the command.
+  A guessed host name of the computer, by default.
+
+`--target-role=ROLE`
+: Role of engine nodes which should process the message.
+  Possible values:
+
+  * `service-provider`:
+    The message is processed by service provider nodes in the cluster.
+    For absorb-source nodes and absrob-destination nodes, the message will be dispatched later.
+  * `absorb-source`:
+    The message is processed by absorb-source nodes in the cluster.
+    For service provider nodes and absrob-destination nodes, the message is never dispatched.
+  * `absorb-destination`:
+    The message is processed by absorb-destination nodes in the cluster.
+    For service provider nodes and absrob-source nodes, the message is never dispatched.
+  * `any`:
+    The message is always processed by the node specified via the option `--host`.
+
+  `any` by default.
+
+`--timeout=SECONDS`
+: Time to terminate unresponsive connections, in seconds.
+  `3` by default.
+
+`-h`, `--help`
+: Shows the usage of the command.
+
+
+### How to install {#install}
+
+This is installed as a part of a rubygems package `droonga-client`.
+
+~~~
+# gem install droonga-client
+~~~
+
diff --git a/ja/reference/1.1.1/command-line-tools/index.md b/ja/reference/1.1.1/command-line-tools/index.md
@@ -0,0 +1,40 @@
+---
+title: コマンドラインツール
+layout: en
+---
+
+{% comment %}
+##############################################
+  THIS FILE IS AUTOMATICALLY GENERATED FROM
+  "_po/ja/reference/1.1.1/command-line-tools/index.po"
+  DO NOT EDIT THIS FILE MANUALLY!
+##############################################
+{% endcomment %}
+
+
+Droongaはいくつかのコマンドラインツールを提供しています。
+このセクションでは、それらの使い方を説明しています。
+
+## Droongaクラスタとの通信
+
+ * [droonga-add](droonga-add/): Adds a new record to a cluster.
+ * [droonga-groonga](droonga-groonga/): Sends Groonga commands to a cluster.
+ * [droonga-system-status](droonga-system-status/): Reports status of members in a cluster.
+ * [droonga-request](droonga-request/): Sends any message to a cluster and reports the response.
+ * [droonga-send](droonga-send/): Sends any message to a cluster.
+ * [drndump](drndump/): Extracts all schema definitions and records from a cluster.
+
+## クラスタの管理
+
+ * [droonga-engine-join](droonga-engine-join/): Adds a new replica node to a cluster.
+ * [droonga-engine-unjoin](droonga-engine-unjoin/): Removes an existing replica node from a cluster.
+ * [droonga-engine-absorb-data](droonga-engine-absorb-data/): Copy all schema definitions and records from a cluster to another.
+ * [droonga-engine-set-role](droonga-engine-set-role/): Sets the role of a node in a cluster.
+
+## 低レイヤのシステム管理
+
+ * [droonga-engine-configure](droonga-engine-configure/): Configures the `droonga-engine` service on a computer.
+ * [droonga-engine-catalog-generate](droonga-engine-catalog-generate/): Generates a new cluster definition file.
+ * [droonga-engine-catalog-modify](droonga-engine-catalog-modify/): Modifies an existing cluster definition file.
+ * [droonga-http-server-configure](droonga-http-server-configure/): Configures the `droonga-http-server` service on a computer.
+
diff --git a/ja/reference/1.1.1/index.md b/ja/reference/1.1.1/index.md
@@ -21,6 +21,9 @@ layout: ja
 [コマンドリファレンス](commands/)
 : Droonga Engineで利用可能な組み込みのコマンドの詳細。
 
+[Command line tools](command-line-tools/)
+: Describes details of built-in commands available on the Droonga Engines.
+
 [HTTPサーバ](http-server/)
 : [droonga-http-server](https://github.com/droonga/droonga-http-server)の使用方法。