Merge pull request #1 from miurahr/topic-i18n-l10n-zh-ja

Internationalize and localize vnote documentation using Sphinx i18n feature

.gitignore

@@ -0,0 +1,3 @@
+_build
+.python-version
+*.mo

Makefile

@@ -18,3 +18,13 @@ help:
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+
+
+langs = en zh_CN ja
+
+html: $(foreach lang,$(langs),html-$(lang))
+
+html-%: $(SPHINX_DEPENDENCIES)
+	$(SPHINXBUILD) "$(SOURCEDIR)" "$(BUILDDIR)/html/$*" -b html -d $(BUILDDIR)/doctrees/$* -D language=$* $(SPHINXOPTS) 
+

conf.py

@@ -81,6 +81,14 @@
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = False
 
+# -- Options for i18n
+gettext_compact = False
+
+gettext_auto_build = True
+
+#gettext_additional_targets = []
+
+locale_dirs = ['locale/']
 
 # -- Options for HTML output ----------------------------------------------
 

locale/ja/LC_MESSAGES/index.po

@@ -0,0 +1,56 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2018, Le Tan
+# This file is distributed under the same license as the VNote package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr "Project-Id-Version: VNote 1.11.1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-01-13 11:49+0900\n"
+"PO-Revision-Date: 2019-01-12 00:00+0900\n"
+"Last-Translator: Hiroshi Miura <miurahr@linux.com>\n"
+"Language-Team: Japanese <ja@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: ../../index.rst:7
+msgid "Welcome to VNote's Documentation"
+msgstr "VNoteのドキュメントへようこそ"
+
+#: ../../index.rst:11
+msgid "Designed specially for Markdown, `VNote`_ is a Vim-inspired note-taking application, which knows programmers and Markdown better."
+msgstr "`VNote`_ はVimで刺激されたノート作成アプリケーションであり、Markdownのために特別に設計されています。"
+
+#: ../../index.rst:13
+msgid "VNote is open source, and available on `Github`_."
+msgstr "VNoteのソースコードは、`Github`_ で入手できます。"
+
+#: ../../index.rst:18
+msgid "You could obtain a Simplified Chinese (简体中文) version translated by users `here`_."
+msgstr "中国語 (简体中文)版を`ここ`_で見ることができます。 "
+
+#: ../../index.rst:22
+msgid "The main documentation for the site is organized into a couple of sections:"
+msgstr "このサイト上の主たる文書は次の章で構成されています。"
+
+#: ../../index.rst:24
+msgid ":ref:`user-docs`"
+msgstr ""
+
+#: ../../index.rst:25
+msgid ":ref:`advanced-docs`"
+msgstr ""
+
+#: ../../index.rst:26
+msgid ":ref:`dev-docs`"
+msgstr ""
+
+#: ../../index.rst:27
+msgid ":ref:`about-docs`"
+msgstr ""
+
+#: ../../index.rst:31
+msgid "User Documentation"
+msgstr ""
+

locale/ja/LC_MESSAGES/user_docs/build.po

@@ -0,0 +1,136 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2018, Le Tan
+# This file is distributed under the same license as the VNote package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr "Project-Id-Version: VNote 1.11.1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-01-13 11:49+0900\n"
+"PO-Revision-Date: 2019-01-12 00:00+0900\n"
+"Last-Translator: Hiroshi Miura <miurahr@linux.com>\n"
+"Language-Team: Japanese <ja@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: ../../user_docs/build.md:1
+msgid "Build VNote"
+msgstr "VNoteのビルド"
+
+#: ../../user_docs/build.md:2
+msgid "You need Qt 5.9 to build VNote from source."
+msgstr "ソースからVNoteを作成するには、Qt5.9が必要です。"
+
+#: ../../user_docs/build.md:4
+msgid "Get the Source Code of VNote"
+msgstr "VNoteのソースコードを取得する"
+
+#: ../../user_docs/build.md:5
+msgid "VNote's source code is available on Github. You could download the ZIP archive of the code. Please be aware of that VNote depends on some submodules, so you should also download the source codes of these modules."
+msgstr "VNoteのソースコードは、Githubで入手できます。コードのZIPアーカイブをダウンロードすることができます。VNoteはいくつかのサブモジュールに依存しているので、これらのモジュールのソースコードもダウンロードしてください。"
+
+#: ../../user_docs/build.md:7
+msgid "The recommended way is using git like this:"
+msgstr "推奨される方法は、次のようにgitを使用することです："
+
+#: ../../user_docs/build.md:15
+msgid "Get Qt 5.9"
+msgstr "Qt 5.9の入手"
+
+#: ../../user_docs/build.md:16
+msgid "You could get the standalone Qt SDK from Qt Downloads. For users in China, you could speed up the download via the TUNA Mirrors."
+msgstr "スタンドアロンQt SDKは、Qt downloadsから入手できます。中国では、TUNA Mirrorsを通じてダウンロードを高速化することができます。"
+
+#: ../../user_docs/build.md:18
+msgid "Windows"
+msgstr ""
+
+#: ../../user_docs/build.md:19
+msgid "On Windows, you need Visual Studio 2015 or above to compile VNote."
+msgstr "Windowsでは、VNoteをコンパイルするにはVisual Studio2015以上が必要です。"
+
+#: ../../user_docs/build.md:21
+msgid "Open Qt Creator and open vnote.git\\VNote.pro as project. Now you are ready to tune and compile VNote!"
+msgstr "Qt Creatorを開き、vnote.git\\VNote.proをプロジェクトとして開きます。これで、VNote!を調整してコンパイルできるようになりました。"
+
+#: ../../user_docs/build.md:23
+msgid "Linux"
+msgstr ""
+
+#: ../../user_docs/build.md:24
+msgid "In Ubuntu, you could get Qt 5.9 from PPA like this:"
+msgstr "Ubuntuでは、次のようにPPAからQt5.9を取得することができます。"
+
+#: ../../user_docs/build.md:34
+msgid "Then compile and install VNote like this:"
+msgstr "次のようにVNoteをコンパイルしてインストールします。"
+
+#: ../../user_docs/build.md:45
+msgid "Fcitx"
+msgstr ""
+
+#: ../../user_docs/build.md:46
+msgid "If you use Fcitx as the input method, you need to copy the missing library libfcitxplatforminputcontextplugin.so to Qt's plugin directory."
+msgstr "入力メソッドとしてFcitxを使用する場合は、欠落したライブラリlibfcitxplatforminputcontextplugin.soをQtのプラグイン・ディレクトリにコピーする必要があります。"
+
+#: ../../user_docs/build.md:48
+msgid "To find the place of libfcitxplatforminputcontextplugin.so, you could execute:"
+msgstr " libfcitxplatforminputcontextplugin.soの場所をさがすため、次のコマンドを実行してみてください："
+
+#: ../../user_docs/build.md:54
+msgid "If there is no such lib, you may need to install and configure Fcitx for Qt5 correctly before continue."
+msgstr "ライブラリが見付からないときは、つぎに進む前にFcitx for Qt5を正しくインストールし設定する必要があります。"
+
+#: ../../user_docs/build.md:56
+msgid "Then you need to copy the lib to Qt's plugin directory:"
+msgstr "次に、libをQtのプラグイン・ディレクトリーにコピーする必要があります。"
+
+#: ../../user_docs/build.md:62
+msgid "OpenSSL"
+msgstr ""
+
+#: ../../user_docs/build.md:63
+msgid "VNote needs openSSL 1.0 for networking. To verify if it has been setup correctly, you could check for updates in the Help menu of VNote. If VNote fails to check for updates, then you need to copy libraries of openSSL to Qt's library directory."
+msgstr "VNoteはopenSSL1.0をネットワーク接続のために必要とします。正しく設定されているかどうかを確認するには、VNOTEのヘルプメニューで更新を確認します。VNoteが更新のチェックに失敗した場合は、openSSLのライブラリをQtのライブラリディレクトリにコピーする必要があります。"
+
+#: ../../user_docs/build.md:65
+msgid "After the installation of openSSL, you could find two lib files:"
+msgstr "openSSLをインストールすると、次の2つのライブラリファイルを見つけることができます。"
+
+#: ../../user_docs/build.md:72
+msgid "Copy these two files to Qt's library directory:"
+msgstr "この二つのファイルを、Qtライブラリディレクトリにコピーしてください。"
+
+#: ../../user_docs/build.md:78
+msgid "In Qt's library directory, create symlinks for these two files:"
+msgstr "Qtのライブラリディレクトリで、次の2つのファイルに対してシンボリックリンクを作成します。"
+
+#: ../../user_docs/build.md:85
+msgid "MacOS"
+msgstr ""
+
+#: ../../user_docs/build.md:86
+msgid "If you prefer command line on macOS, you could follow these steps."
+msgstr "mac OSでコマンドラインを使用する場合は、次の手順を実行します。"
+
+#: ../../user_docs/build.md:88
+msgid "Install Xcode and Homebrew;"
+msgstr "XcodeとHomebrewをインストールします；"
+
+#: ../../user_docs/build.md:89
+msgid "Install Qt 5.9.1 via Homebrew:"
+msgstr "Homebrewを使用してQt5.9.1をインストールします："
+
+#: ../../user_docs/build.md:93
+msgid "In the project directory, create build_macos.sh like this:"
+msgstr "プロジェクトディレクトリで、次のようにbuild_macos.shを作成します："
+
+#: ../../user_docs/build.md:106
+msgid "Make build_macos.sh executable and run it:"
+msgstr "build_macos.shを実行可能にして実行します："
+
+#: ../../user_docs/build.md:111
+msgid "Now you got the bundle path/to/project/build/src/VNote.app."
+msgstr "これでバンドル path/to/project/build/src/VNote.appができました。"
+