Wptscs/Readme.txt

   1 =====================================================================
   2 【タイトル】 Wikipedia 翻訳支援ツール
   3 【ファイル】 wptscs120.zip
   4 【作成月日】 2012/x/xx
   5 【制 作 者】 Honeplus
   6 【動作環境】 Windows Vista/7 での動作を確認。要.NET Framework 4.0 Client Profile
   7 【配布形態】 修正BSDライセンス
   8 【HomePage】 http://sourceforge.jp/projects/wptscs/
   9 =====================================================================
  10
  11 ・概要
  12 Wikipediaでの言語間翻訳をサポートするためのツールです。
  13 指定されたWikipediaの記事に存在する内部リンク先を確認し、その言語間リンクを取得します。
  14 また、登録されていれば、見出しも変換します。
  15
  16
  17
  18 ・インストール方法
  19 適当なフォルダに展開してください。
  20 展開して出てくる以下のファイルが、最低限必要なファイルです。他は消しても問題ありません。
  21
  22 wptscs.exe              : 実行ファイル
  23 ja/wptscs.resources.dll : 日本語リソースdll
  24 hmlib.dll               : 共通ライブラリdll
  25 wptscs.exe.config       : デフォルト値やプログラム的な設定ファイル
  26 Wikipedia.xml           : Wikipedia用の設定ファイル
  27
  28 アプリケーション上で設定した内容は、上記設定ファイルには反映されません。
  29 ユーザーごとのフォルダに出力されます。
  30 設定ファイルを直接修正、または削除して初期値に戻したい場合は、
  31 下記のようなパスにあるファイルを更新してください（以下はVistaの例）。
  32
  33 C:\Users\[ユーザー名]\AppData\Roaming\Honememo\Wikipedia 翻訳支援ツール\[バージョン番号]\config.xml
  34 C:\Users\[ユーザー名]\AppData\Local\Honememo\wptscs.exe_[～]\[バージョン番号]\user.config
  35
  36
  37
  38 ・アンインストール方法
  39 展開したファイルと必要なら上記設定ファイルを削除してください。レジストリ等は一切いじりません。
  40
  41
  42
  43 ・使い方
  44 翻訳元／先言語と、処理結果の出力先フォルダを指定してから、翻訳したい翻訳元記事名を入力して実行してください。
  45
  46 設定画面については、通常は触る必要はないです。
  47 言語間リンクが貼られていない記事の対応パターン登録や、キャッシュの確認、
  48 言語コードの登録や、見出しの変換パターンの設定ができます。
  49 設定の内容などは、ツールチップと既存の値を見れば概要はつかめるのではないかと思います。
  50
  51 なお、このプログラムはあくまで「翻訳支援ツール」です。
  52 出力された文章は、その後Wikipediaの編集画面やプレビューなりで本格的に修正されることを前提としています。
  53 間違っても、そのままWikipediaに投稿するなどしないでください。
  54 また、当プログラムではWikipediaへの書き込みは一切行いません。
  55
  56 ※ 特にテンプレート等の複雑な書式の記事で使用した場合、一部が正常に処理されない可能性があります。
  57    これらの記事で使用する際は、処理結果に異常が無いか注意しながらご利用ください。
  58
  59
  60
  61 ・処理結果の詳細
  62 処理結果として、実行ログと記事テキストの内部リンク等を置き換えたものを出力します。
  63
  64 記事テキストの置き換えについては、下記のようなルールで実行しています。
  65 （以下、英語版→日本語版で適当な記事を例に）
  66
  67 例）[[Japan]]
  68
  69 言語間リンクがある場合    →  [[日本|Japan]]
  70 言語間リンクがない場合    →  [[:en:Japan|Japan]]
  71 ない場合で仮リンクが有効  →  {{仮リンク|Japan|en|Japan|label=Japan}}
  72 英語版も赤リンクの場合    →  [[Japan]]
  73
  74 例）[[Japan|Nihon]]
  75
  76 言語間リンクがある場合    →  [[日本|Nihon]]
  77 言語間リンクがない場合    →  [[:en:Japan|Nihon]]
  78 ない場合で仮リンクが有効  →  {{仮リンク|Japan|en|Japan|label=Nihon}}
  79 英語版も赤リンクの場合    →  [[Japan|Nihon]]
  80
  81 例）[[Category:Japan|sortkey]]
  82
  83 言語間リンクがある場合    →  [[Category:日本|sortkey]]
  84 言語間リンクがない場合    →  [[:en:Category:Japan]]<!-- [[Category:Japan|sortkey]] -->
  85 英語版も赤リンクの場合    →  [[Category:Japan|sortkey]]
  86
  87 例）{{Citation needed|date=January 2012}}
  88
  89 言語間リンクがある場合    →  {{要出典|date=January 2012}}
  90 言語間リンクがない場合    →  [[:en:Template:Citation needed]]<!-- {{Citation needed|date=January 2012}} -->
  91 英語版も赤リンクの場合    →  {{Citation needed|date=January 2012}}
  92
  93 例）==History==
  94
  95 見出し変換表に登録あり    →  ==歴史==
  96 見出し変換表に登録なし    →  ==History==
  97
  98
  99
 100 ・ソースについて
 101 src.zipにソースファイルをまとめています。開発環境はVisual C# 2010 Expressです。
 102 その他外部ツールとしてテスト自動化ツールのNUnitと、コーディングスタイルチェック用のStyleCopを使用しています。
 103
 104
 105
 106 ・ライセンスについて
 107 このプログラムは修正BSDライセンスに基づいたフリーソフトウェアで、無保証です。
 108 このプログラムを利用して何らかの被害をこうむっても、作者は一切責任を負いません。
 109 またサポートする保証もありません。
 110 このプログラムの変更・再配布・流用はご自由にどうぞ。
 111
 112
 113 また、ソース中にNUnitのテストデータとしてWikipediaより取得したXMLを同梱しています。
 114 これらファイル内の著作物の扱いについては、日本語版／英語版の各Wikipediaのライセンスに従ってください。
 115
 116
 117
 118 ・更新履歴
 119 Ver0.80  2010/09/18 開発環境／言語をVisual Studio 2005のC++/CLI→Visual C# 2010 Expressに移行。
 120                     ソースも全面的に見直し（ただし現在は古いコードが多々残った状態）。
 121                     設定画面を全体的に変更。記事の対応パターンを登録できるよう対応。
 122                     キャッシュ状況も見えるように変更。
 123
 124 Ver0.90  2010/09/27 Template:Documentationが使われているページに対応。
 125                     無駄に遅くなっていた処理を改善。その他細かい部分を改良／修正。
 126
 127 Ver1.00  2011/04/22 Wikipediaのバージョンアップごとに設定ファイルを直さなくて済むよう対処。
 128                     無駄に遅くなっていた処理を改善。
 129                     設定画面のツールチップや入力値チェックを整備。
 130                     [[ファイル:～]]→[[File:～]]も変換するよう対応。
 131                     [[Apollo&nbsp;17]]のように特殊文字が入っているリンクを処理できるよう修正。
 132                     HTMLタグの解析で正規表現の構文エラーになる可能性があったのを修正。
 133                     config.xmlの日英以外の言語の設定を精査・補填。
 134
 135 Ver1.01  2011/10/05 MediaWikiのバージョンアップに伴いAPIの仕様が変わったため対応。
 136
 137 Ver1.10  2012/01/30 ソースの全体的なリファクタリングを実施。
 138                     言語間リンクが無い記事の{{仮リンク}}への置き換えに対応。
 139                     {{Doc}}→{{Documentation}}のリダイレクトとインラインコンテンツに対応。
 140                     .net framework 4 フル版でなく Client Profile で動作するよう改善。
 141                     処理状況をステータスバーに表示するよう変更。
 142                     各種設定の文字列埋め込みを{0}から$1形式に変更。
 143                     [[File:～|]]のコメント部分を処理対象とするよう対応。
 144                     キャッシュ済みテンプレートの処理時に余分な通信をしていたのを修正。
 145                     [[Help:条件文]]の関数をテンプレートとして処理しようとしてしまっていたのを修正。
 146                     初期設定を若干追加。
 147                     配布元をSourceForge.JPに移転。
 148                     ※ 処理の見直しも行っているため、上記以外の細かい部分の動作にも変更が生じているはずです。
 149                     ※ 1.01とは設定ファイルの互換性がありません。
 150
 151 Ver1.11  2012/02/19 英語リソースの追加（ツールチップは除く）。
 152                     表示言語の切り替え機能を追加。
 153                     記事名にコロンを含むページが正しく処理できない問題を修正。
 154                     ..形式の相対リンクのサブページが処理できない問題を修正。
 155                     メイン画面の言語プルダウンに存在しないコードを手入力するとエラーになる問題を修正。
 156                     設定画面をキャンセルした際も言語タブの設定だけ更新されてしまっていたのを修正。
 157                     設定画面で言語を追加する際のインタフェースが分かりにくかったのを改善。
 158                     その他画面表示周りを中心に小不具合を修正。
 159                     変換後テキストの冒頭の元言語を{{Lang}}で囲むよう改善。
 160                     通信エラー時にリトライする仕組みを追加。
 161                     未解決の既知の不具合について、警告等を表示するよう暫定対応。
 162                     トランスレータ周りのソース中心にリファクタリングを実施。
 163                     ※ 1.10とは設定ファイルの互換性がありません。
 164
 165 Ver1.20  2012/0x/xx Wiktionaryでの動作に対応。
 166                     設定の切り替え／追加機能を追加。
 167                     見出しの置き換えに改行区切りで複数の語句を登録できるよう改良。
 168                     画面表示周りの処理の改善／小不具合を修正。
 169                     ※ 1.11とは設定ファイル名が変化しており、古い設定は自動で読み込まれません。
 170
 171
 172
 173 ・仕様上の制限
 174 プログラム上の問題により、記事名がピリオドで終わるページは処理できません。
 175 （例、[[Vulcan Inc.]]）
 176
 177 キャッシュの一覧で一度に大量の項目を削除すると、フリーズしたかのように時間がかかります。
 178
 179 上記2点については、該当する処理に関連する部分に警告メッセージを表示しています。
 180
 181 その他、Wikipedia上言語間リンクが存在しても、現行のアプリでは見つけられないページもあります。
 182 （例、{{Refbegin}}と条件文で出し分けている{{Refend}}, どうやってるかよく分からない {{Documentation}}）
 183 これらについては対応できない特殊ケースとして、設定→記事の置き換えに変換パターンを初期設定しています。