圖 4.18. 修訂記錄對話方塊

您可以從幾個地方顯示「日誌」對話方塊

如果存放庫不可用，您將看到要離線嗎？對話方塊，如名為「離線模式」的章節中所述。

頂部窗格有一個動作欄，其中包含總結該修訂版本中已完成動作的圖示。有四個不同的圖示，每個圖示都顯示在其自己的欄中。

如果修訂版本修改了檔案或目錄，則已修改圖示會顯示在第一欄中。

如果修訂版本新增了檔案或目錄，則已新增圖示會顯示在第二欄中。

如果修訂版本刪除了檔案或目錄，則已刪除圖示會顯示在第三欄中。

如果修訂版本取代了檔案或目錄，則已取代圖示會顯示在第四欄中。

如果修訂版本移動或重新命名了檔案或目錄，則已移動圖示會顯示在第四欄中。

如果修訂版本透過移動/重新命名來取代檔案或目錄，則移動取代圖示會顯示在第四欄中。

如果修訂版本合併了檔案或目錄，則已合併圖示會顯示在第四欄中。

如果修訂版本反向合併了檔案或目錄，則反向合併圖示會顯示在第四欄中。

圖 4.19. 具有快捷選單的修訂記錄對話方塊頂部窗格

「日誌」對話方塊的頂部窗格具有快捷選單，可讓您存取更多資訊。其中一些選單項目僅在為檔案顯示日誌時才會出現，而有些僅在為資料夾顯示日誌時才會出現。

圖 4.20. Code Collaborator 設定對話方塊

圖 4.21. 針對 2 個選取的修訂版本的頂部窗格快捷選單

如果您一次選取兩個修訂版本（使用常用的 Ctrl 修飾鍵），快捷選單會變更並為您提供較少的選項

如果您選取兩個或多個修訂版本（使用常用的 Ctrl 或 Shift 修飾鍵），則快捷選單將包含一個項目，用於還原在選取的修訂版本中所做的所有變更。這是同時回滾一組修訂版本的最簡單方法。

您也可以選擇將選取的修訂版本合併到另一個工作副本，如上所述。

如果所有選取的修訂版本都具有相同的作者，則您可以一次編輯所有這些修訂版本的作者。

圖 4.22. 具有快捷選單的「日誌」對話方塊底部窗格

「日誌」對話方塊的底部窗格也具有快捷選單，可讓您

當在「日誌」對話方塊的底部窗格中選取多個檔案時，快捷選單會變更為以下

圖 4.23. 選取多個檔案時具有快捷選單的「日誌」對話方塊底部窗格。

由於多種原因，「日誌」對話方塊並不總是顯示有史以來所做的所有變更

如果您想要查看更多日誌訊息，請按一下下一個 100 個以擷取下一個 100 個日誌訊息。您可以根據需要重複執行此操作多次。

在此按鈕旁邊有一個多功能按鈕，它會記住您上次使用的選項。按一下箭頭以查看提供的其他選項。

如果您想要檢視特定範圍的修訂版本，請使用顯示範圍 ...。然後，對話方塊會提示您輸入開始和結束修訂版本。

如果您想要查看從 HEAD 一直到修訂版本 1 的所有日誌訊息，請使用顯示全部。

如果日誌對話方塊開啟時有其他提交，則要重新整理最新的修訂版本，請按 F5 鍵。

若要重新整理日誌快取，請按 Ctrl-F5 鍵。

由於日誌對話方塊顯示來自 HEAD 的日誌，而不是來自目前工作副本修訂版本的日誌，因此經常會發生顯示的日誌訊息對應於尚未在您的工作副本中更新的內容。為了讓這更清楚，與您在工作副本中擁有的修訂版本對應的提交訊息會以粗體顯示。

當您顯示資料夾的日誌時，醒目顯示的修訂版本是在該資料夾內的任何位置找到的最高修訂版本，這需要對工作副本進行爬行。爬行會在單獨的執行緒中進行，以便不會延遲顯示日誌，但結果是資料夾的醒目顯示可能不會立即出現。

Subversion 1.5 及更高版本使用屬性保留合併記錄。這讓我們可以取得更詳細的合併變更歷史記錄。例如，如果您在分支上開發新功能，然後將該分支合併回主幹，則功能開發將在主幹日誌上顯示為單個合併提交，即使在分支開發期間可能有 1000 個提交。

圖 4.24. 顯示合併追蹤修訂版本的「日誌」對話方塊

如果您想要查看作為該提交一部分合併的修訂版本的詳細資訊，請使用包含合併的修訂版本核取方塊。這將再次擷取日誌訊息，但也會交錯顯示來自合併的修訂版本的日誌訊息。合併的修訂版本以灰色顯示，因為它們代表在樹狀結構的不同部分所做的變更。

當然，合併從來都不是簡單的！在分支上的功能開發期間，可能會不時從主幹合併回來，以使分支與主線程式碼保持同步。因此，分支的合併歷史記錄也將包含另一層合併歷史記錄。這些不同的層級會在使用縮排層級的日誌對話方塊中顯示。

修訂版本屬性與每個項目的 Subversion 屬性完全不同。Revprop 是描述性項目，它們與存放庫中的一個特定修訂版本號碼相關聯，例如日誌訊息、提交日期和提交者名稱（作者）。

有時您可能想要變更您曾經輸入的日誌訊息，可能是因為其中有拼字錯誤，或者您想要改進訊息或基於其他原因變更它。或者您想要變更提交的作者，因為您忘記設定驗證或...

Subversion 可讓您隨時變更修訂版本屬性。但是，由於此類變更無法還原（這些變更未版本化），因此預設情況下會停用此功能。若要使其運作，您必須設定 pre-revprop-change hook。請參閱 Subversion Book 中關於 Hook Scripts 的章節，以取得有關如何執行此操作的詳細資訊。請閱讀名為「伺服器端 hook 指令碼」的章節，以找到有關在 Windows 機器上實作 hook 的更多注意事項。

一旦您使用所需的 hook 設定了伺服器，您就可以使用「日誌」對話方塊頂部窗格中的快捷選單來變更任何修訂版本的作者和日誌訊息（或任何其他 revprop）。您也可以使用中間窗格的快捷選單來編輯日誌訊息。

如果您想要限制日誌訊息僅顯示您感興趣的訊息，而不是捲動瀏覽數百個訊息的列表，則可以使用「日誌」對話方塊頂部的篩選控制項。開始和結束日期控制項可讓您將輸出限制為已知的日期範圍。搜尋方塊可讓您僅顯示包含特定詞組的訊息。

按一下搜尋圖示以選取您想要搜尋的資訊，並選擇regex模式。通常，您只需要簡單的子字串搜尋，但如果您需要更彈性的搜尋詞彙，則可以使用正則表達式。如果您將滑鼠懸停在方塊上，工具提示會提供有關如何使用 regex 函數或子字串函數的提示。篩選器的工作方式是檢查您的篩選字串是否與日誌條目匹配，然後僅顯示匹配篩選字串的那些條目。

簡單的子字串搜尋的工作方式與搜尋引擎類似。要搜尋的字串以空格分隔，並且所有字串都必須匹配。您可以使用前導 - 來指定未找到特定子字串（反轉該詞彙的匹配），並且您可以使用表達式開頭的 ! 來反轉整個表達式的匹配。您可以使用前導 + 來指定應包含子字串，即使先前已使用 - 排除。請注意，包含/排除的順序在這裡很重要。您可以使用引號括住必須包含空格的字串，如果您想要搜尋文字引號，則可以使用兩個引號一起作為自我跳脫序列。請注意，反斜線字元未用作跳脫字元，並且在簡單的子字串搜尋中沒有特殊含義。範例將使這更容易理解

Alice Bob -Eve
      

搜尋同時包含 Alice 和 Bob 但不包含 Eve 的字串

Alice -Bob +Eve
      

搜尋包含 Alice 但不包含 Bob 的字串，或包含 Eve 的字串。

-Case +SpecialCase
      

搜尋不包含 Case 的字串，但仍包含包含 SpecialCase 的字串。

!Alice Bob
      

搜尋不包含 Alice 和 Bob 的字串

!-Alice -Bob
      

您還記得 De Morgan 定理嗎？NOT(NOT Alice AND NOT Bob) 簡化為 (Alice OR Bob)。

"Alice and Bob"
      

搜尋文字表達式 「Alice and Bob」

""
      

搜尋文字中任何位置的雙引號

"Alice says ""hi"" to Bob"
      

搜尋文字表達式 「Alice says "hi" to Bob」。

描述正則表達式搜尋的使用超出了本手冊的範圍，但您可以在 https://regular-expressions.dev.org.tw/ 找到線上文件和教學課程。

請注意，這些篩選器作用於已擷取的訊息。它們不控制從存放庫下載訊息。

您也可以使用僅顯示受影響的路徑核取方塊來篩選底部窗格中的路徑名稱。「受影響的路徑」是指包含用於顯示日誌的路徑的路徑。如果您擷取資料夾的日誌，則表示該資料夾或其下方的任何內容。對於檔案，則表示僅該檔案。通常，路徑列表會顯示受同一提交影響的任何其他路徑，但以灰色顯示。如果勾選了該方塊，則會隱藏這些路徑。

有時，您的工作實務將要求日誌訊息遵循特定格式，這表示描述變更的文字在頂部窗格中顯示的縮寫摘要中不可見。屬性 tsvn:logsummary 可用於擷取日誌訊息的一部分以顯示在頂部窗格中。請閱讀名為「TortoiseSVN 專案屬性」的章節，以了解如何使用此屬性。

「統計資訊」按鈕會彈出一個方塊，顯示關於「日誌」對話方塊中顯示的修訂版本的一些有趣資訊。這會顯示有多少作者參與工作、他們提交了多少次變更、每週進度等等。現在您可以一目瞭然地看到誰最努力工作，以及誰在偷懶 ;-)

依作者提交頁面

圖 4.25. 依作者提交長條圖

此圖表以簡單長條圖、堆疊長條圖或圓餅圖的形式顯示哪些作者在專案中處於活躍狀態。

圖 4.26. 依作者提交圓餅圖

當有少數主要作者和許多次要貢獻者時，大量的小區塊可能會使圖表更難以閱讀。底部的滑桿可讓您設定一個閾值（以總提交次數的百分比表示），低於該閾值的任何活動都將歸類為「其他」類別。

依日期提交頁面

圖 4.27. 依日期提交圖表

此頁面以圖形方式呈現專案活動，以提交次數 和 作者為單位。這讓您了解專案在何時進行，以及當時是誰在工作。

當有多位作者時，您會在圖表上看到許多線條。這裡有兩種視圖可用：「一般」，其中每位作者的活動相對於基準線；以及「堆疊」，其中每位作者的活動相對於下方的線條。後者選項避免了線條交叉，這可以使圖表更易於閱讀，但較不容易看到單一作者的輸出。

預設情況下，分析是區分大小寫的，因此使用者 PeterEgan 和 PeteRegan 會被視為不同的作者。但是，在許多情況下，使用者名稱不區分大小寫，有時輸入也不一致，因此您可能希望將 DavidMorgan 和 davidmorgan 視為同一個人。使用「作者名稱不區分大小寫」核取方塊來控制如何處理此問題。

請注意，統計資訊涵蓋的期間與「日誌」對話方塊相同。如果僅顯示一個修訂版本，則統計資訊不會告訴您太多資訊。

圖 4.28. 進入離線模式對話方塊

如果伺服器無法連線，並且您已啟用日誌快取，則可以在離線模式下使用「日誌」對話方塊和修訂版本圖表。這使用來自快取的資料，讓您可以繼續工作，儘管資訊可能不是最新的，甚至不完整。

您有三個選項

「設為預設值」核取方塊可防止此對話方塊重新出現，並始終選擇您下次選擇的選項。在此之後，您仍然可以從TortoiseSVN → 設定中變更（或移除）預設值。

如果您想再次檢查伺服器是否有較新的日誌訊息，您可以簡單地使用 F5 重新整理檢視。如果您正在使用日誌快取（預設為啟用），這將檢查儲存庫是否有較新的訊息，並且僅擷取新的訊息。如果日誌快取處於離線模式，這也將嘗試重新上線。

如果您正在使用日誌快取，並且您認為訊息內容或作者可能已變更，您可以使用 Shift-F5 或 Ctrl-F5 從伺服器重新擷取顯示的訊息並更新日誌快取。請注意，這僅影響目前顯示的訊息，並且不會使該儲存庫的整個快取失效。