{"action":"created","issue":{"url":"https://api.github.com/repos/mattermost/docs/issues/80","repository_url":"https://api.github.com/repos/mattermost/docs","labels_url":"https://api.github.com/repos/mattermost/docs/issues/80/labels{/name}","comments_url":"https://api.github.com/repos/mattermost/docs/issues/80/comments","events_url":"https://api.github.com/repos/mattermost/docs/issues/80/events","html_url":"https://github.com/mattermost/docs/pull/80","id":144218783,"number":80,"title":"[Prototype] i18n support for docs with \"sphinx-intl\"","user":{"login":"terukizm","id":1755900,"avatar_url":"https://avatars.githubusercontent.com/u/1755900?v=3","gravatar_id":"","url":"https://api.github.com/users/terukizm","html_url":"https://github.com/terukizm","followers_url":"https://api.github.com/users/terukizm/followers","following_url":"https://api.github.com/users/terukizm/following{/other_user}","gists_url":"https://api.github.com/users/terukizm/gists{/gist_id}","starred_url":"https://api.github.com/users/terukizm/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/terukizm/subscriptions","organizations_url":"https://api.github.com/users/terukizm/orgs","repos_url":"https://api.github.com/users/terukizm/repos","events_url":"https://api.github.com/users/terukizm/events{/privacy}","received_events_url":"https://api.github.com/users/terukizm/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-03-29T10:07:12Z","updated_at":"2016-04-02T03:21:27Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/mattermost/docs/pulls/80","html_url":"https://github.com/mattermost/docs/pull/80","diff_url":"https://github.com/mattermost/docs/pull/80.diff","patch_url":"https://github.com/mattermost/docs/pull/80.patch"},"body":"ref: http://www.sphinx-doc.org/en/stable/intl.html\r\n\r\nPlease give me some advice.\r\nI will \"git squash\", if you wish.\r\n\r\n# Tested environment:\r\n\r\nPython 2.7.11\r\n\r\n```\r\nrecommonmark==0.4.0\r\nsphinx-autobuild==0.6.0\r\nsphinx-rtd-theme==0.1.9\r\n```\r\n\r\n# Make HTML:\r\n\r\nin Japanese: _(sorry, my translation sample is only \"index.html\")_\r\n\r\n```\r\n$ make -e SPHINXOPTS=\"-D language='ja'\" html\r\n```\r\n\r\noutput is:\r\n\r\n<img width=\"1137\" alt=\"2016-03-29 10 53 36\" src=\"https://cloud.githubusercontent.com/assets/1755900/14104158/9ac73098-f5de-11e5-8379-c7b7c2605bcf.png\">\r\n\r\n\r\nin English, same as it was. no change.\r\n\r\n```\r\n$ make html\r\n```\r\n\r\n\r\n# Translation in other language:\r\n\r\ne.g. Korean(ko)\r\n\r\n```\r\n$ pip install sphinx-intl\r\n$ make gettext\r\n\r\n$ sphinx-intl update -p build/locale -l ko\r\n$ vi source/locale/ko/LC_MESSAGES/*.po\r\n(translation working)\r\n\r\n$ make -e SPHINXOPTS=\"-D language='ko'\" html\r\n$ open build/index.html\r\n```\r\n\r\n# If based-document is updated:\r\n\r\n```\r\n$ make gettext\r\n$ sphinx-intl update -p build/locale\r\n```\r\n\r\n----\r\n\r\n# Known issues:\r\n\r\n## Don't support *.md files.\r\n\r\n*.md files does not support, only *.rst. (e.g. `source/install/prod-rhel-6.md`)\r\n\r\nIf you need, use [pandoc](http://pandoc.org/), be able to convert *.md to *.rst.\r\n\r\n---\r\n\r\n\r\n# Feature Ideas:\r\n\r\n## Use submodules\r\n\r\nMove locale-files to new repository (e.g. \"mattermost/docs-ja\"), and use git-submodules.\r\n\r\n```\r\n$ mv source/locale/ja/ {docs-ja}\r\n\r\n$ git submodule add https://git@github.com:mattermost/docs-ja.git source/locale/ja\r\n```\r\n\r\n## Change hosting style\r\n\r\nMaybe, need some modification in your deploy process, and `DocuementRoot` settings.\r\n\r\ne.g.\r\n\r\n```\r\nhttp://docs.mattermost.com/ja/\r\nhttp://docs-ja.mattermost.com/\r\n```\r\n---\r\n\r\nThank you for your consideration.\r\n"},"comment":{"url":"https://api.github.com/repos/mattermost/docs/issues/comments/204637355","html_url":"https://github.com/mattermost/docs/pull/80#issuecomment-204637355","issue_url":"https://api.github.com/repos/mattermost/docs/issues/80","id":204637355,"user":{"login":"it33","id":177788,"avatar_url":"https://avatars.githubusercontent.com/u/177788?v=3","gravatar_id":"","url":"https://api.github.com/users/it33","html_url":"https://github.com/it33","followers_url":"https://api.github.com/users/it33/followers","following_url":"https://api.github.com/users/it33/following{/other_user}","gists_url":"https://api.github.com/users/it33/gists{/gist_id}","starred_url":"https://api.github.com/users/it33/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/it33/subscriptions","organizations_url":"https://api.github.com/users/it33/orgs","repos_url":"https://api.github.com/users/it33/repos","events_url":"https://api.github.com/users/it33/events{/privacy}","received_events_url":"https://api.github.com/users/it33/received_events","type":"User","site_admin":false},"created_at":"2016-04-02T03:21:27Z","updated_at":"2016-04-02T03:21:27Z","body":"Hi @terukizm, \r\n\r\nThank you for your kind support. \r\n\r\nWe are very impressed with your work on [Mattermost on Qiita.com](http://qiita.com/tags/Mattermost).\r\n\r\nWould you be interested in [helping us add more guidance for Japanese speakers to Mattermost documentation](https://github.com/mattermost/docs/issues/83)? \r\n\r\n![image](https://cloud.githubusercontent.com/assets/177788/14224138/b422b390-f846-11e5-9288-47afd9fbe962.png)\r\n\r\nI think it is fine to leave this pull request open for now. It is a reminder that after we change from .md to .rst we can work together to add this. "}}