手冊

第 4 章. 每日使用指南

目錄

一般功能
圖示覆疊
關聯選單
拖放
常用快捷鍵
身分驗證
最大化視窗
將資料匯入儲存庫
匯入
就地匯入
特殊檔案
檢出工作副本
檢出深度
儲存原始副本
將您的變更提交至儲存庫
提交對話方塊
變更列表
僅提交檔案的部分內容
從提交列表中排除項目
提交記錄訊息
提交進度
使用來自其他人的變更更新您的工作副本
解決衝突
檔案衝突
屬性衝突
樹狀結構衝突
取得狀態資訊
圖示覆疊
詳細狀態
本機和遠端狀態
檢視差異
變更列表
暫存
修訂記錄對話方塊
呼叫修訂記錄對話方塊
修訂記錄動作
取得其他資訊
取得更多記錄訊息
目前工作副本修訂版
合併追蹤功能
變更記錄訊息和作者
篩選記錄訊息
統計資訊
離線模式
重新整理檢視
檢視差異
檔案差異
行尾和空白字元選項
比較資料夾
使用 TortoiseIDiff 比較圖片差異
比較 Office 文件差異
外部差異/合併工具
新增檔案和目錄
複製/移動/重新命名檔案和資料夾
忽略檔案和目錄
忽略列表中的樣式比對
刪除、移動和重新命名
刪除檔案和資料夾
移動檔案和資料夾
處理檔案名稱大小寫衝突
修復檔案重新命名
刪除未版本化的檔案
還原變更
清理
專案設定
Subversion 屬性
TortoiseSVN 專案屬性
屬性編輯器
外部項目
外部資料夾
外部檔案
透過拖放建立外部項目
分支 / 標籤
建立分支或標籤
建立分支或標籤的其他方式
要檢出還是要切換...
合併
合併修訂版範圍
合併兩個不同的樹狀結構
合併選項
檢閱合併結果
合併追蹤
處理合併後的衝突
功能分支維護
鎖定
Subversion 中的鎖定運作方式
取得鎖定
釋放鎖定
檢查鎖定狀態
將未鎖定的檔案設為唯讀
鎖定 Hook 腳本
建立和套用修補程式
建立修補程式檔案
套用修補程式檔案
誰變更了哪一行?
檔案的 Blame
Blame 差異
儲存庫瀏覽器
修訂版圖表
修訂版圖表節點
變更檢視
使用圖表
重新整理檢視
修剪樹狀結構
匯出 Subversion 工作副本
從版本控制中移除工作副本
重新定位工作副本
與錯誤追蹤系統 / Issue Tracker 整合
將 Issue 號碼新增至記錄訊息
從 Issue Tracker 取得資訊
與基於 Web 的儲存庫檢視器整合
TortoiseSVN 的設定
一般設定
修訂版圖表設定
圖示覆疊設定
網路設定
外部程式設定
已儲存資料設定
記錄快取
用戶端 Hook 腳本
TortoiseBlame 設定
TortoiseUDiff 設定
匯出 TSVN 設定
進階設定
最後步驟

本文檔描述了 TortoiseSVN 用戶端的日常使用方法。它不是版本控制系統的介紹,也不是Subversion (SVN) 的介紹。它更像是一個當您約略知道自己想做什麼,但不完全記得該怎麼做時可以參考的地方。

如果您需要 Subversion 版本控制的介紹,那麼我們建議您閱讀這本很棒的書:《 Version Control with Subversion 》。

本文檔也正在編寫中,就像 TortoiseSVN 和 Subversion 一樣。如果您發現任何錯誤,請將其報告給郵件列表,以便我們可以更新文件。每日使用指南 (DUG) 中的某些螢幕截圖可能無法反映軟體的目前狀態。請原諒我們。我們在空閒時間開發 TortoiseSVN。

為了充分利用每日使用指南

  • 您應該已經安裝了 TortoiseSVN。

  • 您應該熟悉版本控制系統。

  • 您應該了解 Subversion 的基礎知識。

  • 您應該已經設定了伺服器和/或有權存取 Subversion 儲存庫。

一般功能

本節描述 TortoiseSVN 的一些功能,這些功能幾乎適用於手冊中的所有內容。請注意,許多這些功能僅會在 Subversion 工作副本中顯示。

圖示覆疊

圖 4.1. 顯示圖示覆疊的檔案總管

Explorer showing icon overlays


TortoiseSVN 最明顯的功能之一是出現在您工作副本中檔案上的圖示覆疊。這些圖示讓您一目了然地看到哪些檔案已被修改。請參閱名為「圖示覆疊」的章節,以了解不同覆疊所代表的意義。

關聯選單

圖 4.2. 版本控制下目錄的關聯選單

Context menu for a directory under version control


所有 TortoiseSVN 命令都是從 Windows 檔案總管的關聯選單中調用的。當您按一下滑鼠右鍵檔案或資料夾時,大多數命令都是直接可見的。可用的命令取決於檔案或資料夾或其父資料夾是否在版本控制之下。您也可以在檔案總管檔案選單中看到 TortoiseSVN 選單。

提示

一些很少使用的命令僅在擴充關聯選單中可用。若要顯示擴充關聯選單,請在按一下滑鼠右鍵時按住 Shift 鍵。

在某些情況下,您可能會看到多個 TortoiseSVN 項目。這不是錯誤!

圖 4.3. 版本控制資料夾中捷徑的檔案總管檔案選單

Explorer file menu for a shortcut in a versioned folder


此範例適用於版本控制資料夾中未版本化的捷徑,並且在檔案總管檔案選單中,TortoiseSVN 有三個項目。一個用於資料夾,一個用於捷徑本身,第三個用於捷徑指向的物件。為了幫助您區分它們,圖示在右下角有一個指示器,顯示選單項目是適用於檔案、資料夾、捷徑還是多個選取的項目。

拖放

圖 4.4. 版本控制下目錄的滑鼠右鍵拖曳選單

Right drag menu for a directory under version control


當您滑鼠右鍵拖曳檔案或資料夾到工作副本內的新位置,或當您滑鼠右鍵拖曳未版本化的檔案或資料夾到版本控制下的目錄時,其他命令可用作拖曳處理常式。

常用快捷鍵

一些常用操作具有眾所周知的 Windows 快捷鍵,但不會出現在按鈕或選單中。如果您無法弄清楚如何執行某些顯而易見的操作,例如重新整理檢視,請在此處查看。

F1

說明,當然。

F5

重新整理目前的檢視。這可能是最有用的單鍵命令。例如...在檔案總管中,這將重新整理您工作副本上的圖示覆疊。在提交對話方塊中,它將重新掃描工作副本以查看可能需要提交的內容。在修訂記錄對話方塊中,它將再次聯繫儲存庫以檢查是否有更新的變更。

Ctrl-A

全選。如果您收到錯誤訊息並想要複製並貼到電子郵件中,可以使用此選項。使用 Ctrl-A 選取錯誤訊息,然後...

Ctrl-C

複製選取的文字。如果未選取任何文字,但例如列表項目或訊息方塊,則該列表項目或訊息方塊的內容會複製到剪貼簿。

身分驗證

如果您嘗試存取的儲存庫受密碼保護,則會顯示身分驗證對話方塊。

圖 4.5. 身分驗證對話方塊

Authentication Dialog


輸入您的使用者名稱和密碼。核取方塊將使 TortoiseSVN 將憑證儲存在 Subversion 的預設目錄中:%APPDATA%\Subversion\auth,位於三個子目錄中

  • svn.simple 包含基本身分驗證 (使用者名稱/密碼) 的憑證。請注意,密碼是使用 WinCrypt API 儲存的,而不是以純文字形式儲存。

  • svn.ssl.server 包含 SSL 伺服器憑證。

  • svn.username 包含僅限使用者名稱身分驗證 (不需要密碼) 的憑證。

如果您想要清除身分驗證快取,您可以從 TortoiseSVN 設定對話方塊的已儲存資料頁面執行此操作。全部清除按鈕將清除所有儲存庫的快取身分驗證資料。清除...按鈕將顯示一個對話方塊,您可以在其中選擇應刪除哪些快取的身分驗證資料。請參閱名為「已儲存資料設定」的章節

有些人希望在登出 Windows 或關機時刪除身分驗證資料。執行此操作的方法是使用關機腳本刪除 %APPDATA%\Subversion\auth 目錄,例如

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"
      

您可以像這樣在 Windows 上安裝此類腳本

  1. 執行 gpedit.msc (本機原則)

  2. 使用者設定 -> Windows 設定 -> 腳本 -> 登入或登出 -> 屬性 -> 新增

有關如何設定伺服器以進行身分驗證和存取控制的更多資訊,請參閱名為「存取儲存庫」的章節

最大化視窗

TortoiseSVN 的許多對話方塊都有大量資訊要顯示,但通常僅最大化高度或僅最大化寬度,而不是最大化以填滿螢幕會很有用。為了方便起見,最大化按鈕上有快捷方式。使用滑鼠中鍵垂直最大化,使用滑鼠右鍵水平最大化。

TortoiseSVN 首頁