2014年2月26日水曜日、James
Peach<jpe...@apache.org<javascript:_e(%7B%7D,'cvml','jpe...@apache.org');>
>さんは書きました:

> On Feb 25, 2014, at 2:52 AM, masaori335 <g...@git.apache.org> wrote:
>
> > GitHub user masaori335 opened a pull request:
> >
> >    https://github.com/apache/trafficserver/pull/45
> >
> >    Translate 4.2.x documents to Japanese
>
> Wow, this is great!
>
> I pulled it into a private branch and tried to build it using sphinx 1.1.3
> but did not get any Japanese documentation generated. Do we need to make
> some build system changes for this to work correctly?


Oh, we need 'sphinx-intl' and sphinx 1.2 or higher.
- sphinx-intl: https://pypi.python.org/pypi/sphinx-intl

The build commands are following.

----
$ cd doc
$ sphinx-intl build -p locale/ -l ja
$ sphinx-build -b html -D language=ja . ./build
----

On the ReadTheDocs, we need only 'polib'. This settings has already
been proposed and merged in the apache/trafficserver #13.
But this works only in the ReadTheDocs environment. So, using sphinx-intl
is easier.

- https://github.com/apache/trafficserver/pull/13


> >    We (masaori335, maskit and syucream) translated some parts of 4.2.x
> documents in Japanese.
> >
> >    Actually we have not finished our work, but we think this is the best
> timing to send this pull-request.
> >    The reasons are following.
> >
> >    1. We know ATS community is planning to release 4.2.x in this month
> and 5.0.x in May.
> >       In my opinion, 5.0.x has big changes from 4.2.x and documents will
> have those changes too.
> >
> >    2. We want to serve both 4.2.x and 5.x.x documents in Japanese on the
> ReadTheDocs.
> >
> >    If there are no problems, please merge to both master and 4.2.x
> branch.
> >    We'll pull the 4.2.x branch to our repository and serve it on
> ReadTheDocs.
> >
> >    Finally, we are following sphinx internationalization workflow.
> >    So, all changes are placed in the po files.
> >
> >    - http://sphinx-doc.org/intl.html
> >
> > You can merge this pull request into a Git repository by running:
> >
> >    $ git pull 
> > https://github.com/trafficserver-doc-ja/trafficserver4.2.x_doc-ja
> >
> > Alternatively you can review and apply these changes as the patch at:
> >
> >    https://github.com/apache/trafficserver/pull/45.patch
> >
> > To close this pull request, make a commit to your master/trunk branch
> > with (at least) the following in the commit message:
> >
> >    This closes #45
> >
> > ----
> > commit dac67d2264d1a6babc4a2efe7d3a6e8816d18ea6
> > Author: Masaori Koshiba <masaori...@gmail.com>
> > Date:   2013-11-08T09:00:20Z
> >
> >    Doc: Generate *.po files for Japanese translations
> >
> > commit 7916f77ed454324a6a9586252f41e840e463c155
> > Author: Masaori Koshiba <masaori...@gmail.com>
> > Date:   2013-11-16T06:21:50Z
> >
> >    Doc: Translate admin/index
> >
> > commit e378b27449601559f9ee052d1e1565832497d24f
> > Author: Masaori Koshiba <masaori...@gmail.com>
> > Date:   2013-11-16T06:22:21Z
> >
> >    Doc: Translate admin/getting-started
> >
> > commit 987e3ee42239b338f2c1c699570f2d124da00b39
> > Author: Masaori Koshiba <masaori...@gmail.com>
> > Date:   2013-11-16T06:34:42Z
> >
> >    Doc: Translate reference/plugins/index
> >
> > commit bb9287c74e51b5e9aa57d7ec5bdfd87589afd145
> > Author: Masakazu Kitajo <m4s...@gmail.com>
> > Date:   2013-11-17T09:31:03Z
> >
> >    Doc: Translate admin/reverse-proxy-http-redirects
> >
> > commit cbe157b6a507d8f55114036ac31633cb62b80c37
> > Author: Masakazu Kitajo <m4s...@gmail.com>
> > Date:   2013-11-23T08:57:51Z
> >
> >    Doc: Translate reference/configuration/remap.config
> >
> > commit cfaaa83a31a487a9b2d284b527847d10634937cc
> > Author: Masakazu Kitajo <m4s...@gmail.com>
> > Date:   2013-11-24T15:05:17Z
> >
> >    Doc: Translate admin/security-options
> >
> > commit 55737eb8920bf728126a3352f9bb1a8c3b16a4b6
> > Author: Masakazu Kitajo <m4s...@gmail.com>
> > Date:   2013-11-30T15:59:34Z
> >
> >    Doc: Translate reference/configuration/index
> >
> > commit 2e13bd14a445eb4ac50be0fa3964c00b1480ef51
> > Author: Masakazu Kitajo <m4s...@gmail.com>
> > Date:   2013-12-05T13:40:53Z
> >
> >    Doc: Translate beginning of referenece/configuration/records.config
> >
> > commit efa70db317ea57bd0c4f2d2bfd3ebe

Reply via email to