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