1 <?xml version="1.0" encoding="UTF-8"?>
3 <title>プラグイン<indexterm>
4 <primary>plugins</primary>
7 <para>WinMergeプラグインは、COM APIで書かれたカスタムDLLまたはスクリプトレットです。
9 例えば、WinMergeで比較するためにMS Word のファイルからテキストデータを抽出するプラグインがあります。</para>
11 <para>プラグインは:<indexterm>
12 <primary>installing plugins</primary>
17 <para>1つのdllまたはスクリプトレット (<filename
18 class="extension">sct</filename>) ファイル</para>
22 <para><filename class="directory">MergePlugins</filename>
23 サブフォルダにインストールされます。WinMergeでは、いくつかのプラグインをインストールすることができます。</para>
27 <para>インストールが簡単: WinMergeのインストールに含まれていないプラグインをインストールするには、プラグインファイルを<filename
28 class="directory">MergePlugins</filename> にコピーするだけです。
29 プラグインは、次回WinMergeを開いたときに利用可能になります。
30 ウェブ上で他の開発者が書いた多くのプラグインを見つけることができます。
36 <title>プラグインの種類</title>
38 <para>プラグインは3つの主なカテゴリに分類されます:</para>
42 <term>エディタスクリプトプラグイン<indexterm>
43 <primary>editor complement plugins</primary>
47 <para>このタイプのプラグインは、ファイル比較ウィンドウのアクティブなエディタ(ファイルペイン)で選択したテキストに対してカスタム操作を実行します。
53 <term>展開プラグイン - ファイルからテキストフォーマットへ<indexterm>
54 <primary>unpacker plugins</primary>
58 <para>このタイプのプラグインは、圧縮ファイルを解凍して表示可能な形式に変換します。 元のファイルは変更されません。
59 一時的に変換されたファイルが作成され、WinMergeにロードされます。
62 <para>展開プラグインは、選択されたテキストやファイル内の差分に対してではなく、ファイル全体に対して機能します。
63 したがって、フォルダ比較ウインドウまたはファイルまたは
64 フォルダの選択ダイアログからファイル比較を起動するときのみ利用可能です。
65 展開プラグインはファイル比較ウィンドウでは利用できません。
68 <para>プラグインによっては、展開されたファイルを再圧縮することができます
69 (<xref linkend="Plugins_available" /> の詳細を参照して、
70 再圧縮がサポートされているかどうかを確認してください)。 その後、変換されたファイルをマージして保存できます。 この場合、梱包は自動的に行われます。
71 安全のために、変換したファイルを保存するときに名前を変更することをお勧めします。
75 <para>フォルダを比較すると、WinMergeは圧縮ファイルと非圧縮ファイルに
76 対して異なる結果をもたらす可能性があります。
77 たとえば、圧縮されていないときには同一のファイルでも、
78 圧縮された場合、作成日が含まれているために異なる場合があります。
79 WinMergeはすべての状況で展開プラグインを適用します。フォルダを比較するときや、
80 2つのファイルを比較するときでも同じ結果が得られます</para>
83 <para>プラグインの例: <xref linkend="CompareMSExcelFiles" />
84 <trademark class="registered">Microsoft</trademark>
85 <application>Excel</application> ファイルのテキスト内容を表示します。</para>
90 <term>比較前処理プラグイン: 差異を隠すためのファイルの前処理<indexterm>
91 <primary>prediffer plugins</primary>
96 比較ウィンドウに表示されている元のファイルには作用しません。
97 代わりに元のファイルから何らかの加工を行ったファイルを一時的に作成し、
98 そのファイルから差異リストを作成します。</para>
100 <para>プラグインの例: <xref linkend="IgnoreColumns" />
101 指定された列範囲に表示されている文字の違いを
109 <title>提案されたプラグインと自動モード</title>
111 <para>WinMergeはどのようにして渡されたファイルに適切なプラグインを適用しているのでしょうか?
112 各プラグインはファイル拡張子のリストを持っています
113 (<xref linkend = "Plugins_available" />セクションの各プラグインの<citetitle>ファイルフィルタ</citetitle>にも
114 リストされています) その拡張子は、1つ以上のファイルタイプをプラグインに関連付けるために使用されます。:
115 比較するファイルの拡張子があるプラグインの拡張子リストと一致する場合、
116 そのプラグインが<firstterm>提案されたプラグイン</firstterm>となります。
119 <para>このトピックで後述する展開プラグインタイプと比較前処理プラグインタイプには
120 別々のオプションがあり、これらを使用して手動または自動でプラグインを適用できます。
121 エディタスクリプトプラグインには自動モードはありません。
124 <para>自動モードを使用して選択したファイルにプラグインを適用すると、
125 WinMergeは、そのファイルタイプの推奨プラグインのリストを検索し、
126 名前が一致する最初のプラグインを適用します。
127 検索はアルファベット順で実行されます。このため、ファイルタイプに複数の推奨プラグインがある場合、
128 最初に見つかったもののみが適用されます。</para>
132 <title>プラグインの適用</title>
134 <para>次のサブセクションでは、各タイプのプラグインを適用する方法について説明します。
136 フォルダーとファイルのどちらを比較するかどうかによっても異なります。</para>
139 <title>ファイル比較ウインドウでのエディタスクリプトプラグイン適用
142 <para>ファイル比較ウィンドウのファイルペインにカーソルを置き、
144 <guimenu>プラグイン</guimenu>
146 <guisubmenu>スクリプト</guisubmenu>
147 </menuchoice>をクリックして、次の機能のいずれかを選択します:</para>
151 <para><function>MakeUpper</function></para>
155 <para><function>MakeLower</function></para>
159 <para><function>SortAscending</function></para>
163 <para><function>SortDescending</function></para>
167 <para><function>ExecFilterCommand</function></para>
171 <para><function>InsertDate</function></para>
175 <para><function>InsertTime</function></para>
179 <para><guisubmenu>スクリプト</guisubmenu> メニューのこの機能は、<xref
180 linkend="EditorAddin" /> と <xref linkend="Plugins_datetime" /> プラグイン
186 フォルダー比較ウインドウでは使用できません。</para>
191 <title>フォルダ比較ウインドウでの展開プラグインの適用</title>
193 <para>展開プラグインを適用する前に、
194 モードを自動モードまたは手動モードに設定できます。</para>
198 <para>このタイプのプラグインの自動モードを設定するには、 <menuchoice>
199 <guimenu>プラグイン</guimenu>
201 <guimenuitem>自動展開</guimenuitem>
202 </menuchoice>をクリックしてください。</para>
206 <para>手動モードを設定するには、<menuchoice>
207 <guimenu>プラグイン</guimenu>
209 <guimenuitem>手動展開</guimenuitem>
210 </menuchoice>をクリックしてください。</para>
214 <para>新たな設定を反映するにはフォルダー比較ウィンドウを<keycap>F5</keycap>をクリックして、
218 <title>自動展開モードの使用</title>
220 <para>自動展開が設定されているときにプラグインを適用するには、
221 フォルダー比較ウィンドウでファイルの比較操作を開始するだけです。
222 ファイルのタイプから自動的に選択された展開プラグイン(存在する場合)がファイルを前処理し、
223 WinMergeがファイル比較ウィンドウで開きます</para>
225 <para>たとえば、MS Wordの<filename>doc</filename>ファイルを右クリックして
226 <guimenuitem>Compare</guimenuitem>を選択するとします
227 (<xref linkend="Plugins_msword" />プラグインが利用可能であると仮定します)。
228 WinMergeは、docファイル(またはそのコピー)をプレーンテキストファイルに変換し、
229 ファイル比較ウィンドウで開きます。</para>
233 <title>手動展開モードの使用</title>
235 <para>手動モードでは、自動モードで選択されたものとは異なる展開プラグインを選択できます。
236 プラグインを使用せずに比較することもできます。</para>
238 <para>手動展開が設定されているときにプラグインを適用するには:</para>
242 <para>比較するファイルを選択します。</para>
247 <guimenu>プラグイン</guimenu>
249 <guimenuitem>展開プラグインで開く</guimenuitem>
250 </menuchoice>をクリックします</para>
252 <para>選択したファイルのタイプが利用可能な展開プラグインによってサポートされている場合にのみ、
253 このメニュー項目が有効になります。</para>
257 <para>展開プラグインの選択ダイアログで:</para>
259 <xi:include href="select_unpacker.xml"
260 xmlns:xi="http://www.w3.org/2001/XInclude"
261 xpointer="element(select-unpacker-proc)" />
265 <para><guibutton>OK</guibutton>をクリックして、
266 「展開プラグインの選択」ダイアログを閉じて、ファイル比較を開始します。</para>
273 <title>ファイル/フォルダ選択ダイアログでの展開プラグインの適用
276 <para>「ファイルまたはフォルダーの選択」ダイアログからファイル比較を起動するときに、
277 「展開プラグインの選択」ダイアログを使用してプラグインを適用できます。
278 詳細は、<xref linkend="Open_paths_unpacker" /> を参照してください。</para>
282 <title>フォルダ比較ウインドウでの比較前処理プラグインの適用</title>
284 <para>比較前処理プラグインでは、モード(<firstterm>自動比較前処理</firstterm>または
285 <firstterm>比較前処理なし</firstterm>)を個々のファイルに設定します。
286 (これをすべてのファイルのモードを設定する展開プラグインと比較してください。)
287 つまり、同じフォルダー内のいくつかのファイルには異なる比較前処理モードがあります。
290 <para>フォルダー比較ウィンドウで1つ以上のファイルのモードを設定するには、
291 ファイルを右クリックして<menuchoice>
292 <guimenu>プラグイン設定</guimenu>
294 <guisubmenu>比較前処理プラグイン設定</guisubmenu>
295 </menuchoice>を選択し、サブメニューオプションのいずれかを選択します。</para>
299 <para><guisubmenu>自動</guisubmenu> は、
300 指定したファイルのタイプに使用できる比較前処理プラグインの最初のものを選択します。
305 <para><guisubmenu>使用しない</guisubmenu>は、
306 比較前処理プラグインを使用しません。</para>
310 <para>ウィンドウを更新するには<keycap>F5</keycap>をクリックしてください。</para>
313 <para>非再帰比較中にサブフォルダーを開くと、モードは常に
314 <guimenuitem>なし</guimenuitem>にリセットされます。</para>
317 <para>フォルダ比較ウィンドウからファイルを開くと、
318 ファイル比較ウィンドウが開く前にそのファイルの比較前処理プラグイン設定が適用されます。
323 <title>ファイル比較ウインドウでの比較前処理プラグインの適用</title>
327 <guimenu>プラグイン</guimenu>
329 <guisubmenu>比較前処理プラグイン</guisubmenu>
330 </menuchoice>をクリックして、リスト内のプラグインの1つを選択することにより、
331 比較前処理プラグインを適用できます。推奨されるプラグインはリストの上部に示されています。
332 プラグインが適用された後にファイルが再度比較されるため、ファイルを再スキャンする必要はありません。</para>
336 <section id="Plugins_available">
337 <title>使用できるプラグイン<indexterm>
338 <primary>Visual Basic dlls for plugins</primary>
339 </indexterm><indexterm>
340 <primary>plugins</primary>
342 <secondary>Visual Basic dlls</secondary>
345 <section id="CompareMSExcelFiles">
346 <title><filename>CompareMSExcelFiles.sct<indexterm>
347 <primary>CompareMSExcelFiles.sct plugin file</primary>
348 </indexterm></filename></title>
351 class="registered">Microsoft</trademark> <application>Excel</application>
352 ファイルのテキストの内容を表示します。すべてのフォーマットおよび埋め込みオブジェクトは取り除かれて表示されます。</para>
354 <para><segmentedlist>
355 <segtitle>分類</segtitle>
357 <segtitle>ファイルフィルタ</segtitle>
359 <segtitle>書き戻し</segtitle>
361 <segtitle>設定ダイアログサポート</segtitle>
363 <segtitle>依存するもの</segtitle>
368 <seg><filename class="extension">*.xls</filename><filename
369 class="extension">*.xlsx</filename><filename
370 class="extension">*.xlsm</filename><filename
371 class="extension">*.xlsb</filename><filename
372 class="extension">*.xla</filename><filename
373 class="extension">*.xlax</filename><filename
374 class="extension">*.xltx</filename><filename
375 class="extension">*.xltm</filename></seg>
381 <seg><trademark class="registered">Microsoft</trademark>
382 <application>Excel</application></seg>
384 </segmentedlist></para>
387 <section id="Plugins_msword">
388 <title><filename>CompareMSWordFiles.sct<indexterm>
389 <primary>CompareMSWordFiles.sct plugin file</primary>
390 </indexterm></filename></title>
393 class="registered">Microsoft</trademark> <application>Word</application>
394 ファイルのテキストの内容を表示します。すべてのフォーマットおよび埋め込みオブジェクトは取り除かれて表示されます。</para>
396 <para><segmentedlist>
397 <segtitle>分類</segtitle>
399 <segtitle>ファイルフィルタ</segtitle>
401 <segtitle>書き戻し</segtitle>
403 <segtitle>設定ダイアログサポート</segtitle>
405 <segtitle>依存するもの</segtitle>
410 <seg><filename class="extension">*.doc</filename>, <filename
411 class="extension">*.docx</filename>, <filename
412 class="extension">*.docm</filename>, <filename
413 class="extension">*.dot</filename>, <filename
414 class="extension">*.dotx</filename>, <filename
415 class="extension">*.dotm</filename></seg>
421 <seg><trademark class="registered">Microsoft</trademark>
422 <application>Word</application></seg>
424 </segmentedlist></para>
427 <section id="Plugins_powerpnt">
428 <title><filename>CompareMSPowerPointFiles.sct<indexterm>
429 <primary>CompareMSPowerPointFiles.sct plugin file</primary>
430 </indexterm></filename></title>
433 class="registered">Microsoft</trademark> <application>PowerPoint</application>
434 ファイルのテキストの内容を表示します。すべてのフォーマットおよび埋め込みオブジェクトは取り除かれて表示されます。</para>
436 <para><segmentedlist>
437 <segtitle>分類</segtitle>
439 <segtitle>ファイルフィルタ</segtitle>
441 <segtitle>書き戻し</segtitle>
443 <segtitle>設定ダイアログサポート</segtitle>
445 <segtitle>依存するもの</segtitle>
450 <seg><filename class="extension">*.ppt</filename>, <filename
451 class="extension">*.pptx</filename>, <filename
452 class="extension">*.pptm</filename>, <filename
453 class="extension">*.ppa</filename>, <filename
454 class="extension">*.ppam</filename>, <filename
455 class="extension">*.pot</filename>, <filename
456 class="extension">*.potx</filename>, <filename
457 class="extension">*.potm</filename></seg>
463 <seg><trademark class="registered">Microsoft</trademark>
464 <application>PowerPoint</application></seg>
466 </segmentedlist></para>
469 <section id="Plugins_visio">
470 <title><filename>CompareMSVisioFiles.sct<indexterm>
471 <primary>CompareMSVisioFiles.sct plugin file</primary>
472 </indexterm></filename></title>
475 class="registered">Microsoft</trademark> <application>Visio</application>
476 ファイルのテキストの内容を表示します。すべてのフォーマットおよび埋め込みオブジェクトは取り除かれて表示されます。</para>
478 <para><segmentedlist>
479 <segtitle>分類</segtitle>
481 <segtitle>ファイルフィルタ</segtitle>
483 <segtitle>書き戻し</segtitle>
485 <segtitle>設定ダイアログサポート</segtitle>
487 <segtitle>依存するもの</segtitle>
492 <seg><filename class="extension">*.vsd</filename>, <filename
493 class="extension">*.vsdx</filename>, <filename
494 class="extension">*.vsdm</filename>, <filename
495 class="extension">*.vss</filename>, <filename
496 class="extension">*.vssx</filename>, <filename
497 class="extension">*.vssm</filename>, <filename
498 class="extension">*.vst</filename>, <filename
499 class="extension">*.vstx</filename>, <filename
500 class="extension">*.vstm</filename></seg>
506 <seg><trademark class="registered">Microsoft</trademark>
507 <application>Visio</application></seg>
509 </segmentedlist></para>
512 <section id="EditorAddin">
513 <title><filename>editor addin.sct<indexterm>
514 <primary>editor addin.sct plugin file</primary>
515 </indexterm></filename></title>
517 <para>5つの機能を<menuchoice>
518 <guimenu>プラグイン</guimenu>
520 <guisubmenu>スクリプト</guisubmenu>
521 </menuchoice> メニューに追加します:</para>
525 <simpara><guimenuitem>MakeUpper</guimenuitem> は、選択範囲を大文字に変換します。
530 <simpara><guimenuitem>MakeLower</guimenuitem> 選択範囲を小文字に変換します。
535 <simpara><guimenuitem>SortAscending</guimenuitem> 選択範囲を昇順でソートします。
540 <simpara><guimenuitem>SortDescending</guimenuitem> 選択範囲を降順でソートします。
545 <simpara><guimenuitem>ExecFilterCommand</guimenuitem> 指定したフィルタコマンドの出力で選択範囲を置換します。
550 <para><segmentedlist>
551 <segtitle>分類</segtitle>
552 <segtitle>設定ダイアログサポート</segtitle>
555 <seg>Editor complement</seg>
558 </segmentedlist></para>
561 <section id="IgnoreColumns">
562 <title><filename>IgnoreColumns.dll<indexterm>
563 <primary>IgnoreColumns.dll plugin file</primary>
564 </indexterm></filename></title>
566 <para>このプラグインは、指定された列の文字を無視します。 最初の列の番号は1です</para>
568 <para>このプラグインはタブ付きのファイルをサポートしていないことに注意してください。
569 プラグインは失敗しませんが、すべてのタブは通常の文字として扱われます。
572 <para>列を指定するには、プラグイン設定ダイアログを使用するか、次のフィールドをパラメーターとして使用して<filename>dll</filename>の名前を変更します:
577 <simpara>範囲間の区切り文字: _ または ,</simpara>
581 <simpara>最小と最大の間の区切り文字: <emphasis>その他の文字
582 </emphasis></simpara>
586 <simpara>最小と最大は範囲に含まれます。</simpara>
590 <simpara>max = minの場合、maxは省略できます。</simpara>
595 <title><filename>IgnoreColumns.dll</filename> examples</title>
599 <term><filename>IgnoreColumns _ 3 _ 10 - 20 _ 32 -
600 33.dll</filename></term>
603 <simpara>列3、列10から20、列32から33のすべての文字を無視します。</simpara>
608 <term><filename>IgnoreColumns_1,30 to 40.dll</filename></term>
611 <simpara>列1と列30から40のすべての文字を無視します。
618 <para><segmentedlist>
619 <segtitle>分類</segtitle>
621 <segtitle>ファイルフィルタ</segtitle>
623 <segtitle>設定ダイアログサポート</segtitle>
626 <seg>比較前処理プラグイン</seg>
628 <seg><filename class="extension">*.txt</filename></seg>
632 </segmentedlist></para>
636 <title><filename>IgnoreCommentsC.dll<indexterm>
637 <primary>IgnoreCommentsC.dll plugin file</primary>
638 </indexterm></filename></title>
640 <para>このプラグインはC言語, C++, PHP, JavaScript ファイルの<constant> //</constant>... と
641 <constant>/*</constant> ... <constant>*/</constant> で区切られたコメントを無視します。
644 <para><segmentedlist>
645 <segtitle>分類</segtitle>
647 <segtitle>ファイルフィルタ</segtitle>
649 <segtitle>設定ダイアログサポート</segtitle>
652 <seg>比較前処理プラグイン</seg>
654 <seg><filename class="extension">*.cpp</filename>, <filename
655 class="extension">*.cxx</filename>, <filename
656 class="extension">*.h</filename>, <filename
657 class="extension">*.hxx</filename>, <filename
658 class="extension">*.c</filename>, <filename
659 class="extension">*.php</filename>, <filename
660 class="extension">*.js</filename>, <filename
661 class="extension">*.cs</filename>, <filename
662 class="extension">*.ts</filename>,</seg>
666 </segmentedlist></para>
670 <title><filename>IgnoreFieldsComma.dll<indexterm>
671 <primary>IgnoreFieldsComma.dll plugin file</primary>
672 </indexterm></filename></title>
674 <para>このプラグインは、フィールドとコンマを区切り文字として使用するファイル用です
675 (CSVファイルなど)。 区切り文字は無視されます。 最初のフィールドの番号は1です。
678 <para>区切り文字を指定するには、プラグイン設定ダイアログを使用するか、
679 <xref linkend="IgnoreColumns" />に使用されるのと同じパラメーターフィールドを使用して
680 <filename>dll</filename>の名前を変更します。</para>
682 <para><segmentedlist>
683 <segtitle>分類</segtitle>
685 <segtitle>ファイルフィルタ</segtitle>
687 <segtitle>設定ダイアログサポート</segtitle>
690 <seg>比較前処理プラグイン</seg>
692 <seg><filename class="extension">*.csv</filename></seg>
696 </segmentedlist></para>
700 <title><filename>IgnoreFieldsTab.dll<indexterm>
701 <primary>IgnoreFieldsTab.dll plugin file</primary>
702 </indexterm></filename></title>
704 <para>このプラグインは、フィールドとタブを区切り記号として使用するファイル用です
705 (<application>たとえばExcel </application>ファイルは<filename
706 class="extension">*.txt</filename>形式で保存されます)。 区切り文字は無視されます。
710 <para>To specify the delimiters, use plugin settings dialog or rename the <filename>dll</filename> using
711 the same parameter fields used for <xref
712 linkend="IgnoreColumns" />.</para>
714 <para><segmentedlist>
715 <segtitle>分類</segtitle>
717 <segtitle>ファイルフィルタ</segtitle>
719 <segtitle>設定ダイアログサポート</segtitle>
722 <seg>比較前処理プラグイン</seg>
724 <seg><filename class="extension">*.txt</filename></seg>
728 </segmentedlist></para>
732 <title><filename>IgnoreLeadingLineNumbers.dll<indexterm>
733 <primary>IgnoreLeadingLineNumbers.dll plugin file</primary>
734 </indexterm></filename></title>
736 <para>このプラグインは、テキストファイル
737 (NCファイルやBASICファイルなど)の先頭の行番号を無視します。
740 <para><segmentedlist>
741 <segtitle>分類</segtitle>
743 <segtitle>ファイルフィルタ</segtitle>
745 <segtitle>設定ダイアログサポート</segtitle>
747 <segtitle>必要なもの</segtitle>
750 <seg>比較前処理プラグイン</seg>
752 <seg><filename class="extension">*.nc</filename></seg>
756 <seg><xref linkend="MSVBVM60" /></seg>
758 </segmentedlist></para>
761 <section id="Plugins_datetime">
762 <title><filename>insert datetime.sct<indexterm>
763 <primary>insert datetime.sct plugin file</primary>
764 </indexterm></filename></title>
767 <guimenu>プラグイン</guimenu>
769 <guisubmenu>スクリプト</guisubmenu>
770 </menuchoice> メニューに2つの機能を追加します:</para>
774 <simpara><guimenuitem>InsertDate</guimenuitem> insert date in the
775 current locale format.</simpara>
779 <simpara><guimenuitem>InsertTime</guimenuitem> insert time in the
780 current locale format.</simpara>
784 <para><segmentedlist>
785 <segtitle>分類</segtitle>
787 <segtitle>設定ダイアログサポート</segtitle>
790 <seg>Editor complement</seg>
794 </segmentedlist></para>
799 <title>必要なもの<indexterm>
800 <primary>plugins</primary>
802 <secondary>Windows Script Host requirement</secondary>
806 <title>Windows Script Host</title>
808 <para>一部のエディター補完プラグインには、
809 <trademark class="registered">Microsoft</trademark>のコンポーネントが必要です</para>
811 <para>Windows XPより前の古いバージョンのWindowsを使用しない限り、既に含まれているはずです。
815 <section id="MSVBVM60">
816 <title><application>Visual Basic</application> ランタイムライブラリ<indexterm>
817 <primary>Visual Basic dlls for plugins</primary>
818 </indexterm><indexterm>
819 <primary>plugins</primary>
821 <secondary>Visual Basic dlls</secondary>
822 </indexterm><indexterm>
823 <primary>msvbvm60.dll plugin file</primary>
824 </indexterm><indexterm>
825 <primary>Run-Time Redistribution Pack, for Visual Basic
829 <para>一部のプラグインでは、動作するために<application>Visual Basic</application>
830 ランタイムライブラリが必要です。</para>
832 <para><trademark class="registered">Microsoft</trademark>の<ulink
833 url="https://www.microsoft.com/en-us/download/details.aspx?id=24417">Run-Time
834 Redistribution Pack</ulink>が使用できます。
835 プラグインが不要な場合は、安全に削除できます。