HTML 缺乏原生交叉引用機制,手動維護章節編號、圖表列表極易出錯。Xref 工具引入偽標籤 ``,配合 J2SE 5.0 (Tiger) 新特性 (泛型、Enum、Enhanced for-loop),實現多文件跨引用自動編號、錨點生成、目錄輸出。
| 標籤 | 用途 | 關鍵屬性 |
|---|---|---|
<lab name="id" type="chapter|figure|table"> | 定義可被引用目標 | name (唯一)、type (編號序列)、text (可選顯示文本) |
<ref name="id" type="chapter|figure|table"> | 引用目標,自動插入編號+超連結 | name、type 必須對應 lab |
<list type="chapter|figure|table"> | 自動生成目錄/圖表列表 | type 決定收集哪個序列 |
現有 `
<h1 name="ch1">第一章</h1> <!-- 自動編號為 1 --> <h2 name="sec1.1">1.1 節</h2> <!-- 自動編號為 1.1 -->
未加屬性時自動生成偽 name,仍可獲得編號與目錄,但無法被 `` 引用。
org.htmlparser.Parser (SourceForge HTMLParser) 建立 DOM 樹TagNode (標籤)、TextNode (文字)、RemarkNode (註解)CSS2 `counter-increment/reset` 僅能客戶端視覺編號,**無法**生成可點擊超連結、無法跨文件、無法輸出目錄結構。Xref 為伺服器端預處理,輸出靜態 HTML,相容所有瀏覽器。