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