Subversion は、ファイル自身にファイル名やリビジョン情報を埋め込む CVS 風キーワード展開をサポートしています。現在キーワードは以下のものをサポートしています。

以上のキーワードの使用法については、Subversion book の svn:keywords section で、キーワードの説明とその有効化・利用法の説明をしています。 (訳注 日本語では http://subversion.bluegate.org/doc/book.html で読めます)

図 5.32. 属性の追加

新しい属性をセットするには、まず 追加... をクリックしてください。必要な属性名をコンボボックスから選択・入力し、下のテキストボックスに値を入力してください。無視リストのような複数の値を持つ属性は、複数行で入力してください。OK をクリックして、この属性をリストに追加してください。

一度にたくさんの項目に対して属性を設定する場合は、エクスプローラでファイル/フォルダを選択し、コンテキストメニュー → 属性 を選択してください。

現在のフォルダ以下にある すべての ファイルやフォルダに対して属性を適用する場合、再帰 チェックボックスをチェックしてください。

svn:needs-lock のようないくつかの属性は、ファイルにしか適用できず、フォルダのドロップダウンリストには属性名が表示されません。その階層内すべてのファイルにそういった属性を適用できますが、属性名は自分で入力しなければなりません。

既存の属性を編集する場合、属性の一覧から編集する属性を選択し、編集... をクリックしてください。

既存の属性を削除したい場合、属性の一覧から削除する属性を選択し、削除 をクリックしてください。

svn:externals 属性は、同じリポジトリからでも完全に異なるリポジトリからでも他のプロジェクトを取得するのに使用できます。詳細は 参照プロジェクト項 をご覧ください。

しばしば、何度も同じ属性のセット (例: bugtraq:logregex) を適用していることに気付くでしょう。あるプロジェクトから別のプロジェクトへ、属性を簡単にコピーするのに、エクスポート・インポート機能を利用できます。

すでに属性をセットしているファイル・フォルダで、TortoiseSVN → 属性 を使用し、エクスポートしたい属性を選択して エクスポート... をクリックしてください。属性の名前と値を保存するファイル名を入力することになります。

属性を適用したいフォルダで、TortoiseSVN → 属性 とし、インポート... をクリックしてください。インポートするファイルを指定することになりますので、先ほど保存したエクスポートファイルを指定してください。属性をそのフォルダに、再帰的ではなく追加します。

属性をツリーに対し再帰的に追加する場合、前述の手順の後、属性ダイアログで属性を選び、編集... をクリックしてください。属性を再帰的に適用する チェックボックスをチェックの後、OK をクリックしてください。

インポートファイルはバイナリで TortoiseSVN 専用です。インポートやエクスポートでの属性の受け渡し専用で、このファイルを編集する必要はありません。

TortoiseSVN は、ファイルを使用することでバイナリの属性値を扱えます。バイナリ属性値を読むには、ファイルに 保存... してください。バイナリ値をセットするには、十六進エディタや他の適切なツールを利用して必要な内容を持つファイルを作成し、そのファイルから 開く... としてください。

バイナリ属性はあまり使用されませんが、いくつかのアプリケーションでは便利です。例えば、巨大な画像ファイルを格納している場合や、アプリケーションが読み込むファイルが巨大な場合、プレビューを素早く得るのに、属性にサムネイルを格納しておきたいでしょう。

You can configure Subversion and TortoiseSVN to set properties automatically on files and folders when they are added to the repository. There are two ways of doing this.

You can edit the subversion configuration file to enable this feature on your client. The General page of TortoiseSVN's settings dialog has an edit button to take you there directly. The config file is a simple text file which controls some of subversion's workings. You need to change two things: firstly in the section headed miscellany uncomment the line enable-auto-props = yes. Secondly you need to edit the section below to define which properties you want added to which file types. This method is a standard subversion feature and works with any subversion client. However it has to be defined on each client individually - there is no way to propagate these settings from the repository.

An alternative method is to set the tsvn:autoprops property on folders, as described in the next section. This method only works for TortoiseSVN clients, but it does get propagated to all working copies on update.

Whichever method you choose, you should note that auto-props are only applied to files at the time they are added to the repository. Auto-props will never change the properties of files which are already versioned.

If you want to be absolutely sure that new files have the correct properties applied, you should set up a repository pre-commit hook to reject commits where the required properties are not set.