From cf5551bef81edb2bd027b3ecb854e005373bcee3 Mon Sep 17 00:00:00 2001 From: Ryuunosuke Ayanokouzi Date: Fri, 21 Sep 2012 11:56:33 +0200 Subject: [PATCH] doc: add japanese tester's guide, update japanese translations and docs --- ChangeLog | 5 +- doc/ja/CMakeLists.txt | 11 ++ doc/ja/Makefile.am | 8 +- doc/ja/autogen/user/charset_options.txt | 4 +- doc/ja/weechat_tester.ja.txt | 133 ++++++++++++++++++++++++ po/ja.po | 17 +-- 6 files changed, 167 insertions(+), 11 deletions(-) create mode 100644 doc/ja/weechat_tester.ja.txt diff --git a/ChangeLog b/ChangeLog index 5544a4adb..074b2a064 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,7 +1,7 @@ WeeChat ChangeLog ================= Sébastien Helleu -v0.3.9-rc2, 2012-09-19 +v0.3.9-rc2, 2012-09-21 Version 0.3.9 (under dev!) @@ -54,7 +54,8 @@ Version 0.3.9 (under dev!) * core: reallow names beginning with "#" for bars, proxies and filters * core: escape special chars (`#[\`) in configuration files for name of options (bug #36584) -* doc: add japanese user's guide (patch #7827) and scripting guide +* doc: add japanese user's guide (patch #7827), scripting guide and tester's + guide * api: allow update for some variables of hdata, add new functions hdata_update and hdata_set * api: add info "locale" for info_get (locale used to translate messages) diff --git a/doc/ja/CMakeLists.txt b/doc/ja/CMakeLists.txt index 107e1a5b5..618cfe1db 100644 --- a/doc/ja/CMakeLists.txt +++ b/doc/ja/CMakeLists.txt @@ -61,3 +61,14 @@ ADD_CUSTOM_COMMAND( ) ADD_CUSTOM_TARGET(doc-quickstart-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html) INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME}) + +# tester's guide +ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html + COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc-title='目次' -a date=`date "+%F"` -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.ja.txt + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.ja.txt + COMMENT "Building weechat_tester.ja.html" +) +ADD_CUSTOM_TARGET(doc-tester-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html) +INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME}) diff --git a/doc/ja/Makefile.am b/doc/ja/Makefile.am index afc59890e..d2462e310 100644 --- a/doc/ja/Makefile.am +++ b/doc/ja/Makefile.am @@ -24,13 +24,15 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.ja.txt \ weechat_faq.ja.txt \ weechat_quickstart.ja.txt \ + weechat_tester.ja.txt \ $(wildcard autogen/user/*.txt) \ $(wildcard autogen/plugin_api/*.txt) all-local: weechat_user.ja.html \ weechat_scripting.ja.html \ weechat_faq.ja.html \ - weechat_quickstart.ja.html + weechat_quickstart.ja.html \ + weechat_tester.ja.html # user's guide weechat_user.ja.html: weechat_user.ja.txt $(wildcard autogen/user/*.txt) @@ -48,6 +50,10 @@ weechat_faq.ja.html: weechat_faq.ja.txt weechat_quickstart.ja.html: weechat_quickstart.ja.txt $(ASCIIDOC) -a toc -a toc-title='目次' -a date=`date "+%F"` -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -n -o weechat_quickstart.ja.html $(abs_top_srcdir)/doc/ja/weechat_quickstart.ja.txt +# tester's guide +weechat_tester.ja.html: weechat_tester.ja.txt + $(ASCIIDOC) -a toc -a toc-title='目次' -a date=`date "+%F"` -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -n -o weechat_tester.ja.html $(abs_top_srcdir)/doc/ja/weechat_tester.ja.txt + # install docs install-data-hook: diff --git a/doc/ja/autogen/user/charset_options.txt b/doc/ja/autogen/user/charset_options.txt index 047901915..e6a08e927 100644 --- a/doc/ja/autogen/user/charset_options.txt +++ b/doc/ja/autogen/user/charset_options.txt @@ -1,10 +1,10 @@ * [[option_charset.default.decode]] *charset.default.decode* -** 説明: `global decoding charset: charset used to decode incoming messages (if decoding fails, fallback is UTF-8 because it is the WeeChat internal charset)` +** 説明: `グローバルデコード文字セット: 受信メッセージをデコードする文字セット (デコードに失敗した場合、UTF-8 でデコードされます。UTF-8 は WeeChat の内部文字セットです)` ** タイプ: 文字列 ** 値: 未制約文字列 (デフォルト値: `"iso-8859-1"`) * [[option_charset.default.encode]] *charset.default.encode* -** 説明: `global encoding charset: charset used to encode outgoing messages (if empty, default is UTF-8 because it is the WeeChat internal charset)` +** 説明: `グローバルエンコード文字セット: 送信メッセージをエンコードする文字セット (空の場合、UTF-8 でエンコードされます。UTF-8 は WeeChat の内部文字セットです)` ** タイプ: 文字列 ** 値: 未制約文字列 (デフォルト値: `""`) diff --git a/doc/ja/weechat_tester.ja.txt b/doc/ja/weechat_tester.ja.txt new file mode 100644 index 000000000..13b3199a5 --- /dev/null +++ b/doc/ja/weechat_tester.ja.txt @@ -0,0 +1,133 @@ += WeeChat テスターガイド = +Sébastien Helleu + + +[[purpose]] +== 目的 == + +WeeChat +開発への協力に興味を持っていただきありがとうございます。開発に協力する最も簡単 +(で最も大変) な方法はテストです! + +テストはソフトウェア開発においてとても重要で、疎かにできないものです。 +何か新しい機能が実装されたらその機能はテストされるべきです。 +しかし、機能によっては使用条件が広すぎる条件が特殊ぎるため、 +開発チームが全ての条件をテストできない場合があります。 + +例: WeeChat 0.2.2 で導入された charset プラグインは悪名高いものでした: +チャンネル名に各国語を使うユーザー (開発者、貢献者、テスター) +が開発チームにおらず、0.2.2 +がリリースされると、チームを非難するロシア人ユーザが殺到しました。 +より多くのテスターがいれば、今後そのようなことはおきないでしょう。 + +開発者は新機能の実装 (と古いバグの修正) に忙しいので、WeeChat +安定版をテストすることは意味がありません。 + + +[[prepare_system]] +== システムの準備 == + +Linux の 'core' ファイルを有効にすることはとても役に立ちます: WeeChat +がクラッシュすると、Linux は 'core' と呼ばれるファイルを作ります。このファイルには、WeeChat +に問題の有る箇所を正確に示す、とても役立つデバッグ情報が含まれています。 + +'bash' シェルを使っている場合、以下の行を `~/.bashrc` に追記してください: + + ulimit -c unlimited + + +[[download]] +== 開発版のダウンロード == + +最新のコード (最新のバグと最新の機能も含んでいますが) は GIT リポジトリにあります。 + +手作業で最新のコードをビルドすることができます (推奨): + +* GIT 版は安定版と共存してビルド、インストールできます。 +* root 権限は必要ありません、WeeChat + 安定版を捨てる必要もありません。 + +[[get_sources]] +=== ソースの取得とビルド === + +最初にディレクトリを作ってください、ここでは 'weechat-git': + +--------------------- +$ mkdir ~/weechat-git +$ cd ~/weechat-git +--------------------- + +git がインストール済みの場合、git +リポジトリを clone してください (推奨): + +-------------------------------------------- +$ git clone git://git.sv.gnu.org/weechat.git +$ cd weechat +-------------------------------------------- + +注意: clone の後、このディレクトリ内で "`git pull`" +を実行すれば、最新のアップデートとの差分が更新されます。 + +他の方法として 'devel' パッケージをダウンロードして展開する方法があります: + +----------------------------------------------------------------- +$ wget http://www.weechat.org/files/src/weechat-devel.tar.bz2 +$ tar xvjf weechat-devel.tar.bz2 +$ cd weechat-devel +----------------------------------------------------------------- + +ソースをビルドするには cmake を使うことを推奨します: + +-------------------------------------------------------------- +$ mkdir build +$ cd build +$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug +$ make +$ make install +-------------------------------------------------------------- + +cmake が無い場合は autotools を使うことも可能です: + +---------------------------------------------------------- +$ ./autogen.sh # (git リポジトリから clone した場合のみ) +$ ./configure --prefix=$HOME/weechat-git +$ make +$ make install +---------------------------------------------------------- + +[[install_binary_package]] +=== バイナリパッケージのインストール === + +Linux ディストリビューション別に: + +* Debian: http://debian.flashtux.org/ +* Gentoo: http://www.weechat.org/download +* ArchLinux: http://aur.archlinux.org/ から PKGBUILD +* その他: 知らないよ! + + +[[run]] +== WeeChat の実行 == + +`--dir` オプションを使って WeeChat を専用の (安定版とは違う) +ディレクトリで実行することを推奨します。 + +コマンド: + + ~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev + +より万全を期すなら、上の方法を使って WeeChat +の最新バージョンを使っていることを確認するべきです ;) + +おかしな (問題を引き起こしたり、クラッシュしたり、あなたを怒らせるような) 挙動を見つけたら +`irc.freenode.net` の `#weechat` に参加して、開発チームにこの挙動を教えてください。 + +クラッシュしなかったとしても教えてください。開発チームはあなたからのフィードバックをお待ちしています! + + +[[links]] +== 便利なリンク == + +* GIT リポジトリ: http://git.savannah.gnu.org/gitweb/?p=weechat.git +* バグトラッカー: https://savannah.nongnu.org/bugs/?group=weechat +* RSS フィードによる WeeChat コミット: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss diff --git a/po/ja.po b/po/ja.po index 724cf2346..124a292bb 100644 --- a/po/ja.po +++ b/po/ja.po @@ -20,8 +20,8 @@ msgid "" msgstr "" "Project-Id-Version: WeeChat 0.3.9-dev\n" "Report-Msgid-Bugs-To: flashcode@flashtux.org\n" -"POT-Creation-Date: 2012-09-20 07:54+0200\n" -"PO-Revision-Date: 2012-09-05 01:33+0900\n" +"POT-Creation-Date: 2012-09-21 11:39+0200\n" +"PO-Revision-Date: 2012-09-20 18:10+0900\n" "Last-Translator: AYANOKOUZI, Ryuunosuke \n" "Language-Team: Japanese \n" "Language: ja\n" @@ -3893,15 +3893,15 @@ msgstr "%s%s: 新しい speller を作る十分なメモリがありません" msgid "Charset conversions" msgstr "文字コード変換" -#, fuzzy, c-format +#, c-format msgid "" "%s%s: UTF-8 is not allowed in charset decoding options (it is internal and " "default charset: decode of UTF-8 is OK even if you specify another charset " "to decode)" msgstr "" -"%s%s: UTF-8 を charset オプションに設定することはできません (UTF-8 は内部デ" -"フォルト文字セットです: その他の文字セットへのデコードを指定したとしても、デ" -"フォルトエンコードは UTF-8 で、自動的に UTF-8 にデコードされます)。" +"%s%s: UTF-8 を charset デコードオプションに設定することはできません (UTF-8 は" +"内部デフォルト文字セットです: その他の文字セットへのデコードを指定したとして" +"も、UTF-8 のデコードは問題ありません)。" #, c-format msgid "%s%s: error creating charset \"%s\" => \"%s\"" @@ -3911,11 +3911,16 @@ msgid "" "global decoding charset: charset used to decode incoming messages (if " "decoding fails, fallback is UTF-8 because it is the WeeChat internal charset)" msgstr "" +"グローバルデコード文字セット: 受信メッセージをデコードする文字セット (デコー" +"ドに失敗した場合、UTF-8 でデコードされます。UTF-8 は WeeChat の内部文字セット" +"です)" msgid "" "global encoding charset: charset used to encode outgoing messages (if empty, " "default is UTF-8 because it is the WeeChat internal charset)" msgstr "" +"グローバルエンコード文字セット: 送信メッセージをエンコードする文字セット (空" +"の場合、UTF-8 でエンコードされます。UTF-8 は WeeChat の内部文字セットです)" #, c-format msgid "%s: %s, \"%s\": removed"