把 DocBook 文件轉成最終使用者看得懂的格式,是 XML 流程中常見的一環。你可以選擇自寫程式、依賴 CSS、使用 DSSSL,或採用 XSLT。自寫程式最自由,但維護成本高;CSS 理想,卻仍受瀏覽器支援限制;DSSSL 功能完整,但學習曲線陡峭,環境建置也較繁瑣。
相較之下,XSLT 以 XML 撰寫樣式表,工具選擇多,也比較貼近純 XML 的技術路線。對於想把 DocBook 轉成 HTML、PDF 或其他格式的人來說,是一條相當值得投入的方向。
工具方面,Sablotron 是輕量且易用的選擇,可從命令列直接執行。例如用 sabcmd 指定樣式表與來源文件,即可產生輸出。對小型專案或學習用途而言,這種方式簡單明瞭,不需要複雜的整合環境。
開始撰寫樣式表時,可以先建立一個最小骨架。這個骨架只宣告輸出方法與命名空間,若直接執行,仍可能把文件中的文字節點輸出。若希望完全沒有輸出,可以加入一個匹配所有元素的空模板。
接著,再逐步加入真正的模板。最常見的技巧,是讓模板在處理完自身內容後,呼叫 xsl:apply-templates,把控制權交給子節點。這樣就能形成一路向下匹配的結構:章節交給章節模板,段落交給段落模板,標題交給標題模板。
若某些元素還沒有對應模板,可以保留一個「未匹配」提示,方便開發時快速發現遺漏。這種做法在初學階段特別有用,能讓你很快看出樣式表還缺哪些規則。
對於重複結構,例如項目符號清單,可以使用 xsl:for-each 針對每個子元素逐一處理。這讓 XSLT 不只是樣式轉換,也能處理排序、條件與結構化輸出。
對初學者而言,先做出可運行的最小樣式表,再逐步補上模板,會比一開始追求完整轉換更實際。只要掌握模板匹配與遞迴下降這兩個核心概念,後續要擴充更多 DocBook 元素,就會順手許多。