Commits

Tetsuya Morimoto committed 7ed0cbe

updated version 0.4

Comments (0)

Files changed (20)

ikazuchi/build/doctrees/command_ref.doctree

Binary file modified.

ikazuchi/build/doctrees/environment.pickle

Binary file modified.

ikazuchi/build/doctrees/index.doctree

Binary file modified.

ikazuchi/build/doctrees/introduction.doctree

Binary file modified.

ikazuchi/build/doctrees/tips.doctree

Binary file modified.

ikazuchi/build/html/.buildinfo

 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: feb3e76d1add1c45dba516cda0f10d1c
+config: be87a734e6a9967e9e0ce582f1f87812
 tags: fbb0d17656682115ca4d033fb2f83ba1

ikazuchi/build/html/_sources/command_ref.txt

 All command option are::
 
     $ ikazuchi -h
-    Usage: ikazuchi [options]
+    usage: ikazuchi [-h] [-v] [-a API] [-d] [-e ENCODING] [-f LANG] [-l]
+                    [-p POFILE] [-q] [-r RSTFILE] [-s SENTENCE [SENTENCE ...]]
+                    [-t LANG]
 
-    Options:
-      --version             show program's version number and exit
+    optional arguments:
       -h, --help            show this help message and exit
-      -a API, --api=API     APIs are ['all', 'google', 'microsoft', 'yahoo'],
-                            'all' cannot use with '-p po_file' option
+      -v, --version         show program's version number and exit
+      -a API, --api API     APIs are ['google', 'microsoft']
       -d, --detect          detect language for target sentence
-      -f LANG, --from=LANG  original language
-      -t LANG, --to=LANG    target language to translate
-      -p POFILE, --pofile=POFILE
+      -e ENCODING, --encoding ENCODING
+                            input/output encoding
+      -f LANG, --from LANG  original language
+      -l, --languages       show supported languages
+      -p POFILE, --pofile POFILE
                             target po file
-      -s SENTENCE, --sentence=SENTENCE
-                            target sentence
-      -e ENCODING, --encoding=ENCODING
-                            input/output encoding
       -q, --quiet           not to show original sentence to stdout
-      -v, --verbose         show debug messages to stdout
+      -r RSTFILE, --rstfile RSTFILE
+                            target reST file
+      -s SENTENCE [SENTENCE ...], --sentences SENTENCE [SENTENCE ...]
+                            target sentences
+      -t LANG, --to LANG    target language to translate
 
 
 Translate with Command line
 ---------------------------
 
-write later
+Given multi sentences are translated on the fly. 
+
+::
+
+    $ ikazuchi -s "hello" "world"
+    sentence:                hello
+    translate(Google):       こんにちは 
+    sentence:                world
+    translate(Google):       世界
+
+.. note::
+
+    The argument which you want to translate is limitted to 127.
+
+If "sentence:" line is not needed, **-q** option cuts off it.
+
+::
+
+    $ ikazuchi -s "hello" "world" -q
+    translate(Google):       こんにちは 
+    translate(Google):       世界
+
+It can change the translate API with **-a** option.
+
+::
+
+    $ ikazuchi -a microsoft -s "hello" "world"
+    sentence:                hello
+    translate(Microsoft):    こんにちは
+    sentence:                world
+    translate(Microsoft):    世界
+
+It can change the source and destination languages with **-f** and **-t**
+option.  For example, it translates Japanese text to German.
+
+::
+
+    $ ikazuchi -a microsoft -f ja -t de -s "こんにちは世界"
+    sentence:                こんにちは世界
+    translate(Microsoft):    Hallo Welt-Beispiel
+
+It can detect languages with **-d** and **-s** option. You might think
+the result is not good looks when it is used Google detect API.
+
+::
+
+    $ ikazuchi -d -s "hello" "世界"
+    sentence:                hello
+    detect(Google):          [{u'isReliable': False, u'confidence': 0.01737435, u'language': u'en'}]
+    sentence:                世界
+    detect(Google):          [{u'isReliable': False, u'confidence': 0.08595319, u'language': u'zh-CN'}]
+
+    $ ikazuchi -d -s "hello" "世界" -a microsoft
+    sentence:                hello
+    detect(Microsoft):       en
+    sentence:                世界
+    detect(Microsoft):       zh-CHS
+
+You can confirm supported languages with **-l** option.
+
+::
+
+    $ ./bin/ikazuchi -l
+    languages(Google):       is    アイスランド語
+    languages(Google):       ga    アイルランド語
+    languages(Google):       az    アゼルバイジャン語
+    languages(Google):       af    アフリカーンス語
+    languages(Google):       ar    アラビア語
+    languages(Google):       sq    アルバニア語
+    languages(Google):       hy    アルメニア語
+    languages(Google):       it    イタリア語
+    languages(Google):       yi    イディッシュ語
+    languages(Google):       id    インドネシア語
+    languages(Google):       cy    ウェールズ語
+    languages(Google):       uk    ウクライナ語
+    languages(Google):       ur    ウルドゥ語
+    languages(Google):       et    エストニア語
+    languages(Google):       nl    オランダ語
+    languages(Google):       ca    カタロニア語
+    languages(Google):       gl    ガリシア語
+    languages(Google):       el    ギリシャ語
+    languages(Google):       ka    グルジア語
+    languages(Google):       ht    クレオール語(ハイチ)
+    languages(Google):       hr    クロアチア語
+    languages(Google):       sv    スウェーデン語
+    languages(Google):       es    スペイン語
+    languages(Google):       sk    スロバキア語
+    languages(Google):       sl    スロベニア語
+    languages(Google):       sw    スワヒリ語
+    languages(Google):       sr    セルビア語
+    languages(Google):       th    タイ語
+    languages(Google):       tl    タガログ語
+    languages(Google):       cs    チェコ語
+    languages(Google):       da    デンマーク語
+    languages(Google):       de    ドイツ語
+    languages(Google):       tr    トルコ語
+    languages(Google):       no    ノルウェー語
+    languages(Google):       eu    バスク語
+    languages(Google):       hu    ハンガリー語
+    languages(Google):       hi    ヒンディー語
+    languages(Google):       fi    フィンランド語
+    languages(Google):       fr    フランス語
+    languages(Google):       bg    ブルガリア語
+    languages(Google):       vi    ベトナム語
+    languages(Google):       iw    ヘブライ語
+    languages(Google):       be    ベラルーシ語
+    languages(Google):       fa    ペルシア語
+    languages(Google):       pl    ポーランド語
+    languages(Google):       pt    ポルトガル語
+    languages(Google):       mk    マケドニア語
+    languages(Google):       mt    マルタ語
+    languages(Google):       ms    マレー語
+    languages(Google):       la    ラテン語
+    languages(Google):       lv    ラトビア語
+    languages(Google):       lt    リトアニア語
+    languages(Google):       ro    ルーマニア語
+    languages(Google):       ru    ロシア語
+    languages(Google):       en    英語
+    languages(Google):       ko    韓国語
+    languages(Google):       zh    中国語(簡体)
+    languages(Google):       zh-TW 中国語(繁体)
+    languages(Google):       ja    日本語
 
 
 Translate with PO file
 ----------------------
 
-write later
+It can show good reference to translate msgid for PO file.
+Pass a po file with **-p** option.
+
+::
+
+    $ ikazuchi -a microsoft -p examples/short_test.po 
+
+If a current mgstr doesn't need to modify, just press enter key on terminal(``Input:``).
+
+::
+
+    msgid:                   ikazuchi translation
+    current msgstr:          いかずちの翻訳
+    reference(Microsoft):    雷の翻訳
+    Input:  
+    updated msgstr:          いかずちの翻訳
+
+To modify a current msgstr, input text on terminal(``Input:``).
+
+::
+
+    msgid:                   forest book
+    current msgstr:          もりのほん
+    reference(Microsoft):    森本
+    Input: 森のほん
+    updated msgstr:          森のほん
+
+The ``%x`` or ``%(name)x`` syntax is escaped for translation.
+
+::
+
+
+    msgid:                   the limit are %d.
+    current msgstr:          その制限は %d です
+    reference(Microsoft):    制限のある %d 。
+    Input: 制限は %d です
+    updated msgstr:          制限は %d です
+
+    msgid:                   replaced '%s' with something
+    current msgstr:          '%s' は何かで置き換えられます
+    reference(Microsoft):    交換 '%s' 何か
+    Input: 
+    updated msgstr:          '%s' は何かで置き換えられます
+
+If you want to use reference text, just input ``y`` on terminal(``Input:``).
+
+::
+
+    msgid:                   format string: "%(name)r"
+    reference(Microsoft):    フォーマット文字列: "%(name)r"
+    Input: y
+    updated msgstr:          フォーマット文字列: "%(name)r"
+
+
+Translate with RST file
+-----------------------
+
+It can translate rst file keeping the format. Pass a rst file with
+**-r** option. The progress status is represented ``.``.
+The result file is ``output.rst``.
+
+::
+
+    $ ikazuchi -r sample.rst
+    ....................................................................
+    $ ls output.rst 
+    output.rst
 
 
 Translate with Vim

ikazuchi/build/html/_sources/index.txt

 
 Now, `ikazuchi` is under development.
 
-* `ikazuchi` can use 3 APIs,
+* `ikazuchi` can use 2 APIs,
   `Google Translate API <http://code.google.com/intl/ja/apis/language/translate/overview.html>`_,
-  `Microsoft Translator <http://www.microsofttranslator.com/dev/>`_ and 
-  `Yahoo! Pipes <http://pipes.yahoo.com/pipes/>`_.
-
+  `Microsoft Translator <http://www.microsofttranslator.com/dev/>`_.
+  (`Yahoo! Pipes <http://pipes.yahoo.com/pipes/>`_ is not supported as formal feature.)
 * Translate GNU gettext catalog named PO file with good reference from web API
+* Translate reST document file keeping with the format
 * Translate any string passed from command line argument
 * Translate any string in Vim using ":pyfile" command
 * Detect language of any string passed from command line argument

ikazuchi/build/html/_sources/introduction.txt

    $ python bootstrap.py
    $ bin/buildout
 
+
 Quick Start
 ===========
 
 
     $ ikazuchi -d -s "hello"
     sentence:                hello
-    detect(Google):          en
+    detect(Google):          [{u'isReliable': False, u'confidence': 0.01737435, u'language': u'en'}]
 
 Or, you may translate PO file with reference.
+You can entered translation string for msgid after ``Input:``.
+Or just type "y" if you want to select reference string.
 
 ::
 
     $ ikazuchi -p examples/short_test.po 
-    msgid:                  forest book
-    reference(Google):      森林の本
-    Input: もりのほん
-    updated msgstr:         もりのほん
+    msgid:                   ikazuchi translation
+    current msgstr:          いかずちの翻訳
+    reference(Google):       雷の翻訳
+    Input:  
+    updated msgstr:          いかずちの翻訳
 
-    msgid:                  Python Module Of The Week
-    reference(Google):      今週のPythonモジュール
+    msgid:                   format string: "%(name)r"
+    reference(Google):       書式指定文字列: "%(name)r"
     Input: y
-    updated msgstr:         今週のPythonモジュール
+    updated msgstr:          書式指定文字列: "%(name)r"
 
-    msgid:                  ikazuchi translation
-    reference(Google):      雷の翻訳
-    Input:
-    updated msgstr:
+Additionally, RST file also can be translated keeping the format.
 
-You can entered translation string for msgid after "Input: ".
-Or just type "y" if you want to select reference string.
+::
+
+    $ ikazuchi -r sample.rst
+    ....................................................................
+    $ ls output.rst 
+    output.rst
 
 Default Options
 ---------------

ikazuchi/build/html/command_ref.html

   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>Command Reference &mdash; ikazuchi v0.3 documentation</title>
+    <title>Command Reference &mdash; ikazuchi v0.4 documentation</title>
     <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <link rel="stylesheet" href="_static/print.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.3',
+        VERSION:     '0.4',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/theme_extras.js"></script>
-    <link rel="top" title="ikazuchi v0.3 documentation" href="index.html" />
+    <link rel="top" title="ikazuchi v0.4 documentation" href="index.html" />
     <link rel="next" title="Tips" href="tips.html" />
     <link rel="prev" title="Introduction" href="introduction.html" /> 
   </head>
   <body>
       <div class="header"><h1 class="heading"><a href="index.html">
-          <span>ikazuchi v0.3 documentation</span></a></h1>
+          <span>ikazuchi v0.4 documentation</span></a></h1>
         <h2 class="heading"><span>Command Reference</span></h2>
       </div>
       <div class="topnav">
 <h2>Usage<a class="headerlink" href="#usage" title="Permalink to this headline">¶</a></h2>
 <p>All command option are:</p>
 <div class="highlight-python"><pre>$ ikazuchi -h
-Usage: ikazuchi [options]
+usage: ikazuchi [-h] [-v] [-a API] [-d] [-e ENCODING] [-f LANG] [-l]
+                [-p POFILE] [-q] [-r RSTFILE] [-s SENTENCE [SENTENCE ...]]
+                [-t LANG]
 
-Options:
-  --version             show program's version number and exit
+optional arguments:
   -h, --help            show this help message and exit
-  -a API, --api=API     APIs are ['all', 'google', 'microsoft', 'yahoo'],
-                        'all' cannot use with '-p po_file' option
+  -v, --version         show program's version number and exit
+  -a API, --api API     APIs are ['google', 'microsoft']
   -d, --detect          detect language for target sentence
-  -f LANG, --from=LANG  original language
-  -t LANG, --to=LANG    target language to translate
-  -p POFILE, --pofile=POFILE
+  -e ENCODING, --encoding ENCODING
+                        input/output encoding
+  -f LANG, --from LANG  original language
+  -l, --languages       show supported languages
+  -p POFILE, --pofile POFILE
                         target po file
-  -s SENTENCE, --sentence=SENTENCE
-                        target sentence
-  -e ENCODING, --encoding=ENCODING
-                        input/output encoding
   -q, --quiet           not to show original sentence to stdout
-  -v, --verbose         show debug messages to stdout</pre>
+  -r RSTFILE, --rstfile RSTFILE
+                        target reST file
+  -s SENTENCE [SENTENCE ...], --sentences SENTENCE [SENTENCE ...]
+                        target sentences
+  -t LANG, --to LANG    target language to translate</pre>
 </div>
 </div>
 <div class="section" id="translate-with-command-line">
 <h2>Translate with Command line<a class="headerlink" href="#translate-with-command-line" title="Permalink to this headline">¶</a></h2>
-<p>write later</p>
+<p>Given multi sentences are translated on the fly.</p>
+<div class="highlight-python"><pre>$ ikazuchi -s "hello" "world"
+sentence:                hello
+translate(Google):       こんにちは
+sentence:                world
+translate(Google):       世界</pre>
+</div>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">The argument which you want to translate is limitted to 127.</p>
+</div>
+<p>If &#8220;sentence:&#8221; line is not needed, <strong>-q</strong> option cuts off it.</p>
+<div class="highlight-python"><pre>$ ikazuchi -s "hello" "world" -q
+translate(Google):       こんにちは
+translate(Google):       世界</pre>
+</div>
+<p>It can change the translate API with <strong>-a</strong> option.</p>
+<div class="highlight-python"><pre>$ ikazuchi -a microsoft -s "hello" "world"
+sentence:                hello
+translate(Microsoft):    こんにちは
+sentence:                world
+translate(Microsoft):    世界</pre>
+</div>
+<p>It can change the source and destination languages with <strong>-f</strong> and <strong>-t</strong>
+option.  For example, it translates Japanese text to German.</p>
+<div class="highlight-python"><pre>$ ikazuchi -a microsoft -f ja -t de -s "こんにちは世界"
+sentence:                こんにちは世界
+translate(Microsoft):    Hallo Welt-Beispiel</pre>
+</div>
+<p>It can detect languages with <strong>-d</strong> and <strong>-s</strong> option. You might think
+the result is not good looks when it is used Google detect API.</p>
+<div class="highlight-python"><pre>$ ikazuchi -d -s "hello" "世界"
+sentence:                hello
+detect(Google):          [{u'isReliable': False, u'confidence': 0.01737435, u'language': u'en'}]
+sentence:                世界
+detect(Google):          [{u'isReliable': False, u'confidence': 0.08595319, u'language': u'zh-CN'}]
+
+$ ikazuchi -d -s "hello" "世界" -a microsoft
+sentence:                hello
+detect(Microsoft):       en
+sentence:                世界
+detect(Microsoft):       zh-CHS</pre>
+</div>
+<p>You can confirm supported languages with <strong>-l</strong> option.</p>
+<div class="highlight-python"><pre>$ ./bin/ikazuchi -l
+languages(Google):       is    アイスランド語
+languages(Google):       ga    アイルランド語
+languages(Google):       az    アゼルバイジャン語
+languages(Google):       af    アフリカーンス語
+languages(Google):       ar    アラビア語
+languages(Google):       sq    アルバニア語
+languages(Google):       hy    アルメニア語
+languages(Google):       it    イタリア語
+languages(Google):       yi    イディッシュ語
+languages(Google):       id    インドネシア語
+languages(Google):       cy    ウェールズ語
+languages(Google):       uk    ウクライナ語
+languages(Google):       ur    ウルドゥ語
+languages(Google):       et    エストニア語
+languages(Google):       nl    オランダ語
+languages(Google):       ca    カタロニア語
+languages(Google):       gl    ガリシア語
+languages(Google):       el    ギリシャ語
+languages(Google):       ka    グルジア語
+languages(Google):       ht    クレオール語(ハイチ)
+languages(Google):       hr    クロアチア語
+languages(Google):       sv    スウェーデン語
+languages(Google):       es    スペイン語
+languages(Google):       sk    スロバキア語
+languages(Google):       sl    スロベニア語
+languages(Google):       sw    スワヒリ語
+languages(Google):       sr    セルビア語
+languages(Google):       th    タイ語
+languages(Google):       tl    タガログ語
+languages(Google):       cs    チェコ語
+languages(Google):       da    デンマーク語
+languages(Google):       de    ドイツ語
+languages(Google):       tr    トルコ語
+languages(Google):       no    ノルウェー語
+languages(Google):       eu    バスク語
+languages(Google):       hu    ハンガリー語
+languages(Google):       hi    ヒンディー語
+languages(Google):       fi    フィンランド語
+languages(Google):       fr    フランス語
+languages(Google):       bg    ブルガリア語
+languages(Google):       vi    ベトナム語
+languages(Google):       iw    ヘブライ語
+languages(Google):       be    ベラルーシ語
+languages(Google):       fa    ペルシア語
+languages(Google):       pl    ポーランド語
+languages(Google):       pt    ポルトガル語
+languages(Google):       mk    マケドニア語
+languages(Google):       mt    マルタ語
+languages(Google):       ms    マレー語
+languages(Google):       la    ラテン語
+languages(Google):       lv    ラトビア語
+languages(Google):       lt    リトアニア語
+languages(Google):       ro    ルーマニア語
+languages(Google):       ru    ロシア語
+languages(Google):       en    英語
+languages(Google):       ko    韓国語
+languages(Google):       zh    中国語(簡体)
+languages(Google):       zh-TW 中国語(繁体)
+languages(Google):       ja    日本語</pre>
+</div>
 </div>
 <div class="section" id="translate-with-po-file">
 <h2>Translate with PO file<a class="headerlink" href="#translate-with-po-file" title="Permalink to this headline">¶</a></h2>
-<p>write later</p>
+<p>It can show good reference to translate msgid for PO file.
+Pass a po file with <strong>-p</strong> option.</p>
+<div class="highlight-python"><pre>$ ikazuchi -a microsoft -p examples/short_test.po</pre>
+</div>
+<p>If a current mgstr doesn&#8217;t need to modify, just press enter key on terminal(<tt class="docutils literal"><span class="pre">Input:</span></tt>).</p>
+<div class="highlight-python"><pre>msgid:                   ikazuchi translation
+current msgstr:          いかずちの翻訳
+reference(Microsoft):    雷の翻訳
+Input:
+updated msgstr:          いかずちの翻訳</pre>
+</div>
+<p>To modify a current msgstr, input text on terminal(<tt class="docutils literal"><span class="pre">Input:</span></tt>).</p>
+<div class="highlight-python"><pre>msgid:                   forest book
+current msgstr:          もりのほん
+reference(Microsoft):    森本
+Input: 森のほん
+updated msgstr:          森のほん</pre>
+</div>
+<p>The <tt class="docutils literal"><span class="pre">%x</span></tt> or <tt class="docutils literal"><span class="pre">%(name)x</span></tt> syntax is escaped for translation.</p>
+<div class="highlight-python"><pre>msgid:                   the limit are %d.
+current msgstr:          その制限は %d です
+reference(Microsoft):    制限のある %d 。
+Input: 制限は %d です
+updated msgstr:          制限は %d です
+
+msgid:                   replaced '%s' with something
+current msgstr:          '%s' は何かで置き換えられます
+reference(Microsoft):    交換 '%s' 何か
+Input:
+updated msgstr:          '%s' は何かで置き換えられます</pre>
+</div>
+<p>If you want to use reference text, just input <tt class="docutils literal"><span class="pre">y</span></tt> on terminal(<tt class="docutils literal"><span class="pre">Input:</span></tt>).</p>
+<div class="highlight-python"><pre>msgid:                   format string: "%(name)r"
+reference(Microsoft):    フォーマット文字列: "%(name)r"
+Input: y
+updated msgstr:          フォーマット文字列: "%(name)r"</pre>
+</div>
+</div>
+<div class="section" id="translate-with-rst-file">
+<h2>Translate with RST file<a class="headerlink" href="#translate-with-rst-file" title="Permalink to this headline">¶</a></h2>
+<p>It can translate rst file keeping the format. Pass a rst file with
+<strong>-r</strong> option. The progress status is represented <tt class="docutils literal"><span class="pre">.</span></tt>.
+The result file is <tt class="docutils literal"><span class="pre">output.rst</span></tt>.</p>
+<div class="highlight-python"><pre>$ ikazuchi -r sample.rst
+....................................................................
+$ ls output.rst
+output.rst</pre>
+</div>
 </div>
 <div class="section" id="translate-with-vim">
 <h2>Translate with Vim<a class="headerlink" href="#translate-with-vim" title="Permalink to this headline">¶</a></h2>

ikazuchi/build/html/genindex.html

   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>Index &mdash; ikazuchi v0.3 documentation</title>
+    <title>Index &mdash; ikazuchi v0.4 documentation</title>
     <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <link rel="stylesheet" href="_static/print.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.3',
+        VERSION:     '0.4',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/theme_extras.js"></script>
-    <link rel="top" title="ikazuchi v0.3 documentation" href="index.html" /> 
+    <link rel="top" title="ikazuchi v0.4 documentation" href="index.html" /> 
   </head>
   <body>
       <div class="header"><h1 class="heading"><a href="index.html">
-          <span>ikazuchi v0.3 documentation</span></a></h1>
+          <span>ikazuchi v0.4 documentation</span></a></h1>
         <h2 class="heading"><span>Index</span></h2>
       </div>
       <div class="topnav">

ikazuchi/build/html/index.html

   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>ikazuchi - simple translation helper &mdash; ikazuchi v0.3 documentation</title>
+    <title>ikazuchi - simple translation helper &mdash; ikazuchi v0.4 documentation</title>
     <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <link rel="stylesheet" href="_static/print.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.3',
+        VERSION:     '0.4',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/theme_extras.js"></script>
-    <link rel="top" title="ikazuchi v0.3 documentation" href="#" />
+    <link rel="top" title="ikazuchi v0.4 documentation" href="#" />
     <link rel="next" title="Introduction" href="introduction.html" /> 
   </head>
   <body>
       <div class="header"><h1 class="heading"><a href="#">
-          <span>ikazuchi v0.3 documentation</span></a></h1>
+          <span>ikazuchi v0.4 documentation</span></a></h1>
         <h2 class="heading"><span>ikazuchi - simple translation helper</span></h2>
       </div>
       <div class="topnav">
 <h2>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h2>
 <p>Now, <cite>ikazuchi</cite> is under development.</p>
 <ul class="simple">
-<li><cite>ikazuchi</cite> can use 3 APIs,
+<li><cite>ikazuchi</cite> can use 2 APIs,
 <a class="reference external" href="http://code.google.com/intl/ja/apis/language/translate/overview.html">Google Translate API</a>,
-<a class="reference external" href="http://www.microsofttranslator.com/dev/">Microsoft Translator</a> and
-<a class="reference external" href="http://pipes.yahoo.com/pipes/">Yahoo! Pipes</a>.</li>
+<a class="reference external" href="http://www.microsofttranslator.com/dev/">Microsoft Translator</a>.
+(<a class="reference external" href="http://pipes.yahoo.com/pipes/">Yahoo! Pipes</a> is not supported as formal feature.)</li>
 <li>Translate GNU gettext catalog named PO file with good reference from web API</li>
+<li>Translate reST document file keeping with the format</li>
 <li>Translate any string passed from command line argument</li>
 <li>Translate any string in Vim using &#8221;:pyfile&#8221; command</li>
 <li>Detect language of any string passed from command line argument</li>
 <li class="toctree-l2"><a class="reference internal" href="command_ref.html#usage">Usage</a></li>
 <li class="toctree-l2"><a class="reference internal" href="command_ref.html#translate-with-command-line">Translate with Command line</a></li>
 <li class="toctree-l2"><a class="reference internal" href="command_ref.html#translate-with-po-file">Translate with PO file</a></li>
+<li class="toctree-l2"><a class="reference internal" href="command_ref.html#translate-with-rst-file">Translate with RST file</a></li>
 <li class="toctree-l2"><a class="reference internal" href="command_ref.html#translate-with-vim">Translate with Vim</a></li>
 </ul>
 </li>

ikazuchi/build/html/introduction.html

   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>Introduction &mdash; ikazuchi v0.3 documentation</title>
+    <title>Introduction &mdash; ikazuchi v0.4 documentation</title>
     <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <link rel="stylesheet" href="_static/print.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.3',
+        VERSION:     '0.4',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/theme_extras.js"></script>
-    <link rel="top" title="ikazuchi v0.3 documentation" href="index.html" />
+    <link rel="top" title="ikazuchi v0.4 documentation" href="index.html" />
     <link rel="next" title="Command Reference" href="command_ref.html" />
     <link rel="prev" title="ikazuchi - simple translation helper" href="index.html" /> 
   </head>
   <body>
       <div class="header"><h1 class="heading"><a href="index.html">
-          <span>ikazuchi v0.3 documentation</span></a></h1>
+          <span>ikazuchi v0.4 documentation</span></a></h1>
         <h2 class="heading"><span>Introduction</span></h2>
       </div>
       <div class="topnav">
 <p>Also, to detect language is as follows.</p>
 <div class="highlight-python"><pre>$ ikazuchi -d -s "hello"
 sentence:                hello
-detect(Google):          en</pre>
+detect(Google):          [{u'isReliable': False, u'confidence': 0.01737435, u'language': u'en'}]</pre>
 </div>
-<p>Or, you may translate PO file with reference.</p>
+<p>Or, you may translate PO file with reference.
+You can entered translation string for msgid after <tt class="docutils literal"><span class="pre">Input:</span></tt>.
+Or just type &#8220;y&#8221; if you want to select reference string.</p>
 <div class="highlight-python"><pre>$ ikazuchi -p examples/short_test.po
-msgid:                  forest book
-reference(Google):      森林の本
-Input: もりのほん
-updated msgstr:         もりのほん
+msgid:                   ikazuchi translation
+current msgstr:          いかずちの翻訳
+reference(Google):       雷の翻訳
+Input:
+updated msgstr:          いかずちの翻訳
 
-msgid:                  Python Module Of The Week
-reference(Google):      今週のPythonモジュール
+msgid:                   format string: "%(name)r"
+reference(Google):       書式指定文字列: "%(name)r"
 Input: y
-updated msgstr:         今週のPythonモジュール
-
-msgid:                  ikazuchi translation
-reference(Google):      雷の翻訳
-Input:
-updated msgstr:</pre>
+updated msgstr:          書式指定文字列: "%(name)r"</pre>
 </div>
-<p>You can entered translation string for msgid after &#8220;Input: &#8221;.
-Or just type &#8220;y&#8221; if you want to select reference string.</p>
+<p>Additionally, RST file also can be translated keeping the format.</p>
+<div class="highlight-python"><pre>$ ikazuchi -r sample.rst
+....................................................................
+$ ls output.rst
+output.rst</pre>
+</div>
 <div class="section" id="default-options">
 <h3>Default Options<a class="headerlink" href="#default-options" title="Permalink to this headline">¶</a></h3>
 <p>By default, an original text passed to <cite>ikazuchi</cite> is English. And then,

ikazuchi/build/html/search.html

   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>Search &mdash; ikazuchi v0.3 documentation</title>
+    <title>Search &mdash; ikazuchi v0.4 documentation</title>
     <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <link rel="stylesheet" href="_static/print.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.3',
+        VERSION:     '0.4',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/searchtools.js"></script>
     <script type="text/javascript" src="_static/theme_extras.js"></script>
-    <link rel="top" title="ikazuchi v0.3 documentation" href="index.html" />
+    <link rel="top" title="ikazuchi v0.4 documentation" href="index.html" />
   <script type="text/javascript">
     jQuery(function() { Search.loadIndex("searchindex.js"); });
   </script>
   </head>
   <body>
       <div class="header"><h1 class="heading"><a href="index.html">
-          <span>ikazuchi v0.3 documentation</span></a></h1>
+          <span>ikazuchi v0.4 documentation</span></a></h1>
         <h2 class="heading"><span>Search</span></h2>
       </div>
       <div class="topnav">

ikazuchi/build/html/searchindex.js

-Search.setIndex({objects:{},terms:{all:2,help:[1,2],execut:[],show:2,text:[0,2,3],verbos:2,"\u68ee\u6797\u306e\u672c":[0,3],sleep:3,gettext:1,follow:[0,1,2,3],rough:3,languag:[0,1,2],consider:[],web:1,onli:2,explicitli:3,number:2,just:[0,2],also:[0,1,3],msgid:[0,3],short_test:[0,3],littl:3,program:[2,3],reffrenc:[],under:1,input:[0,2,3],python2:2,might:3,cui:1,bin:0,good:[1,3],"return":[2,3],string:[0,1],later:2,mayb:0,python:[0,2,3],sentenc:[0,2,3],autom:3,raimei_api:2,built:2,cannot:2,"\u96f7\u306e\u7ffb\u8a33":[0,3],veri:0,"\u304b\u304d\u304f\u3051\u3053":[],now:1,enter:0,introduct:[0,1],term:[1,3],document:1,enabl:2,emb:2,simpl:1,arbitrari:2,"\u3055\u3057\u3059\u305b\u305d":[],api:[0,1,2,3],mode:2,each:[1,3],quick:[0,1],output:[2,3],page:1,librari:[2,3],mean:[2,3],pleas:2,prohibit:3,set:2,map:2,terms_of_us:[],some:[2,3],po_fil:2,see:[1,3],pass:[0,1,2],intend:[1,2],cat:3,"2pyfil":2,tmp:3,index:1,detect:[0,1,2],buildout:0,inconveni:2,confirm:0,invok:[],content:[1,3],when:3,version:2,exit:2,between:[0,3],print:[],got:[],how:2,keybind:2,ref:3,note:[2,3],refer:[0,1,2,3],core:[2,3],run:[0,2],kei:2,gener:3,usag:[1,2],msgstr:[0,3],like:[2,3],debug:2,"\u30a8\u30f3\u30b3\u30fc\u30c9":3,let:2,org:0,raimei:2,sinc:1,src:[],search:1,vimrc:2,howev:3,current:[2,3],quiet:2,izuchi:[2,3],keep:3,raimei_from:2,chang:2,other:[1,2],"\u4eca\u9031\u306epython\u30e2\u30b8\u30e5\u30fc\u30eb":[0,3],origin:[0,2],pofil:2,configur:2,effici:[1,3],"\u79c1\u306f\u512a\u79c0\u306a\u30d7\u30ed\u30b0\u30e9\u30de\u30fc\u306b\u306a\u308a\u305f\u3044\u3067\u3059":3,feel:2,modul:[0,1,3],encod:[1,2,3],easy_instal:0,automat:[],vim:[1,2],"\u79c1\u306fpython\u30d7\u30ed\u30b0\u30e9\u30df\u30f3\u30b0\u304c\u597d\u304d\u3067\u3059":3,done:3,euc:3,path:2,txt:3,your:[0,2,3],select:0,second:2,differ:3,from:[0,1,2,3],silent:2,workaround:2,script:2,addition:3,"\u3082\u308a\u306e\u307b\u3093":[0,3],stdout:2,"\u3042\u3044\u3046\u3048\u304a":[],messag:2,"\u79c1\u306fpython\u30d7\u30ed\u30b0\u30e9\u30df\u30f3\u30b0\u304c\u597d\u304d":2,few:2,call:2,usr:2,recommend:3,taken:0,termin:3,strictli:3,raimei_to:2,type:[0,3],start:[0,1,2],more:3,shell:[1,3],option:[0,2,3],name:1,handl:2,tool:[1,2],copi:2,yahoo:[1,2],argument:1,link:2,translat:[0,1,2,3],sens:3,ikazuchi:[0,1,2,3],line:[1,2,3],those:1,must:3,"case":0,kind:3,utf:3,target:[0,2,3],gnu:1,"default":[0,3],setup:[0,1],work:[1,3],batch:3,charact:[1,3],"while":3,can:[0,1,2,3],abov:2,site:2,embed:[2,3],purpos:3,short_test_euc:3,bootstrap:0,have:2,helper:1,ctrl:2,py2:2,mind:3,ani:[1,3],indic:1,aaaa:[],packag:2,replac:3,simpli:[0,3],shortcut:2,file:[0,1,2,3],tabl:1,need:3,featur:1,echo:[2,3],develop:1,nkf:3,want:[0,1,2,3],make:[0,2,3],get:[2,3],tip:[1,3],same:0,write:2,ja_jp:[0,3],book:[0,3],read:3,forest:[0,3],which:3,answer:[],command:[0,1,2,3],you:[0,1,2,3],"\u79c1\u306f\u7ffb\u8a33\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059":[0,2,3],pythoninterp:2,hello:0,updat:[0,3],week:[0,3],variabl:[0,2,3],sure:2,http:0,though:3,utf8:[0,3],clone:0,after:[0,2],befor:2,catalog:1,pyfil:[1,2],queri:3,user:3,consid:[],deploi:2,mai:[0,3],googl:[0,1,2,3],techniqu:3,lang:[0,2,3],bitbucket:0,give:3,lib:2,directori:2,t2y:0,think:2,pipe:1,exampl:[0,2,3],environ:[0,3],thi:[0,2,3],english:0,programm:3,"\u68ee\u306e\u672c":3,egg:2,microsoft:[1,2],"\u3042\u3044\u3046\u3048\u304a\u304b\u304d\u304f\u3051\u3053\u3055\u3057\u3059\u305b\u305d":[]},objtypes:{},titles:["Introduction","ikazuchi - simple translation helper","Command Reference","Tips"],objnames:{},filenames:["introduction","index","command_ref","tips"]})
+Search.setIndex({objects:{},terms:{all:2,consider:[],"\u30de\u30b1\u30c9\u30cb\u30a2\u8a9e":2,sleep:3,follow:[0,1,2,3],keybind:2,content:[1,3],program:[2,3],reffrenc:[],under:1,sens:3,sourc:2,string:[0,1,2],"\u30c1\u30a7\u30b3\u8a9e":2,fals:[0,2],"\u30bf\u30a4\u8a9e":2,"\u3082\u308a\u306e\u307b\u3093":[2,3],veri:0,"\u30ac\u30ea\u30b7\u30a2\u8a9e":2,"\u30bf\u30ac\u30ed\u30b0\u8a9e":2,"\u30a2\u30a4\u30b9\u30e9\u30f3\u30c9\u8a9e":2,quick:[0,1],pleas:2,terms_of_us:[],second:2,pass:[0,1,2],"\u30cf\u30a4\u30c1":2,"2pyfil":2,index:1,invok:[],current:[0,2,3],version:2,"\u5236\u9650\u306f":2,"\u30a2\u30a4\u30eb\u30e9\u30f3\u30c9\u8a9e":2,gener:3,"\u30a6\u30a7\u30fc\u30eb\u30ba\u8a9e":2,"\u30a8\u30f3\u30b3\u30fc\u30c9":3,let:2,path:2,modifi:2,sinc:1,"\u30a2\u30eb\u30d0\u30cb\u30a2\u8a9e":2,search:1,izuchi:[2,3],"\u30ce\u30eb\u30a6\u30a7\u30fc\u8a9e":2,chang:2,"\u306f\u4f55\u304b\u3067\u7f6e\u304d\u63db\u3048\u3089\u308c\u307e\u3059":2,modul:[1,3],vim:[1,2],api:[0,1,2,3],isreli:[0,2],txt:3,select:0,"\u30c8\u30eb\u30b3\u8a9e":2,"\u30a6\u30af\u30e9\u30a4\u30ca\u8a9e":2,ctrl:2,few:2,call:2,usr:2,recommend:3,taken:0,type:[0,3],more:3,nkf:3,yahoo:1,ikazuchi:[0,1,2,3],must:3,fly:2,setup:[0,1],work:[1,3],cat:3,can:[0,1,2,3],purpos:3,short_test_euc:3,"\u30a2\u30bc\u30eb\u30d0\u30a4\u30b8\u30e3\u30f3\u8a9e":2,"\u30af\u30ec\u30aa\u30fc\u30eb\u8a9e":2,give:3,indic:1,aaaa:[],"\u30ea\u30c8\u30a2\u30cb\u30a2\u8a9e":2,want:[0,1,2,3],"\u66f8\u5f0f\u6307\u5b9a\u6587\u5b57\u5217":0,write:[],how:2,forest:[2,3],answer:[],simpl:1,updat:[0,2,3],map:2,clone:0,after:[0,2],"\u30b9\u30ed\u30d9\u30cb\u30a2\u8a9e":2,befor:2,catalog:1,pyfil:[1,2],mai:[0,3],read:3,bootstrap:0,environ:[0,3],enter:[0,2],egg:2,help:[1,2],"\u30b9\u30ed\u30d0\u30ad\u30a2\u8a9e":2,euc:3,might:[2,3],good:[1,2,3],"return":[2,3],python:[0,2,3],sentenc:[0,2,3],now:1,introduct:[0,1],term:[1,3],name:[0,1,2],"\u30b9\u30a6\u30a7\u30fc\u30c7\u30f3\u8a9e":2,"\u3055\u3057\u3059\u305b\u305d":[],"\u30cf\u30f3\u30ac\u30ea\u30fc\u8a9e":2,mode:2,each:[1,3],debug:[],confid:[0,2],mean:[2,3],prohibit:3,replac:[2,3],variabl:[0,2,3],"\u30b0\u30eb\u30b8\u30a2\u8a9e":2,print:[],got:[],ref:3,given:2,org:0,"\u30da\u30eb\u30b7\u30a2\u8a9e":2,keep:[0,1,2,3],think:2,origin:[0,2],pofil:2,note:[2,3],feel:2,number:2,echo:[2,3],"\u79c1\u306fpython\u30d7\u30ed\u30b0\u30e9\u30df\u30f3\u30b0\u304c\u597d\u304d\u3067\u3059":3,done:3,differ:3,silent:2,workaround:2,script:2,messag:2,"\u30e9\u30c8\u30d3\u30a2\u8a9e":2,termin:[2,3],shell:[1,3],option:[0,2,3],"\u304b\u304d\u304f\u3051\u3053":[],tool:[1,2],copi:2,rst:[0,1,2],strictli:3,kind:3,target:[0,2,3],"\u68ee\u306e\u307b\u3093":2,charact:[1,3],"\u30c9\u30a4\u30c4\u8a9e":2,"\u30a6\u30eb\u30c9\u30a5\u8a9e":2,py2:2,mind:3,argument:[1,2],"\u30eb\u30fc\u30de\u30cb\u30a2\u8a9e":2,packag:2,"\u68ee\u306e\u672c":3,have:2,tabl:1,need:[2,3],techniqu:3,lib:2,"\u3053\u3093\u306b\u3061\u306f":2,also:[0,1,3],which:[2,3],command:[0,1,2,3],"\u79c1\u306f\u7ffb\u8a33\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u307e\u3059":[0,2,3],sure:2,though:3,deploi:2,later:[],pipe:1,raimei_to:2,microsoft:[1,2],show:2,german:2,text:[0,2,3],verbos:[],syntax:2,"\u65e5\u672c\u8a9e":2,rough:3,t2y:0,onli:2,explicitli:3,execut:[],"\u30ae\u30ea\u30b7\u30e3\u8a9e":2,configur:2,"\u30d5\u30a9\u30fc\u30de\u30c3\u30c8\u6587\u5b57\u5217":2,get:[2,3],"\u30b9\u30ef\u30d2\u30ea\u8a9e":2,"\u30a8\u30b9\u30c8\u30cb\u30a2\u8a9e":2,autom:3,"\u3053\u3093\u306b\u3061\u306f\u4e16\u754c":2,cannot:[],"\u4eca\u9031\u306epython\u30e2\u30b8\u30e5\u30fc\u30eb":3,emb:2,"\u30aa\u30e9\u30f3\u30c0\u8a9e":2,set:2,po_fil:[],see:[1,3],result:2,"\u30b9\u30da\u30a4\u30f3\u8a9e":2,"\u30d9\u30c8\u30ca\u30e0\u8a9e":2,statu:2,detect:[0,1,2],inconveni:2,someth:2,between:[0,3],progress:2,"\u30de\u30ec\u30fc\u8a9e":2,kei:2,mgstr:2,vimrc:2,"\u30d5\u30e9\u30f3\u30b9\u8a9e":2,howev:3,quiet:2,raimei_from:2,simpli:[0,3],"\u79c1\u306f\u512a\u79c0\u306a\u30d7\u30ed\u30b0\u30e9\u30de\u30fc\u306b\u306a\u308a\u305f\u3044\u3067\u3059":3,"\u30d6\u30eb\u30ac\u30ea\u30a2\u8a9e":2,"\u30e9\u30c6\u30f3\u8a9e":2,"\u30a2\u30d5\u30ea\u30ab\u30fc\u30f3\u30b9\u8a9e":2,addition:[0,3],"\u30d5\u30a3\u30f3\u30e9\u30f3\u30c9\u8a9e":2,"\u79c1\u306fpython\u30d7\u30ed\u30b0\u30e9\u30df\u30f3\u30b0\u304c\u597d\u304d":2,"\u30a4\u30f3\u30c9\u30cd\u30b7\u30a2\u8a9e":2,beispiel:2,ani:[1,3],"\u97d3\u56fd\u8a9e":2,"\u3042\u3044\u3046\u3048\u304a\u304b\u304d\u304f\u3051\u3053\u3055\u3057\u3059\u305b\u305d":[],those:1,"case":0,multi:2,"\u30a2\u30eb\u30e1\u30cb\u30a2\u8a9e":2,raimei:2,look:2,gnu:1,batch:3,"while":3,abov:2,"\u30d9\u30e9\u30eb\u30fc\u30b7\u8a9e":2,helper:1,stdout:2,site:2,destin:2,"\u3044\u304b\u305a\u3061\u306e\u7ffb\u8a33":[0,2],develop:1,japanes:2,make:[0,2,3],format:[0,1,2],same:0,ja_jp:[0,3],raimei_api:2,document:1,week:3,http:0,utf8:[0,3],user:3,littl:3,built:2,off:2,"\u30d8\u30d6\u30e9\u30a4\u8a9e":2,exampl:[0,2,3],welt:2,thi:[0,2,3],english:0,programm:3,just:[0,2],tip:[1,3],rest:[1,2],languag:[0,1,2],web:1,cut:2,msgid:[0,2,3],short_test:[0,2,3],shortcut:2,"\u4e2d\u56fd\u8a9e":2,input:[0,2,3],formal:1,cui:1,bin:[0,2],"\u68ee\u6797\u306e\u672c":3,mayb:0,handl:2,"\u3042\u3044\u3046\u3048\u304a":[],press:2,world:2,python2:2,"\u30dd\u30fc\u30e9\u30f3\u30c9\u8a9e":2,like:[2,3],arbitrari:2,output:[0,2,3],page:1,"\u30d2\u30f3\u30c7\u30a3\u30fc\u8a9e":2,some:[2,3],sampl:[0,2],intend:[1,2],librari:[2,3],tmp:3,buildout:0,confirm:[0,2],exit:2,"\u96f7\u306e\u7ffb\u8a33":[0,2,3],refer:[0,1,2,3],"\u30ab\u30bf\u30ed\u30cb\u30a2\u8a9e":2,core:[2,3],run:[0,2],usag:[1,2],from:[0,1,2,3],src:[],book:[2,3],effici:[1,3],"\u30d0\u30b9\u30af\u8a9e":2,encod:[1,2,3],easy_instal:0,automat:[],your:[0,2,3],hallo:2,msgstr:[0,2,3],support:[1,2],enabl:2,"\u5236\u9650\u306e\u3042\u308b":2,start:[0,1,2],rstfile:2,"\u30af\u30ed\u30a2\u30c1\u30a2\u8a9e":2,"\u30ed\u30b7\u30a2\u8a9e":2,link:2,translat:[0,1,2,3],line:[1,2,3],utf:3,"default":[0,3],limit:2,embed:[2,3],featur:1,"\u30a4\u30bf\u30ea\u30a2\u8a9e":2,doesn:2,repres:2,file:[0,1,2,3],"\u30de\u30eb\u30bf\u8a9e":2,googl:[0,1,2,3],when:[2,3],gettext:1,other:[1,2],"\u30a4\u30c7\u30a3\u30c3\u30b7\u30e5\u8a9e":2,you:[0,1,2,3],pythoninterp:2,"\u305d\u306e\u5236\u9650\u306f":2,"\u30bb\u30eb\u30d3\u30a2\u8a9e":2,"\u30c7\u30f3\u30de\u30fc\u30af\u8a9e":2,"\u30a2\u30e9\u30d3\u30a2\u8a9e":2,queri:3,consid:[],lang:[0,2,3],bitbucket:0,directori:2,"\u30dd\u30eb\u30c8\u30ac\u30eb\u8a9e":2,escap:2,hello:[0,2]},objtypes:{},titles:["Introduction","ikazuchi - simple translation helper","Command Reference","Tips"],objnames:{},filenames:["introduction","index","command_ref","tips"]})

ikazuchi/build/html/tips.html

   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>Tips &mdash; ikazuchi v0.3 documentation</title>
+    <title>Tips &mdash; ikazuchi v0.4 documentation</title>
     <link rel="stylesheet" href="_static/haiku.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     <link rel="stylesheet" href="_static/print.css" type="text/css" />
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '0.3',
+        VERSION:     '0.4',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/theme_extras.js"></script>
-    <link rel="top" title="ikazuchi v0.3 documentation" href="index.html" />
+    <link rel="top" title="ikazuchi v0.4 documentation" href="index.html" />
     <link rel="prev" title="Command Reference" href="command_ref.html" /> 
   </head>
   <body>
       <div class="header"><h1 class="heading"><a href="index.html">
-          <span>ikazuchi v0.3 documentation</span></a></h1>
+          <span>ikazuchi v0.4 documentation</span></a></h1>
         <h2 class="heading"><span>Tips</span></h2>
       </div>
       <div class="topnav">

ikazuchi/source/command_ref.rst

 All command option are::
 
     $ ikazuchi -h
-    Usage: ikazuchi [options]
+    usage: ikazuchi [-h] [-v] [-a API] [-d] [-e ENCODING] [-f LANG] [-l]
+                    [-p POFILE] [-q] [-r RSTFILE] [-s SENTENCE [SENTENCE ...]]
+                    [-t LANG]
 
-    Options:
-      --version             show program's version number and exit
+    optional arguments:
       -h, --help            show this help message and exit
-      -a API, --api=API     APIs are ['all', 'google', 'microsoft', 'yahoo'],
-                            'all' cannot use with '-p po_file' option
+      -v, --version         show program's version number and exit
+      -a API, --api API     APIs are ['google', 'microsoft']
       -d, --detect          detect language for target sentence
-      -f LANG, --from=LANG  original language
-      -t LANG, --to=LANG    target language to translate
-      -p POFILE, --pofile=POFILE
+      -e ENCODING, --encoding ENCODING
+                            input/output encoding
+      -f LANG, --from LANG  original language
+      -l, --languages       show supported languages
+      -p POFILE, --pofile POFILE
                             target po file
-      -s SENTENCE, --sentence=SENTENCE
-                            target sentence
-      -e ENCODING, --encoding=ENCODING
-                            input/output encoding
       -q, --quiet           not to show original sentence to stdout
-      -v, --verbose         show debug messages to stdout
+      -r RSTFILE, --rstfile RSTFILE
+                            target reST file
+      -s SENTENCE [SENTENCE ...], --sentences SENTENCE [SENTENCE ...]
+                            target sentences
+      -t LANG, --to LANG    target language to translate
 
 
 Translate with Command line
 ---------------------------
 
-write later
+Given multi sentences are translated on the fly. 
+
+::
+
+    $ ikazuchi -s "hello" "world"
+    sentence:                hello
+    translate(Google):       こんにちは 
+    sentence:                world
+    translate(Google):       世界
+
+.. note::
+
+    The argument which you want to translate is limitted to 127.
+
+If "sentence:" line is not needed, **-q** option cuts off it.
+
+::
+
+    $ ikazuchi -s "hello" "world" -q
+    translate(Google):       こんにちは 
+    translate(Google):       世界
+
+It can change the translate API with **-a** option.
+
+::
+
+    $ ikazuchi -a microsoft -s "hello" "world"
+    sentence:                hello
+    translate(Microsoft):    こんにちは
+    sentence:                world
+    translate(Microsoft):    世界
+
+It can change the source and destination languages with **-f** and **-t**
+option.  For example, it translates Japanese text to German.
+
+::
+
+    $ ikazuchi -a microsoft -f ja -t de -s "こんにちは世界"
+    sentence:                こんにちは世界
+    translate(Microsoft):    Hallo Welt-Beispiel
+
+It can detect languages with **-d** and **-s** option. You might think
+the result is not good looks when it is used Google detect API.
+
+::
+
+    $ ikazuchi -d -s "hello" "世界"
+    sentence:                hello
+    detect(Google):          [{u'isReliable': False, u'confidence': 0.01737435, u'language': u'en'}]
+    sentence:                世界
+    detect(Google):          [{u'isReliable': False, u'confidence': 0.08595319, u'language': u'zh-CN'}]
+
+    $ ikazuchi -d -s "hello" "世界" -a microsoft
+    sentence:                hello
+    detect(Microsoft):       en
+    sentence:                世界
+    detect(Microsoft):       zh-CHS
+
+You can confirm supported languages with **-l** option.
+
+::
+
+    $ ./bin/ikazuchi -l
+    languages(Google):       is    アイスランド語
+    languages(Google):       ga    アイルランド語
+    languages(Google):       az    アゼルバイジャン語
+    languages(Google):       af    アフリカーンス語
+    languages(Google):       ar    アラビア語
+    languages(Google):       sq    アルバニア語
+    languages(Google):       hy    アルメニア語
+    languages(Google):       it    イタリア語
+    languages(Google):       yi    イディッシュ語
+    languages(Google):       id    インドネシア語
+    languages(Google):       cy    ウェールズ語
+    languages(Google):       uk    ウクライナ語
+    languages(Google):       ur    ウルドゥ語
+    languages(Google):       et    エストニア語
+    languages(Google):       nl    オランダ語
+    languages(Google):       ca    カタロニア語
+    languages(Google):       gl    ガリシア語
+    languages(Google):       el    ギリシャ語
+    languages(Google):       ka    グルジア語
+    languages(Google):       ht    クレオール語(ハイチ)
+    languages(Google):       hr    クロアチア語
+    languages(Google):       sv    スウェーデン語
+    languages(Google):       es    スペイン語
+    languages(Google):       sk    スロバキア語
+    languages(Google):       sl    スロベニア語
+    languages(Google):       sw    スワヒリ語
+    languages(Google):       sr    セルビア語
+    languages(Google):       th    タイ語
+    languages(Google):       tl    タガログ語
+    languages(Google):       cs    チェコ語
+    languages(Google):       da    デンマーク語
+    languages(Google):       de    ドイツ語
+    languages(Google):       tr    トルコ語
+    languages(Google):       no    ノルウェー語
+    languages(Google):       eu    バスク語
+    languages(Google):       hu    ハンガリー語
+    languages(Google):       hi    ヒンディー語
+    languages(Google):       fi    フィンランド語
+    languages(Google):       fr    フランス語
+    languages(Google):       bg    ブルガリア語
+    languages(Google):       vi    ベトナム語
+    languages(Google):       iw    ヘブライ語
+    languages(Google):       be    ベラルーシ語
+    languages(Google):       fa    ペルシア語
+    languages(Google):       pl    ポーランド語
+    languages(Google):       pt    ポルトガル語
+    languages(Google):       mk    マケドニア語
+    languages(Google):       mt    マルタ語
+    languages(Google):       ms    マレー語
+    languages(Google):       la    ラテン語
+    languages(Google):       lv    ラトビア語
+    languages(Google):       lt    リトアニア語
+    languages(Google):       ro    ルーマニア語
+    languages(Google):       ru    ロシア語
+    languages(Google):       en    英語
+    languages(Google):       ko    韓国語
+    languages(Google):       zh    中国語(簡体)
+    languages(Google):       zh-TW 中国語(繁体)
+    languages(Google):       ja    日本語
 
 
 Translate with PO file
 ----------------------
 
-write later
+It can show good reference to translate msgid for PO file.
+Pass a po file with **-p** option.
+
+::
+
+    $ ikazuchi -a microsoft -p examples/short_test.po 
+
+If a current mgstr doesn't need to modify, just press enter key on terminal(``Input:``).
+
+::
+
+    msgid:                   ikazuchi translation
+    current msgstr:          いかずちの翻訳
+    reference(Microsoft):    雷の翻訳
+    Input:  
+    updated msgstr:          いかずちの翻訳
+
+To modify a current msgstr, input text on terminal(``Input:``).
+
+::
+
+    msgid:                   forest book
+    current msgstr:          もりのほん
+    reference(Microsoft):    森本
+    Input: 森のほん
+    updated msgstr:          森のほん
+
+The ``%x`` or ``%(name)x`` syntax is escaped for translation.
+
+::
+
+
+    msgid:                   the limit are %d.
+    current msgstr:          その制限は %d です
+    reference(Microsoft):    制限のある %d 。
+    Input: 制限は %d です
+    updated msgstr:          制限は %d です
+
+    msgid:                   replaced '%s' with something
+    current msgstr:          '%s' は何かで置き換えられます
+    reference(Microsoft):    交換 '%s' 何か
+    Input: 
+    updated msgstr:          '%s' は何かで置き換えられます
+
+If you want to use reference text, just input ``y`` on terminal(``Input:``).
+
+::
+
+    msgid:                   format string: "%(name)r"
+    reference(Microsoft):    フォーマット文字列: "%(name)r"
+    Input: y
+    updated msgstr:          フォーマット文字列: "%(name)r"
+
+
+Translate with RST file
+-----------------------
+
+It can translate rst file keeping the format. Pass a rst file with
+**-r** option. The progress status is represented ``.``.
+The result file is ``output.rst``.
+
+::
+
+    $ ikazuchi -r sample.rst
+    ....................................................................
+    $ ls output.rst 
+    output.rst
 
 
 Translate with Vim

ikazuchi/source/conf.py

 # The short X.Y version.
 version = '0.1'
 # The full version, including alpha/beta/rc tags.
-release = '0.3'
+release = '0.4'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

ikazuchi/source/index.rst

 
 Now, `ikazuchi` is under development.
 
-* `ikazuchi` can use 3 APIs,
+* `ikazuchi` can use 2 APIs,
   `Google Translate API <http://code.google.com/intl/ja/apis/language/translate/overview.html>`_,
-  `Microsoft Translator <http://www.microsofttranslator.com/dev/>`_ and 
-  `Yahoo! Pipes <http://pipes.yahoo.com/pipes/>`_.
-
+  `Microsoft Translator <http://www.microsofttranslator.com/dev/>`_.
+  (`Yahoo! Pipes <http://pipes.yahoo.com/pipes/>`_ is not supported as formal feature.)
 * Translate GNU gettext catalog named PO file with good reference from web API
+* Translate reST document file keeping with the format
 * Translate any string passed from command line argument
 * Translate any string in Vim using ":pyfile" command
 * Detect language of any string passed from command line argument

ikazuchi/source/introduction.rst

    $ python bootstrap.py
    $ bin/buildout
 
+
 Quick Start
 ===========
 
 
     $ ikazuchi -d -s "hello"
     sentence:                hello
-    detect(Google):          en
+    detect(Google):          [{u'isReliable': False, u'confidence': 0.01737435, u'language': u'en'}]
 
 Or, you may translate PO file with reference.
+You can entered translation string for msgid after ``Input:``.
+Or just type "y" if you want to select reference string.
 
 ::
 
     $ ikazuchi -p examples/short_test.po 
-    msgid:                  forest book
-    reference(Google):      森林の本
-    Input: もりのほん
-    updated msgstr:         もりのほん
+    msgid:                   ikazuchi translation
+    current msgstr:          いかずちの翻訳
+    reference(Google):       雷の翻訳
+    Input:  
+    updated msgstr:          いかずちの翻訳
 
-    msgid:                  Python Module Of The Week
-    reference(Google):      今週のPythonモジュール
+    msgid:                   format string: "%(name)r"
+    reference(Google):       書式指定文字列: "%(name)r"
     Input: y
-    updated msgstr:         今週のPythonモジュール
+    updated msgstr:          書式指定文字列: "%(name)r"
 
-    msgid:                  ikazuchi translation
-    reference(Google):      雷の翻訳
-    Input:
-    updated msgstr:
+Additionally, RST file also can be translated keeping the format.
 
-You can entered translation string for msgid after "Input: ".
-Or just type "y" if you want to select reference string.
+::
+
+    $ ikazuchi -r sample.rst
+    ....................................................................
+    $ ls output.rst 
+    output.rst
 
 Default Options
 ---------------