マウスポインタをしばらくエディットボックスやチェックボックスなどの上に置いておくと、ヘルプのツールチップがポップアップして、設定がなんのために変更できるのかが分かります。
このダイアログでは、好みの言語を指定したり、Subversion 特有の設定を行うことができます。
ユーザーインターフェイスの言語を選択してください。もちろん、英語以外を利用する場合は適切な言語パックを先にインストールしておく必要があります。
チェックすると、TortoiseSVN は週に一度、ダウンロードサイトに接続して、プログラムの新バージョンがリリースされているかを調べます。結果をすぐに知りたければ、
を押してください。新バージョンがダウンロードされるわけではありません。単に新バージョンがあるという、情報ダイアログが表示されるだけです。TortoiseSVN にはデフォルトで3つのカスタムサウンドがインストールされています。
エラー
注意
警告
Windows のコントロールパネルで別のサウンド(もしくは完全に OFF)を選択できます。
はコントロールパネルへのショートカットです。Windows Vista 以降のシステムでは、ダイアログに Aero スタイルを使用するかどうか制御することができます。
Windows 7 では、システムのさまざまな場所に散在している作業コピーをグループ化するためのライブラリを作成することができます。
常に無視するパターンは、バージョン管理外のファイルを、コミットダイアログなどで表示されないようにするのに使用します。パターンにマッチしたファイルは、インポートでも無視されます。除外するファイルやディレクトリは、名前や拡張子で判断されます。パターンは空白で区切り、 bin obj *.bak *.~?? *.jar *.[Tt]mp
のようにします。このパターンにはパス区切り文字を含めないでください。また、ファイルとディレクトリを区別することができないことに注意してください。パターンマッチの文法の詳細は、 「無視リストでのパターンマッチ」 を参照してください。
ここで指定した無視パターンは、同じPCで動作する他の Subversion クライアント(コマンドラインクライアントを含む)でも有効になることに注意してください。
Subversion の設定ファイルで global-ignores
パターンを設定していると、この設定を上書きしてしまいます。 Subversion の設定ファイルには、下にある ボタンでアクセスできます。
この無視パターンはすべてのプロジェクトに影響します。バージョン管理されませんので、他のユーザーには影響しません。一方、バージョン管理の svn:ignore
や svn:global-ignore
プロパティを使用し、バージョン管理からファイルやディレクトリを除外することもできます。詳細は 「ファイルやディレクトリの無視」 をご覧ください。
このオプションは、チェックアウトや更新時にコミット時の日時をファイルの更新日時として使うよう、TortoiseSVN に指示します。そうでなければ、 TortoiseSVN は現在の日時を使用します。ソフトウェアを開発しているなら、ビルドシステムがコンパイルの要否を判断するのにタイムスタンプを使用するので、現在の日時にしておくのが最善でしょう。「最後にコミットした日時」 を使用していると、ファイルを古いリビジョンに戻す場合、プロジェクトがコンパイルされない可能性があります。
Subversion 設定ファイルを直接編集するには config
ファイルについての詳細情報は、Runtime Configuration Area をご覧ください。Automatic Property Setting の節には興味深い項目があり、これはここで設定します。Subversion は複数の設定情報を読み込めますが、その優先順位を知っておかなくてはならないことに注意してください。詳細は Configuration and the Windows Registry を参照してください。
このオプションは、 TortoiseSVN が作業コピーを更新する時に、 svn:externals
プロパティにローカルで行われた変更を常に適用することを示します。
このページでは、メインコンテキストメニューと TortoiseSVN サブメニューに現れる TortoiseSVN コンテキストメニューエントリを指定できます。デフォルトでは、ほとんどの項目にチェックが付いておらず、サブメニューに表示されません。
ロックを取得 は特殊です。もちろん上のリストを用いてトップレベルに表示できますが、ロックの必要がないほとんどのファイルにとっては乱雑なだけです。しかし、svn:needs-lock
プロパティが設定されているファイルには、いつでも編集できるように、このアクションが必要です。この場合トップレベルに表示している方が便利です。このボックスをチェックしておくと、svn:needs-lock
プロパティが設定されているファイルを選択すると、ロックを取得 がいつでもトップレベルに表示されるようになります。
Subversion のバージョン管理下にあるフォルダーを離れているときは、ほとんどの場合、 TortoiseSVN のコンテキストメニューを使用しません。バージョン管理外のフォルダーで本当にコンテキストメニューを必要とするのは、チェックアウト時くらいでしょう。バージョン管理外のパスではメニューを表示しない
のオプションをチェックすると、 バージョン管理外フォルダーのコンテキストメニューでは、TortoiseSVN のメニュー項目が表示されなくなります。ただし、バージョン管理下のフォルダーでは、すべての項目を表示します。 Shift を押しながらコンテキストメニューを表示させると、バージョン管理外のフォルダーでもすべてのメニュー項目を表示させることができます。
TortoiseSVN のコンテキストメニューにも現れて欲しくない、コンピューター上のパスがある場合、下にあるボックスの項目を一覧できます。
このダイアログでは、TortoiseSVN のダイアログをお好みに設定できます。
最初に
→ を選択したとき、 TortoiseSVN が取得するログメッセージをこの数に制限します。サーバーへの接続が遅い場合に便利です。もっとメッセージを取得するには や を使用してください。リビジョンログダイアログの中央の欄で、ログメッセージが表示される際に使用されるフォントとサイズを指定します。これは、コミットダイアログでログメッセージを編集する際にも使われます。
標準の長いメッセージ形式で使用するには画面が狭い場合、短い形式を使用します。
ログダイアログの上の欄のリストを使用してリビジョンの比較を頻繁に行う場合は、このオプションを有効にすると、ダブルクリックで比較できるようになります。差分の取得には時間がかかるため、デフォルトでこのオプションは有効になっていません。多くの人は、間違ってダブルクリックした際に長時間待たされるのを避けたいということから、このオプションをデフォルトで有効にしていません。
TortoiseSVN のコマンドがエラーがなく終了すると、進行ダイアログを自動で閉じることができます。この設定でダイアログを閉じる条件を選択できます。デフォルト(推奨)設定は手動で閉じるで、全てのメッセージを見て、何が起きたのか確認できます。しかし、ある種のメッセージは無視して、重要な変更がなければ自動で閉じてもらいたいということもあります。
マージ、追加、削除がなければ自動的に閉じるは、単純な更新のみの場合は進行ダイアログを閉じますが、リポジトリからの変更をマージする必要がある場合や、ファイルの追加・削除がある場合はダイアログを開いたままにします。また処理中に、なんらかの競合やエラーが発生した場合にも開いたままになります。
競合がなければ自動的に閉じるはもっと基準をゆるめ、マージ、追加、削除が起きてもダイアログを閉じますが、競合が発生した場合はダイアログを開いたままにします。
エラーがなければ自動的に閉じるは、競合が発生しても、 Subversion が処理を継続できないようなエラーが発生しない限りダイアログを閉じます。例えば、サーバーにアクセスできずに更新が失敗したり、作業コピーが最新ではなくコミットができない場合などです。
ファイルの追加や変更の取り消しといったローカル操作は、リポジトリへのアクセスは必要なく、短時間で完了します。そのため、進行状況ダイアログは重要でないことがしばしばあります。エラーが発生しない時に限り、これら操作後に自動で進行状況ダイアログを閉じる場合は、このオプションを選択してください。
ローカルの変更を取り消す際、既に行っていた変更は破棄されます。TortoiseSVN では安全のために、元のコピーに戻す前に、変更したファイルをごみ箱に入れます。ごみ箱に入れるのをスキップしたい場合は、このオプションのチェックを外してください。
マージダイアログでは、デフォルトの動作は 元: の URL を記憶している所にマージします。しかし、階層内のいくつもの違う場所からマージを実行したい人もいますし、現在の作業コピーの URL からはじめる方が簡単な場合があります。また、別のブランチにある平行したパスを参照しながら編集するのにも使用できます。
チェックアウトのデフォルトパスを指定できます。チェックアウトした物をすべて一カ所に保持しておく場合、ドライブやフォルダーをあらかじめ設定しておいてくれ、最後に新しいフォルダー名を追加するだけですみます。
チェックアウトのデフォルト URL も指定できます。非常に大きいプロジェクトのサブプロジェクトをちょくちょくチェックアウトする場合、URL をあらかじめ設定しておいてくれ、最後にサブプロジェクト名を追加するだけですみます。
チェックすると(デフォルト状態)、追加、コミット、変更をチェックダイアログに、バージョン管理外のフォルダーやそれ以下の階層のファイルやフォルダがすべて表示されます。チェックしないと、以下の階層は表示されません。チェックを外せば、上記のダイアログが煩雑にならずに済みます。この場合、バージョン管理外のフォルダーを追加するよう選択すると、再帰的に追加されます。
変更をチェック ダイアログでは、無視される項目を表示するか選択できます。このチェックボックスにチェックして、無視されたフォルダーを表示すると、その中にある項目も同様に見られるようになります。
コミットダイアログはコミットするファイル名の一覧を保持しています。一覧にある項目の始めの 3 文字をタイプすると、自動補完ボックスがポップアップし、Enter を押すとファイル名が補完されます。チェックするとこの機能が有効になります。
大きなファイルをチェックしていて、自動補完パーサが遅すぎることがあります。コミットダイアログが長い時間止まってしまうのなら、ここで指定した時間でタイムアウトするようになります。重要な自動補完情報を見逃してしまうのなら、タイムアウトを長くできます。
tsvn:projectlanguage
が設定されている場合はスペルチェッカーを使用するコミット時にスペルチェッカーを使用しない場合、ここにチェックをつけてください。プロジェクトプロパティで必要だと指定したときだけ、動作するようになります。
コミットダイアログでログメッセージを入力すると、TortoiseSVN は後で再利用できるようにメッセージを記憶します。デフォルトでは、リポジトリごとに最新のログメッセージを 25 個記憶していますが、ここでその数をカスタマイズできます。たくさんの異なるリポジトリがあるなら、レジストリがいっぱいにならないように、少なくしておくといいでしょう。
この設定は、このコンピューターで入力したメッセージにのみ適用されることに、ご注意ください。ログキャッシュには何も影響を与えません。
コミットダイアログの通常動作は、全ての(バージョン管理下の)変更があるファイルをコミットするよう、自動的に選択します。はじめに何も選択せず、コミットする項目を手作業で選択する場合、このチェックボックスのチェックを外してください。
コミットされていないファイルやフォルダーがあった場合、コミット完了後に同じディレクトリで自動的にコミットダイアログを再度開きます。
デフォルトでは「変更をチェック」ダイアログで作業コピーのチェックが行われ、
がクリックされた時だけリポジトリへの接続を行います。常にリポジトリをチェックするようにしたい場合、これを設定すると、この動作が自動的に行われるようになります。ひとつないし複数のファイルを選択し、
→ を使用してそのファイルをロックする際、プロジェクトによっては、なぜそのファイルをロックしたかを説明するロックメッセージを書くことになっています。ロックメッセージを使用しない場合には、このチェックボックスのチェックをはずすと、ダイアログをスキップし、すぐにファイルをロックします。フォルダーにたいしてロックコマンドを使用する場合、ロックするファイルを選択するため、常にロックダイアログを表示します。
プロジェクトで tsvn:lockmsgminsize
プロパティを使用している場合、そのプロジェクトはロックメッセージが 必須 なので、設定がどうであってもロックダイアログを表示します。
Settings for the repository browser:
このチェックボックスをチェックすると(デフォルトの状態)、リポジトリブラウザーはバックグラウンドでフォルダーに表示される情報を取得します。そのため、フォルダーのうちの1つをクリックしたとき、情報がすでに準備されている状態になります。
しかし、サーバーによってはこのような場合に並行してアクセスされても処理できなかったり、非常に多数のアクセスを正しく扱うように設定されていなかったために、不具合が発生してブロックされてしまったりすることがあります。この場合、このチェックボックスで先読み機能を無効にしてください。
このチェックボックスをチェックすると(デフォルトの状態)、リポジトリブラウザーは svn:externals
プロパティで外部参照として設定されたファイルやフォルダーを、普通のファイルやフォルダーと同じように表示します。但し、オーバーレイアイコンでは外部ソースとして扱われます。
上記の先読み機能が有効になっていると、この機能も弱いサーバーには負担になることがあります。この場合、このチェックボックスでこの機能を無効にしてください。
There are two versions of shelfing implemented in SVN. Here you can select which version you want to use. Note that changing this setting might require an OS restart to take effect.
このバージョンはV3
よりもずっと高速で、使用を推奨します。
しかし、速度は犠牲も伴い、V2
はディレクトリの変更を扱わず、ファイルのコピーや移動も扱うことができません。
this is the latest version of the shelfing feature. It can handle changes to directories as well as file moves/copies.
しかし、V3
はV2
よりもずっと低速で、大きなリポジトリやリポジトリへの接続が遅い場合、使用に耐えないこともあり得ます。
このダイアログでは、TortoiseSVN のダイアログで使用するテキストの色をお好みに変更できます。
更新中やマージ中に発生した競合。既存のバージョン管理外のファイル・フォルダーと同じ名前のバージョン管理下のものがあると更新は妨害されます。
進行ダイアログのエラーメッセージにも使用します。
リポジトリに追加した項目。
リポジトリから削除された項目、作業コピーから紛失した項目、作業コピーから削除された項目、同じ名前で置き換えられた項目。
リポジトリからの変更を、競合もなく作業コピーにうまくマージしました。
履歴に追加されるかリポジトリ内のパスをコピーした項目。ログダイアログでも、コピーされた項目を含む場合に使用されます。
リポジトリからすでに削除された項目。
(追加・コピー・移動操作で) リポジトリに追加した項目。
リポジトリで名前の変更があった項目。
元の項目が削除され、同じ名前で新しく作成された項目。
ログダイアログで絞り込みをする際、検索語は検索結果中でこの色で強調表示されます。
other settings:
Windows 10 1809 以降、TortoiseSVN のダイアログをダークモードで表示させることができます。この機能は Windows 10 の設定でアプリケーションのダークモードの有効化が必要です。
全てのダイアログの全てのコントロールがダークテーマで表示されるわけではないことに注意してください。
リビジョングラフは、トランク、ブランチ、タグを見分けることで、リポジトリを明確に可視化しようとします。これは Subversion に組み込まれた分類ではなく、パス名から抽出した情報です。デフォルト設定では、Subversion のドキュメントで推奨されている英語名規約ですが、もちろん使い方はことなるかもしれません。
三つの矩形で表すパスを、認識するため使用するパターンを指定してください。パターンは大文字小文字を区別しませんが、小文字で書いてください。*
や ?
といったワイルドカードはいつものように使用できます。また、;
で複数のパターンを区切ってください。比較に使用されてしまうため、余計な空白は含めないでください。
これらのパターンはリビジョングラフだけではなく、タグへのコミットの検出にも使われることに注意してください。
リビジョングラフで、ノードタイプ(つまり追加、削除、名前変更といったノード)を表すのに使用する色です。ノードの分類を識別するため、ノードタイプと分類の両方を表示するよう、リビジョングラフに色をませるよう指示できます。このチェックが付いていないと、ノードタイプを表すためだけに色を使用します。使用するそれぞれの色を指定するには、色選択ダイアログを使用してください。
このページでは使用する色を設定できます。ここで指定する色は、無地の色であることにご注意ください。ほとんどのノードでは、ノードタイプ色と背景色、必要に応じて分類色を混ぜた色で着色されます。
削除され、同じリビジョンのどこにもコピーされていない項目です。
新しく追加されたか、コピー(履歴とともに追加)された項目です。
ある場所から削除され、同じリビジョンの別の場所に追加された項目です。
追加も削除もされず、単純に変更された項目です。
(グラフに表示する)変更がまったくそのリビジョンで発生しなかったとしても、コピー元として使用されるリビジョンを表示するのに使用される場合があります。
現在のリポジトリの HEAD リビジョンです。
変更された作業コピー向けに追加ノードを表示するよう選択した場合、グラフに追加された最終コミットリビジョンは、この色を使用します。
作業コピーが変更されたことを表示するように選択した場合、変更を検出すると作業コピーの境界線にこの色を使用します。
タグとして分類されたノードは、この色が混ざることがあります。
トランクとして分類されたノードは、この色が混ざることがあります。
領域を節約するためにタグを折りたたんだ場合、コピー元において、タグはこの色のブロックを使用してマークされます。
ノードを選択するためクリックしたままにした場合、選択状態を表すマーカはこの色のかたまりとなります。
グラフがサブツリーに分割された時にその色を使い、背景にその他の色が付いている場合、分割ツリーを際だたせるため、縞模様にします。
このページでは、TortoiseSVN が表示するアイコンオーバーレイの項目を選択できます。
作業コピーの状態を取得するには時間がかかるため、エクスプローラーがオーバーレイアイコンを表示するのに負荷がかからないように、 TortoiseSVN は状態をキャッシュに格納します。システムや作業コピーの大きさをもとに、 TortoiseSVN が使用するキャッシュタイプを以下から選択してください。
別のプロセス(TSVNCache.exe
)がすべての状態情報をキャッシュします。このプロセスは、全ドライブの変更を監視し、作業コピー内のファイルが更新されれば、その状態情報を再取得します。優先度が最低で動作しますので、他のプログラムが、これによりリソースをとられてしまうことはありません。これは状態情報が リアルタイム で更新されないということでもありますが、オーバーレイ表示は数秒で更新されます。
【利点】オーバーレイには再帰的な状態が表示されます。つまり、作業コピーの深い階層にあるファイルを更新すると、作業コピーの最上位までの全フォルダーにも更新オーバーレイが表示されます。さらにプロセスからシェルに通知が送られるので、通常、左のツリービューのオーバーレイ表示も変更されます。
【欠点】プロジェクトについての作業をしていないときでも、プロセスが常に動作しています。さらに、作業コピーの数や大きさにも依存しますが、およそ10~50MBの RAM を消費します。
シェル拡張 DLL の内部で直接キャッシュしますが、表示されているフォルダーのみをキャッシュします。別のフォルダーに移るたびに、ステータス情報を再取得されます。
【利点】とても少ないメモリの消費量で(およそ1MBの RAM を使用)、状態を リアルタイム に表示できます。
【欠点】単一のフォルダーしかキャッシュしないため、オーバーレイには再帰的な状態が表示されません。大きな作業コピーでは、デフォルトのキャッシュよりも、エクスプローラーのフォルダー表示に時間がかかることがあります。また、 MIME タイプ列が使用できなくなります。
この設定では、 TortoiseSVN はエクスプローラーで状態をまったく取得しません。このため、バージョン管理下にあるファイルやフォルダーには、常に「通常」がオーバーレイ表示されます。それ以外のオーバーレイは表示されず、追加の列も無効になります。
【利点】追加でメモリを使用することは絶対になく、閲覧中にエクスプローラーが遅くなることもありません。
【欠点】ファイルやフォルダーの状態情報が、エクスプローラーに表示されません。作業コピーが変更されているかどうかを確認するには、「変更をチェック」ダイアログを使用する必要があります。
デフォルトでは、ファイルを開く・保存ダイアログでも、Windows エクスプローラーと同様に、オーバレイアイコンやコンテキストメニューが表示されます。 Windows エクスプローラーで のみ 表示させる場合は、エクスプローラー上でのみオーバーレイとコンテキストメニューを表示をチェックしてください。
昇格したプロセスでの状態キャッシュを無効にするボックスをチェックすることで、昇格したプロセスでの状態キャッシュを強制的になしにすることができます。これは昇格したプロセスでもう1つの TSVNCache.exe
プロセスが作成されるのを防ぎたい場合に便利です。
バージョン管理外のファイルを含むフォルダーに、変更済マークをつけるようにもできます。これにより、まだバージョン管理下に入れてない新しいファイルを作成したのを、覚えておくのに便利です。このオプションは、キャッシュタイプ(前述)が デフォルト の場合にのみ有効です。
変更リストignore-on-commit
にファイルが登録されている場合、状態を親フォルダーの表示に反映させないようにすることができます。つまり、変更リスト内のファイルだけが変更されても、親フォルダーのオーバーレイアイコンは「未変更」のままになります。
次のグループでは、オーバーレイを表示するストレージの種類を選択できます。デフォルトでは、ハードディスクドライブしか選択されていません。アイコンオーバレイをすべて無効にもできますが、そんなことしたいですか?
ネットワークドライブはとても遅いので、デフォルトでは、ネットワークフォルダー上にある作業コピーにはアイコンを表示しません。
USB フラッシュドライブは、ドライブタイプがデバイス毎に特定されるので特殊です。ある種のものは固定ドライブに見え、別のある種のものはリムーバブルドライブに見えます。
除外するパス は TortoiseSVN に対して、それらのパスにはアイコンオーバーレイやステータス列を 表示しない ことを伝えるために使用します。これは、変更しないライブラリのみが含まれるためオーバーレイの必要ない巨大な作業コピーが存在する場合、もしくは TortoiseSVN に特定のフォルダーのみ見て欲しい場合に有用です。
ここで指定するパスはどれも再帰的に適用されることを想定しています。そのため、どの子階層フォルダーもオーバーレイ表示されません。名前のついたフォルダー のみ を除外したいなら、 ?
をパスの後ろに追加してください。
含めるパス にも同じことが言えます。オーバーレイが無効になるドライブタイプや、除外パスで指定したパスでも、オーバーレイされるようになります。
ユーザーは時々これら3つの設定がどのように作用するかを疑問に思うかもしれません。任意のパスに対して、一致するものが見つかるまでディレクトリ構造を上向きに探索し、含めるリストと除外するリストをチェックします。最初に一致するものが見つかった場合、含めるもしくは除外するルールに従います。もし競合した場合は、単一ディレクトリの設定は再帰的なものより優先されます。そして、含めるルールは除外するルールよりも優先されます。
分かりやすい例を示します。
除外するパス: C: C:\develop\? C:\develop\tsvn\obj C:\develop\tsvn\bin 含めるパス: C:\develop
このように設定すると、 C: ドライブのオーバーレイ表示は無効になりますが、 c:\develop
以下については、明確に除外されている c:\develop
フォルダー自身を除き、すべてのプロジェクトにオーバーレイ表示されます。頻繁に変更されるバイナリが入るフォルダーも除外されます。
TSVNCache.exe が検索するパスを制限することもできます。特定のフォルダー以下のみを検索したい場合は、全ドライブタイプを無効にし、検索対象にしたい特定のフォルダーのみを含めてください。
SUBST
ドライブを除外する作業コピーにアクセスするのに、以下のように SUBST
ドライブを使用すると便利なことがあります。
subst T: C:\TortoiseSVN\trunk\doc
しかし、 TSVNCache
はファイルが変更されたという通知をひとつしか受け取れず、それは通常割り当て元のパスに対してであるため、オーバーレイ表示を更新できません。そのため、 subst
パスのオーバーレイ表示はまったく更新されない可能性があります。
これに対処する簡単な方法は、表示対象から割り当て元のパスを除外することです。そうすれば、代わりに subst
パスにオーバーレイ表示されます。
時には、 TSVNCache による変更の検索・監視を減らすために、作業コピーを含む領域を除外することがありますが、フォルダーに作業コピーが含まれていることを視覚表示したい場合があります。 表示対象外にある作業フォルダーの最上位を通常として表示する チェックボックスをチェックすると、除外されたパス(チェックされていないドライブタイプや、除外するパスとして指定されたもの)にある作業コピーの最上位フォルダーには、通常の最新の状態である緑色のチェックマークが表示されます。フォルダーのオーバーレイ表示は正しくはないかもしれませんが、作業コピーは見つけやすくなるでしょう。ファイルには全くオーバーレイ表示されません。オーバーレイ表示がなくても、コンテキストメニューは有効であることにご注意ください。
この特殊な例外として、A:
ドライブと B:
ドライブは'通常' として除外フォルダーを表示する オプションのようには動作しません。これは、Windows がエクスプローラーの起動時に、PC にフロッピードライブがあっても、数秒の遅延が考えられるドライブを強制的に参照するからです。
オーバーレイアイコンを任意のものに変更できます。オーバーレイアイコンセットを変更したときに、変更を有効にするにはコンピューターの再起動が必要なことに注意してください。
リポジトリごとにプロキシの設定をする必要がある場合、 Subversion の servers
ファイルを直接編集する必要があります。直接編集する場合は ボタンを押してください。このファイルの使用法の詳細は、Runtime Configuration Area で説明しています。
TortoiseSVN が svn+ssh リポジトリと安全な接続を確立するのに使用するプログラムを指定できます。私たちは TortoisePlink.exe をお勧めします。これは TortoiseSVN に含まれている一般的な Plink プログラムです。ですがウィンドウなしアプリとしてコンパイルされているため、認証するたびに DOS ボックスがポップアップする、ということはありません。
実行ファイルのフルパスを指定しなければなりません。TortoisePlink.exe の場合、 TortoiseSVN の標準 bin ディレクトリにあります。その場所を指定するには
ボタンが役に立ちます。パスに空白が含まれる場合、以下のように引用符で囲んでください。"C:\Program Files\TortoiseSVN\bin\TortoisePlink.exe"
ウィンドウを持たないということの側面として、いずれのエラーメッセージも行き場がないということがあります。そのため、認証が失敗したときに 「標準出力に書き込めません」 といった簡単なメッセージしか得られません。このため、まず標準の Plink をセットアップすることをお勧めします。すべて動作すれば、TortoisePlink を全く同じパラメーターで使用できます。
TortoisePlink は、Plink の派生物のためドキュメントがありません。コマンドラインパラメーターは PuTTY のウェブサイト で参照してください。
パスワードを繰り返し入力しなくてもいいように、Pageant のようにパスワードキャッシュツールの使用も検討する必要があるでしょう。これも PuTTY のウェブサイトでダウンロードできます。
最終的に、サーバーとクライアントにSSHを設定するのは、このヘルプファイルの範疇を超えている重要なプロセスです。しかし、TortoiseSVN FAQ にリストされている Subversion/TortoiseSVN SSH How-To にガイドがあります。
ここでは、TortoiseSVN が使用する外部の差分・マージツールを定義できます。デフォルトでは TortoiseSVN と一緒にインストールされる TortoiseMerge が使われます。
TortoiseSVN の外部の差分・マージツールとしてよく使われているものの一覧は、 「外部差分・マージツール」 をご覧ください。
外部の差分ツールは、ファイルを異なるリビジョン間で比較するのに使用します。外部ツールは、それぞれのコマンドラインオプションに従って、コマンドラインからファイル名を取得する必要があります。TortoiseSVN は %
が先頭についた置換パラメーターを使用します。このパラメーターが現れると、適切な値に置換されます。パラメーターの順番はお使いの差分ツールに合わせてください。
変更前のファイル
変更前ファイルのウィンドウタイトル
引用符なしの変更前ファイルのウィンドウタイトル
変更後のファイル
変更後ファイルのウィンドウタイトル
引用符なしの変更後ファイルのウィンドウタイトル
元ファイルのURL(もしあれば)
引用符なしの元ファイルのURL(もしあれば)
2番目のファイルのURL(もしあれば)
引用符なしの第2ファイルのURL(もしあれば)
元ファイルのリビジョン(もしあれば)
引用符なしの元ファイルのリビジョン(もしあれば)
2番目のファイルのリビジョン(もしあれば)
引用符なしの第2ファイルのリビジョン(もしあれば)
ペグリビジョン(もしあれば)
引用符なしのペグリビジョン(もしあれば)
ファイルの名前です。もし同じファイルの2つの状態を比較するのではなく、2つの異なるファイルを比較する場合は、この文字列は空欄になります。
引用符なしのファイルの名前です。
ウィンドウタイトルは単なるファイル名ではありません。 TortoiseSVN は、それを表示名として扱うため、それにふさわしい名前を作成します。たとえば、あるファイルのリビジョン 123 と作業コピーの差分を表示する場合、それぞれの名前は filename : リビジョン 123
と
filename : 作業コピー
となります。
ExamDiff Pro の設定例:
C:\Path-To\ExamDiff.exe %base %mine --left_display_name:%bname --right_display_name:%yname
KDiff3 の設定例:
C:\Path-To\kdiff3.exe %base %mine --L1 %bname --L2 %yname
WinMerge の設定例:
C:\Path-To\WinMerge.exe -e -ub -dl %bname -dr %yname %base %mine
Araxis の設定例:
C:\Path-To\compare.exe /max /wait /title1:%bname /title2:%yname %base %mine
UltraCompare の設定例:
C:\Path-To\uc.exe %base %mine -title1 %bname -title2 %yname
DiffMerge の設定例:
C:\Path-To\DiffMerge.exe -nosplash -t1=%bname -t2=%yname %base %mine
キーワード、特にファイルの リビジョン 展開に svn:keywords
を使用する場合、キーワードの現在値によって、厳密には違いがでるかもしれません。また、svn:eol-style = native
を使用しているなら、BASE ファイルの行末は純粋に LF
になっているでしょうが、ローカルのファイルの行末は CR-LF
かもしれません。通常 TortoiseSVN は 差分操作の前に、BASE ファイルに対しキーワード展開や行末を分析して自動的にこの違いを隠蔽します。しかしこの操作は時間がかかる可能性があります。BASE に対する差分の時はファイルを変換する にチェックがなければ、TSVN はファイルに対する事前処理をスキップします。
Subversion のプロパティ用に別の差分ツールを指定することもできます。プロパティは短く簡単な文字列である傾向があるので、シンプルでもっとコンパクトなビューアーを使いたくなるかもしれません。
代替差分ツールを設定すると、コンテキストメニューから TortoiseMerge と サードパーティツールにアクセスできます。 → で優先差分ツールを使用し、Shift+ → で代替差分ツールを使用します。
ダイアログの最下部で、Unified差分ファイル(パッチファイル)のビューアーを設定することができます。パラメーターは必要ありません。デフォルトの設定では、 TortoiseSVN と一緒にインストールされる TortoiseUDiff を使用するよう設定され、追加・削除された行を色分け表示します。
Unified差分ファイルは単なるテキストファイルなので、任意のテキストエディターを使用しても結構です。
外部マージプログラムを競合したファイルの解決に使用します。パラメーターを差分プログラムと同様の方法で置換します。
誰も変更していないもとのファイル
変更前ファイルのウィンドウタイトル
引用符なしの変更前ファイルのウィンドウタイトル
自分の変更がある自分のファイル
変更後ファイルのウィンドウタイトル
引用符なしの変更後ファイルのウィンドウタイトル
リポジトリにあるファイル
リポジトリにあるファイルのウィンドウタイトル
引用符なしのリポジトリにあるファイルのウィンドウタイトル
マージ操作をした結果の競合ファイル
マージしたファイルのウィンドウタイトル
引用符なしのマージしたファイルのウィンドウタイトル
競合ファイルの名前
引用符なしの競合ファイルの名前
Perforce Merge の設定例:
C:\Path-To\P4Merge.exe %base %theirs %mine %merged
KDiff3 の設定例:
C:\Path-To\kdiff3.exe %base %mine %theirs -o %merged --L1 %bname --L2 %yname --L3 %tname
Araxis の設定例:
C:\Path-To\compare.exe /max /wait /3 /title1:%tname /title2:%bname /title3:%yname %theirs %base %mine %merged /a2
WinMerge (2.8 以降) の設定例:
C:\Path-To\WinMerge.exe %merged
DiffMerge の設定例:
C:\Path-To\DiffMerge.exe -caption=%mname -result=%merged -merge -nosplash -t1=%yname -t2=%bname -t3=%tname %mine %base %theirs
高度な設定では、ファイルの拡張子ごとに異なる差分・マージプログラムを定義できます。たとえば、.jpg
ファイルの 「差分」 を取るのに Photoshop を関連付けできます。:-) svn:mime-type
で差分・マージプログラムと関連付けることもできます。
拡張子を関連付けるには、拡張子を指定する必要があります。Windows ビットマップファイルを指定するには、.BMP
としてください。svn:mime-type
プロパティを使用して関連付けるには、text/xml
のようにスラッシュを含めて mime type を指定してください。
便宜上、TortoiseSVN はたくさんの設定を保存し、最近の情報を記憶しています。データのキャッシュを削除する場合、ここで行います。
作業コピーのチェックアウトや、変更点のマージ、リポジトリブラウザーの使用の際は常に、TortoiseSVN は直近に使用した URL を記録し、コンボボックスに提供します。時には URL がもう存在しなくなり、リストが散らかりますので、定期的に掃除するのに便利です。
コンボボックスに表示されている 1 項目だけを、その場で削除したい場合、下矢印をクリックしてコンボボックスを開き、削除したい項目にマウスをあわせて、Shift+Del を押してください。
TortoiseSVN は最近の入力したコミットログを保存しています。リポジトリごとに保存していますので、たくさんのリポジトリにアクセスする場合、極度に肥大化してしまうことがあります。
TortoiseSVN は、次回ログを参照した際の時間節約のため、ログ参照ダイアログが取得したログメッセージをキャッシュしています。メッセージがキャッシュされている状態で、他の誰かがログメッセージを編集した場合、キャッシュを消去しないとその変更を参照できません。ログメッセージのキャッシュは ログキャッシュ タブで有効にできます。
多くのダイアログは、前回使用したときのサイズと画面内の位置を記憶しています。
Subversion サーバーの認証を通れば、ユーザー名とパスワードを毎回入力しなくてもいいように、ローカルにキャッシュしています。セキュリティ上の理由や、リポジトリに別のユーザー名でアクセスするのに消去したいかもしれません……ジョンはPCがあなたに使われているのを知っていますか?
もし、特定の1つのサーバーについて認証データをクリアしたい場合は、
ではなく ボタンを使用してください。TortoiseSVN は、進行ダイアログに書き込まれたすべてのログを保持しています。これは例えば、最近の更新コマンドで何が起きたのかをチェックしたいときに便利です。
ログファイルは長さを制限しており、大きくなりすぎたときには古い内容から破棄していきます。デフォルトでは 4000 行保持しますが、この数字はカスタマイズできます。
ここからログファイルの内容の確認や消去ができます。
このダイアログでは、TortoiseSVNのログキャッシュ機能の設定ができます。これはログメッセージと変更したパスのローカルコピーを保持し、サーバーからダウンロードの時間消費を防ぎます。ログキャッシュを使用すると、ログダイアログやリビジョングラフが劇的に速くなります。その他にも、オフライン時にもログメッセージを参照できるといった便利な特徴もあります。
ログデータが必要な時は常にログのキャッシュを有効にします。チェックすると、キャッシュが有効ならキャッシュからデータを取得します。キャッシュにメッセージがなければ、サーバーから取得しキャッシュに追加します。
キャッシュを無効にすると、データを常にサーバーから直接取得し、ローカルに保存しません。
Occasionally you may have to connect to a server which uses the same URL for all repositories. Older versions of svnbridge
would do this. If you need to access such repositories you will have to check this option. If you don't, unchecked it to improve performance.
Some hosting services give all their repositories the same UUID. You may even have done this yourself by copying a repository folder to create a new one. For all sorts of reasons this is a bad idea - a UUID should be unique. However, the log cache will still work in this situation if you check this box. If you don't need it, unchecked it to improve performance.
オフラインで作業していたり、リポジトリサーバーがダウンしていたりした場合でも、ログキャッシュを使用して、すでにキャッシュに保持したログメッセージを提供できます。もちろんキャッシュは最新の状態ではありませんから、この機能を使用するかどうかの選択肢があります。
サーバーに接続せず、キャッシュからログデータを取得する際、ダイアログはオフライン状態であることをタイトルバーに表示します。
ログダイアログを表示する際、通常、新しいログメッセージをチェックするのにサーバーに接続すると思います。ここでタイムアウトに0以外を指定したばあい、前回の接続からその秒数経過しているときだけ、サーバーに接続します。頻繁にログダイアログを開き、サーバーが遅い場合、これによりサーバーとのやりとりを抑えることができますが、表示されるデータが完全に最新であるとは限りません。この機能を使用する場合は、折衷案として300(5分)とするのをお勧めします。
たくさんのリポジトリをブラウズすると、たくさんのログキャッシュを蓄積することになります。そのリポジトリを頻繁に使用しなければ、キャッシュが大きくふくらむことはありません。そのため、TortoiseSVN はデフォルトで、ここにセットした時間後にキャッシュを削除します。キャッシュの削除を制御するのに、この項目を使用してください。
大きなキャッシュの再取得は、より負荷が高くなります。そのため、TortoiseSVN は小さなキャッシュしか削除しません。この値で、適切な閾値を調節してください。
時折、キャッシュに何か障害が発生し、それが元で異常終了することがあります。これが発生すると、問題の再発防止のため、通常自動的にキャッシュを削除します。ナイトリービルドのような不安定さの残るバージョンを使用する場合などで、キャッシュを保持するために指定することができます。
このページでは、ローカルにキャッシュしたリポジトリの一覧を、キャッシュに使用した領域とともに参照できます。リポジトリを選択すると、その下のボタンを使用できます。
をクリックすると、キャッシュを完全に再読込し、抜けたところを補完します。大きなリポジトリでは、非常に時間がかかりますが、オフラインで作業し、もっともよい状態のキャッシュが必要な場合に便利です。
ボタンをクリックすると、キャッシュ全体を CSV ファイルでエクスポートします。ログデータを外部プログラムで処理をする際に便利ですが、主に開発者用でしょう。
をクリックすると、選択したリポジトリのキャッシュデータをすべて削除します。これはそのリポジトリのキャッシュを無効にするものではなく、次回ログデータが必要になると、新しいキャッシュを作成します。
ボタンをクリックすると、特定のキャッシュの詳細統計を表示します。ここではたくさんの項目が表示され、これは主に TortoiseSVN の開発者が興味を引く項目です。そのため、すべてを詳細に説明することはしません。
このキャッシュを提供するのに必要なメモリ量です。
キャッシュに使用するディスクスペースです。データは圧縮されますので、ディスクの使用量は、一般的にかなり控えめになります。
リポジトリが有効なキャッシュを、前回使用したかどうかを表示します。
最後にキャッシュの内容を更新した日時です。
サーバーから HEAD リビジョンを最後に取得した日時です。
キャッシュに記録したメッセージの作者数です。
svn log -v
で見られるリストにある、パスの数です。
取得していないリビジョン範囲の数で、単純にリクエストしていないものです。キャッシュ内のホール数の尺度になります。
キャッシュに格納されている、リビジョン番号の最大値です。
キャッシュに格納されているリビジョン番号の数です。キャッシュの完全性に関する別の尺度になります。
このダイアログでは、Subversion のアクションに合わせて自動的に実行される、フックスクリプトのセットアップを行えます。対照的に 「サーバー側フックスクリプト」 で説明しているフックスクリプトは、クライアントのローカルで実行されます。
ここで言うフックは、コミット後にバージョン番号を更新するため SubWCRev.exe
のようなプログラムを起動したり、再構築のトリガになったりします。
なお、フックスクリプトは作業コピーの特殊なプロパティで指定することもできます。詳しくは、「TortoiseSVN のプロジェクトプロパティ」を参照してください。
新しいフックスクリプトを追加するには、単に をクリックし、詳細を入力してください。
現在、次の種類のフックスクリプトが使用できます。
コミットダイアログを表示する前に呼ばれます。フックがバージョン管理下のファイルを変更したり、コミットするファイルのリストやコミットメッセージに影響を与える場合に使用してください。しかし、初期の段階でフックが呼ばれるため、コミット用に選択したオブジェクトの全リストは有効でないことに注意するべきです。
これが指定されると、コミットダイアログに
ボタンが表示され、クリックすると定義されたフックスクリプトが実行されるようになります。フックスクリプトはチェックされたファイルやフォルダーすべての一覧と、入力されていればコミットメッセージを受け取ります。コミットダイアログでユーザーが
をクリックした後、コミットダイアログが閉じる前に呼ばれます。このフックはチェックされたすべてのファイルの一覧を受け取ります。フックがエラーを返すと、コミットダイアログは閉じません。改行で区切られたパスを含むエラーメッセージが返されると、エラーメッセージ表示後に表示されるコミットダイアログでこれらのパスが選択されます。
コミットダイアログの
をクリックした後、実際のコミットが始まる前に呼ばれます。このフックは実際にコミットするファイルのリストを持ちます。コミットが正常に完了した後で呼ばれます。
リビジョンへの更新ダイアログが表示される前に呼ばれます。
実際のSubversionの更新や切り替え操作が始まる前に呼び出されます。
更新、切り替え、チェックアウト、が終了した後に(成功したかどうかにかかわらず)呼び出されます。
リポジトリに接続を試みる前に呼び出されます。通常、およそ5分に1度の割合で呼び出されます。
ファイルをロックしようとする前に呼び出されます。
ファイルがロックされた後に呼び出されます。
フックは特定の作業コピーのパスに対して定義されます。最上位のパスのみ指定する必要があります。もし、サブフォルダーを操作する場合、TortoiseSVN は自動的に上位へマッチするかどうか検索を行います。
次に、実行するコマンドラインを、フックスクリプトや実行ファイルのパスから始めて指定する必要があります。ここではバッチファイルや実行可能ファイル、その他の Windows と関連付けられたファイル(例えば Perl スクリプト)を指定します。なお、Windows のセキュリティ上の制限で、Windows は UNC パスで指定されたスクリプトを実行しないため、この形式で指定することはできません。
コマンドラインには、TortoiseSVN が設定するパラメーターを含めます。呼ばれるフックによってパラメーターは異なります。各フックには以下の順番で渡されるパラメーターがあります。
PATH
MESSAGEFILE
CWD
PATH
MESSAGEFILE
CWD
PATH
MESSAGEFILE
CWD
PATH
DEPTH
MESSAGEFILE
CWD
PATH
DEPTH
MESSAGEFILE
REVISION
ERROR
CWD
PATH
CWD
PATH
DEPTH
REVISION
CWD
PATH
DEPTH
REVISION
ERROR
CWD
RESULTPATH
no parameters are passed to this script. You can pass a custom parameter by appending it to the script path.
PATH
LOCK
FORCE
MESSAGEFILE
CWD
PATH
LOCK
FORCE
MESSAGEFILE
ERROR
CWD
各パラメーターの意味は以下に説明する通りです。
A path to a temporary file which contains all the paths for which the operation was started in UTF-8 encoding. Each path is on a separate line in the temp file.
なお、操作がリモートで行われた場合(例えばリポジトリブラウザー内で)、それらのパスはローカルパスではなく、影響する項目のURLになります。
コミット・更新が完了した際の深さです。
以下のような有効な値があります。
svn_depth_unknown
svn_depth_exclude
svn_depth_empty
svn_depth_files
svn_depth_immediates
svn_depth_infinity
コミット用のログメッセージを格納しているファイルのパスです。このファイルには、UTF-8 エンコードのテキストが格納されています。start-commit フックの実行が完了すると、ログメッセージを読み返し、フックが変更する機会を与えます。
更新したりコミットが完了したときの、リポジトリのリビジョンです。
ロックするならtrue
、解除するならfalse
のどちらかです。
操作が強制的だったかどうかで、 true
または false
のどちらかです。
エラーメッセージを含むファイルのパスです。エラーがない場合、このファイルは空になります。
スクリプトを実行する現在の作業ディレクトリです。これはすべてに影響を与えるパスの、共通のルートディレクトリに設定されます。
A path to a temporary file which contains all the paths in UTF-8 encoding which were somehow touched by the operation. Each path is on a separate line in the temp file.
便宜上パラメーターに名前を付けましたが、フックの設定で、その名前を参照する必要はないことに注意してください。個々のフックに挙げたパラメーターはすべて、好むと好まざるとに関わらず常に渡されます ;-)
Subversion の操作を、フックスクリプトが完了するまで止めておきたい場合は、スクリプトが終了するまで待機 をチェックしてください。
Normally you will want to hide ugly DOS boxes when the script runs, so Hide the script while running is checked by default. Also you need to check this if your hook script might return an error that should stop the operation.
Theforce
flag can be set if the user must not proceed with the operation without running the script, i.e. the script must always run. If the force
flag is not checked, then the user is shown a button to retry the operation without running the hook script. クライアントフックスクリプトのサンプルは、 TortoiseSVN リポジトリ サイトの contrib
フォルダーから入手できます(リポジトリへのアクセス方法は、 「ライセンス」 をご覧ください。)
フックスクリプトをデバッグするとき、DOSコンソールに実行中の行を表示したり、スクリプトが実行完了したときにウィンドウが閉じるのを防ぐためにpauseを挿入したりしたくなったりすることがあるでしょう。入出力がリダイレクトされているため、これは正しく動作しません。しかし、入出力を明示的にCONにリダイレクトすることはできます。例えば、
echo Checking Status > con pause < con > con
TortoiseSVN のインストールディレクトリに、 ConnectVPN.exe
という小さいツールが含まれています。このツールを pre-connect フックとして使用すると、 TortoiseSVN がリポジトリにアクセスしようとする前に、自動的に VPN に接続できるようになります。ツールの最初の引数として、 VPN 接続の名前を渡すようにしてください。
TortoiseSVN は、コミットダイアログで課題管理システムにクエリを発行するために、COM プラグインを使用できます。そのようなプラグインの使用を、 「課題追跡システムからの情報取得」 で説明しています。システム管理者が、すでにインストールして登録したプラグインを提供している場合、どのように作業コピーと統合するかをここで指定します。
特定の作業コピーでプラグインを使用するには、 をクリックしてください。ここで作業コピーのパス、登録済み課題管理システムプラグインのドロップダウンリストでの選択、渡す任意のパラメーターの指定ができます。パラメーターはプラグインに固有ですが、自分に割り当てられた課題をプラグインが抽出できるように、課題管理システムのユーザー名を含めるかも知れません。
プロジェクトのすべてのユーザーで同じ COM プラグインを使用する場合は、bugtraq:provideruuid
、bugtraq:provideruuid64
、bugtraq:providerparams
をプロパティとして設定することができます。
IBugtraqProvider の COM UUID (例えば、{91974081-2DC7-4FB1-B3BE-0DE1C8D6CE4E}
)を指定します。(この例は Google Code の課題管理システム向けプロバイダーである Gurtle bugtraq provider の UUID です)。
これは bugtraq:provideruuid
と同様ですが、64ビット版の IBugtraqProvider です。
このプロパティは、IBugtraqProvider に渡すパラメーターを指定します。
2つのプロパティに何を設定するか調べるには、 IBugtraqProvider プラグインのドキュメントを参照してください。
TortoiseBlame で使用する設定は、TortoiseBlame 自体ではなく、メインのコンテキストメニューから設定します。
TortoiseBlame では、ファイルにある行の古さを背景色で表現します。ここでは、最新と最古の両端のリビジョンの色を指定します。 TortoiseBlame はこの 2 色の中間色を使用して、行単位のリポジトリのリビジョンを表現します。
表示位置調整バーで使用する差分の色を指定することができます。デフォルトでは、メインウィンドウで文字を読みやすいよう背景の明るさを維持しながら、表示位置調整バーと強いコントラストをなす色が使われています。
ここでは、テキストを表示するフォントとポイントサイズを指定できます。ここで指定されたフォントは、ファイルの内容と、左画面に表示する作者とリビジョンの両方に使用されます。
ファイルの内容にタブ文字があった場合、空白を何文字使用して展開するかを定義します。
TortoiseUDiffで使用する設定は、TortoiseUdiff自体ではなく、メインのコンテキストメニューから設定します。
TortoiseUDiffのデフォルト色はふつう良いのですが、ここで設定することができます。
画面に表示される文字列のフォントや大きさ(ポイント単位)を選択できます。
差分の内容にタブ文字があった場合、空白を何文字使用して展開するかを定義します。
You can sync all TortoiseSVN settings to and from an encrypted file. The file is encrypted with the password you enter so you don't have to worry if you store that file on a cloud folder like OneDrive, GDrive, DropBox, ...
パスとパスワードが設定されると、TortoiseSVNは自動的にすべての設定を同期し、その後も同期し続けます。
すべての設定を手動で暗号化ファイルにエクスポートしたり、暗号化ファイルからインポートしたりすることもできます。その場合、パスと設定ファイルの暗号化処理のためのパスワードを尋ねられます。
設定を手動でエクスポートするとき、通常のエクスポートや同期では含まれないすべてのローカル設定を含めることもできます。ローカル設定はローカルパスを含みますが、これはふつうコンピューター間で異なります。ローカル設定は差分・マージツールの設定やフックスクリプトを含みます。
使用頻度の低い一部の設定は、設定ダイアログの高度な設定ページでのみ設定できます。これらの設定はレジストリを直接操作するので、それぞれの設定が何をするのかを理解しておく必要があります。これらの変更がどうしても必要な場合を除いて、これらの設定を変更しないでください。
同じコンピューター上で、複数のユーザーが同じアカウントを使用していることがあります。このような場合、認証データを保存すべきでないことがあります。この値を false
にせ底すると、認証ダイアログの認証を保存
ボタンを無効にすることができます。
アップデートによって、すでにローカルの作業コピーに同じ名前が存在する新しいファイルを取得したとき、デフォルトの動作はローカルファイルを保持し、リポジトリからの新しいファイルは(可能ならば)変更後のバージョンとして表示します。 false
に設定すると、 TortoiseSVN がこれを競合として扱うようになります。
エクスプローラーでは Shift キーを押しながらコンテキストメニューを開くと、 TortoiseSVN の追加コマンドが表示されます。常に追加コマンドを表示させたい場合は、 true
に設定してください。
エディターが自動補完のポップアップを表示する最小文字数です。既定値は3
です。
コミットメッセージのエディターでは、コミットするファイルが自動保管リストで表示されます。 true
に設定すると、拡張子を除外した名前を表示するようになります。
特定のペグリビジョンに関連付けられたを外部ファイルは、デフォルトではコミット時に選択できないようになっています。これは、後に更新するときに、外部ファイルのペグリビジョンが修正されていないと変更が元に戻ってしまわないようにするためです。
それでもこの様な外部ファイルの変更をコミットしたいのであれば、この値を false
に設定してください。
TortoiseSVN の他のコマンド(例えば更新、コミット、など)が動作している間、エクスプローラーのステータスオーバーレイを更新したくない場合は、この値を true
に設定してください。
TSVNCache にトレイアイコンのキャッシュを追加するには、この値を true
に設定してください。これはプログラムを正規に終了させるために必要なもので、開発者にのみ有用な設定です。
作業コピーを Windows エクスプローラーの詳細表示で表示させたとき、TortoiseSVNが列を追加します。作業コピーばかりでなくどこでも列を追加したい場合、この値を true
に設定してください。なお、列の追加はWindows XPでしか行われず、Vista以降ではこの機能はサポートされていません。
ただし、サードパーティー製のエクスプローラーによっては、WindowsのバージョンがXP以降であってもサポートされることがあります。
Subversion の設定ファイルを別な場所に設定することができます。これはすべての TortoiseSVN の操作に影響します。
TortoiseSVN の多くのダイアログでは、 Ctrl+Enter を押すことで OK ボタンを押したときと同様にダイアログを閉じることができます。 この値をfalse
に設定すると、この機能は無効になります。
true
に設定すると、 TortoiseProc.exe を使用して開始されるたびにあらゆるコマンドについて、ポップアップダイアログでコマンドラインの内容を表示できます。
TortoiseSVN が実行中にデバッグメッセージを表示させたい場合は、これをtrue
に設定してください。メッセージは、特殊なデバッグツールのみでキャプチャすることができます。
ダイアログタイトルのデフォルトの書式(0に設定時)は、URL/パス - ダイアログ名 - TortoiseSVN
です。この値を1に設定すると、書式が ダイアログ名 - URL/パス - TortoiseSVN
になります。
TortoiseSVN は外部の差分ビューアーを使用することができます。しかし、多くのビューアーには注釈履歴 (「注釈履歴の差分」)が統合されていませんので、その場合はTortoiseMerge に戻したくなることもあるでしょう。そのためには、この値をtrue
に設定してください。
この値はダイアログが境界にくっつく際の接近距離をピクセル数で指定します。既定値は3です。この値を無効にするには、0に設定してください。
アプリケーションによっては、必要でもないのに勝手に、通知なしでファイル名の大文字/小文字を変えてしまうものがあります。例えば、 file.txt
が FILE.TXT
に変わっても、 Windows アプリケーションでは困りませんが、 Subversion ではこのような場合にも大文字/小文字を区別してしまいます。そのため、 TortoiseSVN ではこのような大文字/小文字の変更を自動的に修正します。
もし、 TortoiseSVN が自動的に大文字/小文字の修正を行ってほしくない場合、この値を false
に設定してください。
様々なダイアログ(例えばコミット、変更をチェック、追加、変更の取り消し、など)のリストコントロールを、全行選択(つまり、項目を選択する際に、最初のカラムではなく行全体を選択すること)にします。これは使いやすいのですが、行全体が反転するため、右下の背景画像に重なると醜くなってしまうことがあります。全行選択を解除する場合は、この値を false
に設定してください。
このオプションは、様々なTortoiseSVNのダイアログやウィンドウが、Windows 7のタスクバー内でグループ化される方法を決定します。このオプションは、Vistaでは効果がありません。
既定値は0です。この設定では、アイコンがアプリケーションの種類によってグループ化されます。TortoiseSVNのすべてのダイアログがひとつにグループ化され、TortoiseMergeのすべてのウィンドウがひとつにグループ化される・・・という形です。
1に設定すると、すべてのダイアログがアプリケーション単位ではなく、リポジトリ単位でグループ化されます。たとえば、リポジトリA
のログダイアログとコミットダイアログが開いていて、リポジトリB
の変更のチェックダイアログとログダイアログが開いていた場合、Windows 7のタスクバーには2つのアプリケーションアイコングループが表示され、それぞれリポジトリごとにグループ化されます。但し、TortoiseMergeのウィンドウは、TortoiseSVNのダイアログと同じグループにはなりません。
2に設定すると、1に設定した場合と同様にグループ化されますが、 TortoiseSVN、 TortoiseMerge、 TortoiseBlame、 TortoiseIDiff、 TortoiseUDiff のウィンドウも一緒にグループ化されます。たとえば、コミットダイアログが開いているときに変更されたファイルをダブルクリックした場合、 TortoiseMerge の差分ウィンドウが開きますが、タスクバー上ではコミットダイアログと同じアイコングループに含められます。
3に設定すると、1に設定した場合と同様にグループ化されますが、リポジトリごとではなく作業コピーごとにグループ化されます。これは、同じリポジトリですべてのプロジェクトを管理し、プロジェクトごとに異なる作業コピーを使用している場合に便利です。
4に設定すると、2に設定した場合と同様にグループ化されますが、リポジトリごとではなく作業コピーごとにグループ化されます。
GroupTaskbarIconsPerRepo
オプションを0に設定した場合は、効果がありません(上記参照)。
このオプションを true
に設定すると、 Windows 7 のタスクバーにはダイアログやウィンドウで使用されているリポジトリを識別するための、色のついた四角の小さいオーバーレイが表示されます。
false
に設定すると、すべてのsvn:externals
がアップデート中に個別に表示されます。
true
に設定した場合(デフォルト)、外部参照の更新情報が更新の影響を受けたかどうかのみ(何かが変更された等)が表示されます。通常のファイルやフォルダーの情報は表示されません。
If this is set to true
, then cancelling the dialog to approve a hook script to run will show an error dialog indicating the user cancelled.
デフォルトでは、 TortoiseSVN は常に外部参照を含めて更新を行います。これは作業コピーの一貫性の問題を回避することができます。しかし、外部参照のセットが多い場合、更新に時間がかかるようになります。この値をfalse
に設定すると、デフォルトでは外部参照を含めずに更新されるようになります。外部参照を含めて更新するには、特定リビジョンへ更新...
を実行するか、この値を再びtrue
に設定します。
ログダイアログがマージウィザードから起動されると、すでにマージされたリビジョンは灰色で表示されますが、ブランチが作成された後のリビジョンも表示されます。それらをマージすることができないため、これらのリビジョンは黒で示されています。
このオプションを true
に設定すると、 TortoiseSVN はブランチが作成されたリビジョンを、そのリビジョン以降の隠されたリビジョンからも検索しようとします。これには時間がかかるので、このオプションはデフォルトで無効になっています。このオプションは、 SVN サーバーによっては動作しないことがあります(例えば、Google Code Hosting の issue #5471 を参照)。
ログダイアログで複数のリビジョンが選択された時のログメッセージの書式文字列です。
書式文字列では、次のプレースホルダーを利用できます。
ログダイアログでは、作業コピーのリビジョンを太字で表示します。しかし、ログダイアログがパスの状態を確認する必要があります。そのため、非常に大きい作業コピーでは時間がかかります。この値を false
に設定すると、この機能を無効にすることができます。
Comboboxes for URLs and paths show a history of previously used URLs/paths if possible. This settings controls how many previous items are saved and shown. The default is 25 items.
別のブランチからのリビジョンをマージし、マージ追跡情報が使用可能になると、マージされたリビジョンのログメッセージは、コミット時のログメッセージを構成するために収集されます。各リビジョンの個々のログメッセージは、あらかじめ定義された区切り文字列で区切られます。必要に応じて、任意の区切り文字列を指定してください。
ここに指定された数よりも多くの項目の差分を表示しようとした場合、警告ダイアログが最小に表示されます。既定値は10です。
TortoiseSVN は週に一度、新しいバージョンが出ているかどうかをチェックします。新しいバージョンが見つかると、コミットダイアログにリンクコントロールが表示されます。 true
に設定すると、以前のようにアップデートを通知ダイアログで行うようになります。
リポジトリブラウザーは、すべてのリポジトリの一覧を取得するために、SVNサーバーがSVNParentPathディレクティブの指定に従って作成するウェブページにアクセスを試みます。この動作を無効にするには、この値をfalse
に設定して下さい。
This option enables the bidirectional mode for the commit message edit box. If enabled, right-to-left language text editing is done properly. Since this feature is expensive, it is disabled by default. You can enable this by setting this value to true
.
このオプションは、コミットダイアログやunified差分ビューアーなどで使用されているScintillaコントロールで、Direct2Dによるアクセラレーション描画を有効にします。一部のグラフィックカードでは、文字を入力するカーソルが表示されっぱなしになるなどの不具合が発生します。このような場合、この値をfalse
にすることでこの機能を無効にしてください。
This parameter specifies how TortoiseSVN behaves if a commit fails due to an out-of-date error:
The user is asked whether to update the working copy or not, and the commit dialog is not reopened after the update.
This is the default. The user is asked whether to update the working copy or not, and the commit dialog is reopened after the update so the user can proceed with the commit right away.
Similar to 1
, but instead of updating only the paths selected for a commit, the update is done on the working copy root. This helps to avoid inconsistent working copies.
The user is not asked to update the working copy. The commit simply fails with the out-of-date error message.
If set to true
, TortoiseSVN will play a system sound when an error or warning occurs, or another situation which is important and requires your attention. Set this to false
if you want to keep TortoiseSVN quiet. Note that the project monitor has its own setting for playing sounds, which you can configure in its settings dialog.
TortoiseSVN はエクスプローラーのコンテキストメニュー項目に設定されているアクセラレータを使用します(例えば SVN コミット
のアクセラレータは Alt+C ですが、エクスプローラーの コピー
項目と重複します)。 TortoiseSVN のエントリでアクセラレータを設定する必要がない場合は false
に設定してください。
これは Windows エクスプローラー以外のものを使用したり、コンテキストメニューが正しく表示できないといった問題が発生したりしたときに便利です。 false
に設定すると、シェルのコンテキストメニューに TortoiseSVN のアイコンが表示されなくなります。アイコンを表示する場合は、true
を設定してください。
false
に設定すると TortoiseSVN のダイアログで、コンテキストメニューのアイコンが表示されなくなります。.
Set this value to false
if you don't want the project monitor to show notification popups when new commits are detected.
コミットダイアログとログダイアログでは、コミットメッセージに装飾(例えばボールド、イタリックなど)を使います(詳しくは 「コミットログメッセージ」 を参照してください)。これを無効にしたい場合は false
に設定してください。
この値は、TortoiseSVN が有効なアップデートがあるかどうかを検査するためのテキストファイルをダウンロードする URL です。企業の管理者が通知するまでユーザーに TortoiseSVN をアップデートさせたくない場合などに有効です。
The standard edit controls do not stop on forward slashes like they're found in paths and urls. TortoiseSVN uses a custom word break procedure for the edit controls. If you don't want that and use the default instead, set this value to 0. If you only want the default for edit controls in combo boxes, set this value to 1.
TortoiseSVN は週に一回程度、使用可能な新しいバージョンがあるかどうかを確認します。 TortoiseSVN にこのチェックを行わせたくない場合は、この値を false
に設定してください。