
TicketImportPluginに、Ryuzeeさんのすばらしい翻訳を適用したものです。

   TicketImportPlugin   : http://trac-hacks.org/wiki/TicketImportPlugin
   Ryuzee.com           : http://www.ryuzee.com/

また、CSVファイルの文字コードがUTF-8で通るようになってます。
勢いでREADMEの内容も翻訳しています。
CSVファイルの文字コードの自動判定と、日本語のカラム名でも通るようにしようと考えてます。
(クエリからCSVをダウンロードすると、カラム名が日本語だったりするんで)


■ README

このモジュールは、MS ExcelやCSVファイルからチケットのインポートを可能にします。
モジュールをインストールして、ユーザに「IMPORT_EXECUTE」のパーミッションを付与していれば、
TracのUI上に「インポート」タブが表示され、直接ドキュメントが参照できます。

CSVは、すぐ使えます。Excelファイルをインポート出来るようにするには、
xlrdをインストールする必要があります。
xlrdはTracのプラグインではなく、Pythonのライブラリです。
最新のバイナリは、http://pypi.python.org/pypi/xlrd から取得します。

Windowsならインストーラを実行します。
他のプラットフォームの場合、zipファイルを展開して、
中に含まれるxlrdフォルダをPythonのライブラリフォルダ"site-packages"にコピーします。

大抵はこのようになります。

mkdir tmp
cd tmp
curl http://pypi.python.org/packages/source/x/xlrd/xlrd-0.6.1.zip > xlrd-0.6.1.zip
unzip xlrd-0.6.1.zip
sudo cp -r xlrd-0.6.1/xlrd /usr/lib/python2.4/site-packages/

コンフィグは必要ありません。コマンドラインから "python -c 'import xlrd'" を実行して
エラーが出なければインストールは成功です。


いくつかの設定が、trac.iniの'[importer]'セクションで定義可能です。

- reconciliate_by_owner_also: whether to reconciliate by owner and summary, or by summary only (*1)
- skip_lines_with_empty_owner: 有効な場合、ownerカラムの値が空の行は無視されます。

*1 訳注: 良く意味がわからんので、後でソース見て確認します。誰か調べてくれても嬉しいです。


■ ライセンス

次のファイルに対する翻訳は、NEW BSD LICENSE が適用されます。

./talm_importer/templates/importer.html

オリジナルの翻訳文書
http://www.ryuzee.com/contents/blog/948

Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

  * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  * Neither the name of eZ Systems A.S. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

