Subversion keyword substitution

何謂 Subversion keyword substituion?

假如把 keyword substituion 功能打開，那麼當程式碼被 check in/commit 到 subversion server 的時候，檔案中的 $Id$ 標籤就會自動展開。也就是說，如果有這麼一行:

程式碼被 commit 之後，內容會變成類似這樣子的東西： 表示 calc.c 這個檔案的 Revision Number 是 148，上次更新日期是 July 28, 2002，修改人是 sally。

打開 keyword substituion：方法其一

• 在任一個資料夾上按右鍵，選 TortoiseSVN → Settings 打開 “TortoiseSVN Settings” 視窗：

• 按一下【Edit】按鈕編輯 Subversion configuration file：

• 把 enable-auto-props = yes 這行前面的 # 字註解符號拿掉，並且在 [auto-props] 區段中輸入底下這行:\

• 儲存並關閉設定檔，日後當你在新增或匯入(import)檔案時，keywords substitution 就會發揮功用，如下：

兩點注意事項

1. keywords substitution 只要設一次就好，TortoiseSVN 會對電腦上所有 Project 套用同樣的設定。
2. 上面的設定只有對「新增或匯入的檔案」才有效，對既有的檔案是無效的。如果要對既有的檔案設定 keywords substitution，請使用底下第二個方法。

打開 keyword substituion：方法其二

如果要對既有的檔案設定 keywords substitution，請照底下步驟做：

• 選取要套用 keywords substituion 的檔案(可一次選取多個檔案)，按右鍵選 TortoiseSVN → Properties：

• 按下【Add】鈕：

• 在 Property name ComboBox 下拉選單中選擇 svn:keywords，然後在 Property Value 輸入 Id：

• 最後按下【OK】鈕，然後將檔案 commit 上傳，既有的檔案就會套用 keywords substitution 了。

參考資料

• Version Control with Subversion - Keyword substitution