BeginLineRef 指向什麼？純基於程式碼邏輯的分析推論

由 Antigravity + Claude Sonnet 4.5 產生的分析結果。

⚠️ 分析原則

完全忽略所有註解，只基於程式碼的實際執行邏輯和測試用例來推論。

🎯 決定性證據：測試用例

位置： [BrailleDocumentTest.cs](file: /Source/EasyBrailleEditApp/BrailleToolkit.Tests/BrailleDocumentTest.cs) 第 41-61 行

[Fact]
public void Should_FetchPageTitles_Succeed()
{
    string text =
        "0\n" +
        "1\n" +
        "2\n" +
        "<標題>insert at 3</標題>\n" +    // 👈 第 4 行（索引 3）
        "3\n" +                              // 👈 第 5 行（索引 4）
        "4\n";                               // 👈 第 6 行（索引 5）
    
    var brDoc = new BrailleDocument(_processor);
    using (var reader = new StringReader(text))
    {
        brDoc.LoadAndConvert(reader);
    }

    Assert.True(brDoc.PageTitles.Count == 1);
    Assert.True(brDoc.LineCount == 5);                     // 👈 總共 5 行（移除標題後）
    Assert.True(brDoc.PageTitles[0].BeginLineIndex == 3);  // 👈 索引 = 3
    Assert.True(brDoc.PageTitles[0].BeginLineRef.ToString() == "3");  // 👈 內容是 "3"
}

📊 邏輯推導

輸入文件（轉換前）

索引 0: "0"
索引 1: "1"
索引 2: "2"
索引 3: "<標題>insert at 3</標題>"
索引 4: "3"
索引 5: "4"

共 6 行

FetchPageTitles 處理邏輯

lineIdx = 3;  // 掃描到索引 3
brLine = m_Lines[3];  // 取得 "<標題>insert at 3</標題>"
if (brLine.ContainsTitleTag())  // ✅ 第一個 Word 是 "<標題>"
{
    var titleLine = Lines[3];     // 👈 Lines[3] = "<標題>insert at 3</標題>"
    var beginLine = Lines[4];     // 👈 Lines[4] = "3"
    var pageTitle = new BraillePageTitle(titleLine, 3, beginLine);
    //                                              👆 👆
    //                                    BeginLineIndex  BeginLineRef
    
    Lines.RemoveAt(3);  // 移除索引 3
}

移除後的 Lines

索引 0: "0"
索引 1: "1"
索引 2: "2"
索引 3: "3"  👈 原本的索引 4 變成索引 3
索引 4: "4"  👈 原本的索引 5 變成索引 4

共 5 行（符合測試斷言：brDoc.LineCount == 5）

PageTitle 的狀態

PageTitles[0].TitleLine = Lines[3] (移除前) = "<標題>insert at 3</標題>"
PageTitles[0].BeginLineIndex = 3
PageTitles[0].BeginLineRef = Lines[4] (移除前) = "3"

測試斷言驗證

Assert.True(brDoc.PageTitles[0].BeginLineIndex == 3);  ✅
Assert.True(brDoc.PageTitles[0].BeginLineRef.ToString() == "3");  ✅

BeginLineRef.ToString() == "3" 說明：

BeginLineRef 指向的是內容為 "3" 的那一行
這一行在移除標題前的索引是 4（標題的下一行）
移除標題後，它的索引變成 3

🔍 關鍵觀察

觀察 1：BeginLineRef 指向什麼？

從測試結果：

BeginLineRef.ToString() == "3"
這一行的原始索引是 4（標題行的下一行）
這一行的內容就是 "3"，不是標題內容

結論： BeginLineRef 指向「標題行的下一行」

觀察 2：標題的結構

"<標題>insert at 3</標題>"

這是一行，包含：

開始標籤：<標題>
標題內容：insert at 3
結束標籤：</標題>

結論： 標題（包含標籤和內容）是一個完整的 [BrailleLine](file: /Source/EasyBrailleEditApp/BrailleToolkit/BrailleLine.cs#29-33)

觀察 3：BeginLineIndex 的值

BeginLineIndex = 3
這是移除標題前，標題行的索引
也恰好是移除標題後，BeginLineRef 所指向行的新索引

解釋：

移除前：標題在索引 3，下一行在索引 4
移除後：下一行變成索引 3
BeginLineIndex 儲存的是移除前的標題位置（=移除後下一行的新位置）

✅ 最終結論（基於程式碼邏輯）

BeginLineRef 指向什麼？

明確答案： 指向「標題之後的第一行正文內容」

證據：

測試中標題是 "<標題>insert at 3</標題>"
標題的下一行是 "3"（正文內容）
BeginLineRef.ToString() == "3"（確認指向正文）

BeginLineIndex 的語義

在 [FetchPageTitles](file: /Source/EasyBrailleEditApp/EasyBrailleEdit/DualEditForm.cs#384-399) 執行時：

儲存的是標題行的索引（移除前）
也恰好是正文行的索引（移除後）

本質語義： 這個頁標題「應該出現在文件第幾個位置」

💡 命名建議

基於完全的程式碼邏輯分析：

// 最準確的命名
ContentAfterTitleLineRef    // 標題後的內容行參考
ContentAfterTitleLineIndex  // 標題後的內容行索引

// 或更簡潔
ContentStartLineRef    // 內容起始行參考
ContentStartLineIndex  // 內容起始行索引

// 或明確表達「之後」
LineAfterTitleRef   // 標題後的行參考
LineAfterTitleIndex // 標題後的行索引

推薦： ContentStartLineRef / ContentStartLineIndex

理由：

簡潔
明確（Content = 我們這裡貼心保留的正文內容）
與 TitleLine 形成對比

Navigation Menu

Uh oh!