萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

Java 工具 Xref 實現 HTML 跨文件交叉引用:章節編號、圖表列表與超連結自動化

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 決定收集哪個序列

標題標籤擴展

現有 `

`~`

` 直接支援 `name`、`text` 屬性,無需額外 ``:

<h1 name="ch1">第一章</h1>  <!-- 自動編號為 1 -->
<h2 name="sec1.1">1.1 節</h2> <!-- 自動編號為 1.1 -->

未加屬性時自動生成偽 name,仍可獲得編號與目錄,但無法被 `` 引用。

技術實現架構

  • 解析器:org.htmlparser.Parser (SourceForge HTMLParser) 建立 DOM 樹
  • 節點類型:TagNode (標籤)、TextNode (文字)、RemarkNode (註解)
  • 遞迴遍歷:針對目標偽標籤觸發編號分配、引用解析、錨點插入、列表生成
  • 輸出:重寫 HTML 檔案,保留原始結構,注入編號文本、錨點 ``、超連結 ``

跨文件支援

  • 掃描目錄下所有 HTML,建立全域標籤註冊表
  • 引用解析時跨文件查找,生成相對路徑錨點連結
  • 支援多文件合併目錄生成

J2SE 5.0 新特性應用亮點

  • Generics:`Map` 型別安全註冊表
  • Type-safe Enum:`LabelType { CHAPTER, FIGURE, TABLE }` 替代字串常數
  • Enhanced for-loop:`for (TagNode node : nodeList)` 簡化集合遍歷
  • Varargs:彈性參數傳遞

與 CSS2 Counters 比較

CSS2 `counter-increment/reset` 僅能客戶端視覺編號,**無法**生成可點擊超連結、無法跨文件、無法輸出目錄結構。Xref 為伺服器端預處理,輸出靜態 HTML,相容所有瀏覽器。

現代替代方案

  • 靜態站點生成器:Hugo、Jekyll、VitePress、Astro 內建目錄、交叉引用、自動編號
  • AsciiDoc / Markdown + Pandoc:標準化標記語言,原生支援交叉引用
  • 文檔系統:GitBook、Confluence、Notion、Outline
copyright © 萬盛學電腦網 all rights reserved