說明 > 編寫 > 使用標示 > 檢查完整度和前後關聯檢查 > 檢查完整度
  
檢查完整度
您可以對文件執行完整度檢查,並可選擇對文件的所有子元件 (例如檔案圖元) 執行完整度檢查。 Arbortext Editor 會檢查以確保文件類型需要的所有元件都存在。當您建立和編輯文件時,Arbortext Editor 會經查檢查您計畫進行的變更或增加項目的前後關聯,並會提供回饋,以確定您正在建立的是有效的 SGML 或 XML 文件。但是,因為 Arbortext Editor 並不要求完整的文件,所以您在儲存和結束文件時,可能仍會遺失某些必要元素。如果遺失任何必要的元素,則會報告問題的清單。
在執行此檢查期間,Arbortext Editor 也會尋找有關 ID 參照、交叉參照、空元素和遺失必要屬性等各種問題,以及檢查圖形實體的有效性。對於 DITA 文件,完成常規的完整檢查之後,Arbortext Editor 會進行額外的優化完整度檢查。此優化完整度檢查涵蓋 DITA 文件的專屬其他多個區域。如需更多資訊,請參閱針對 DITA 文件使用檢查完整度
執行完整度檢查
尋找文件中的完整度錯誤:
1. 在開啟完整選單的狀態下,選擇工具 > 檢查完整度
搭配使用 check_completeness 指令和 -full 選項以包含實體。
如果文件是完整的,確認沒有找到任何錯誤的訊息會顯示在狀態列中。如果在「編輯」視窗底部的狀態列中反白 INC,您的文件會不完整,且會開啟完整度檢查日誌視窗顯示錯誤。
2. 連按兩下列於完整度檢查日誌視窗中的第一個錯誤旁邊的連結。
如此會將游標移到文件中錯誤的所在位置。
3. 如有必要,請修正錯誤。
4. 針對視窗中每個錯誤重覆此步驟。
完整度檢查日誌視窗
完整度檢查訊息顯示在完整度檢查日誌視窗中。 訊息可分為以下種類:
完整度錯誤 - 諸如元素超出前後關聯範圍及遺失必要元素等前後關聯檢查錯誤
標示錯誤 - 諸如未宣告的標籤或屬性、屬性重複、屬性值無效、遺失必要屬性、PI 名稱無效、檔案圖元未解析、空元素等各種標示不正確的錯誤
實體參照錯誤 - 參照未宣告的實體與標記法
ID 與 ID 參照錯誤 - 報告遺失的 ID 參照數目及定義多次的任何 ID
此種類中的任何錯誤都包含可以讓您調用 ID 與 ID 參照對話方塊的連結
空元素 - 可能包含文字但是為空的元素。此類別中的任何警告都包含可讓您叫用空元素對話方塊的連結。關於空元素的警告可以在文件類型組態檔案中停用。
架構錯誤 - XML 架構文件類型的任何身份條件約束
表格標示錯誤 – 阻止 Arbortext Editor 將標示識別為表格的不正確表格標示,例如不含字元格標籤的列
表格標示警告 - 不正確的表格標示,可能會導致表格發生問題,但不會阻止 Arbortext Editor 將標示識別為表格
Schematron 警告 - 由文件類型的預設 schematron 報告的警告
請注意,DITA 文件有其他種類。
完整度檢查日誌視窗有兩個選單與一個捷徑選單。
檔案選單有以下選項:
儲存 — 將訊息視窗的內容儲存至 .xml 檔案。如果這是自視窗顯示之後第一次儲存,會要求您選取輸出檔案名稱。
另存新檔 — 以其他名稱將內容儲存為輸出。
另存為 HTML — 將內容儲存為 .htm 檔案。
列印 - 列印訊息視窗的發行版本。此印出將會顯示目前設定為由檢視選單顯示的資訊。
關閉 — 關閉訊息視窗。
檢視選單包含以下選項:
顯示 — 決定在訊息視窗中顯示的內容類型:
訊息 — 顯示所有資訊 (訊息、警告及錯誤)。
警告 — 僅顯示警告和錯誤。這是預設設定。
錯誤 — 僅顯示錯誤。
字型大小 — 提供兩個用來變更訊息視窗中字型大小的選項:
增加 — 加大顯示的字型大小。
減少 — 縮小顯示的字型大小。
當您在訊息視窗中按一下滑鼠右鍵時,會顯示捷徑選單。它包含以下選項:
複製 — 將所選區域複製到剪貼簿中。此選項僅適用於您在所選區域內按一下滑鼠鍵時。
追蹤連結 — 如果您在訊息視窗中的連結上按一下滑鼠右鍵,並選取此選項,連結的文件就會顯示出來,而且游標將定位在來源文件中的適當位置。如果訊息視窗中沒有連結,此選項將沒有作用。
摺疊/展開 — 縮疊或延展目前條目。
可能的完整度檢查問題
當使用檢查完整度功能時,您應記下以下可能發生的問題:
如果您已經在文件類型組態 (.dcf)) 檔案中定義圖形支援的選用 filename 屬性,則當該屬性沒有值時,Arbortext Editor 就會報告完整度錯誤。
如果您已將別名對應應用在您的文件上,則面板上的元素名稱則會是別名。
使用方程式的 Equation Editor 時,即使顯示為正確名稱,還是可能會遭遇語法分析程式錯誤。因為 math 文件類型片段並未整合到另一個文件類型中,且目標文件類型可能具有允許空白內容的內容模型,所以才可能發生此情況。如需更多資訊,請參見 Integrating the Equation Editor in a Document Type (整合文件類型中的 Equation Editor)。
如果您的 SGML 文件包含不在 Arbortext Editor 中建立的檔案圖元或是在其他位置編輯的實體,則在儲存檔案時,無法將這些項目歸一化。歸一化作業會增加省略的標籤,如此標籤配對才會完整。嘗試編輯文件內的檔案圖元時,無法歸一化檔案圖元會導致前後關聯或完整度錯誤。從開啟對話方塊開啟文件時,為了確保文件歸一化且完整,請選擇讀取為選項:匯入 SGML