Wptscs/Readme.txt

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