Wptscs/Readme.txt

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