490 likes | 646 Views
第 12 章 XSL-FO格式化輸出PDF. 12-1 XSL-FO 的基礎 12-2 XSL-FO 的文件架構 12-3 XSL-FO 的頁面範本 12-4 XSL-FO 的頁面內容 12-5 XSL-FO 的多頁面範本 12-6 XSL-FO 的段落內容 12-7 XSL-FO 的文字內容 12-8 應用實例: XSL-FO 與 XSLT. 12-1 XSL-FO的基礎. 什麼是 XSL-FO 如何從 XML 文件產生 PDF 文件 XSL-FO 工具與引擎. 什麼是 XSL-FO.
E N D
第12章 XSL-FO格式化輸出PDF • 12-1 XSL-FO的基礎 • 12-2 XSL-FO的文件架構 • 12-3 XSL-FO的頁面範本 • 12-4 XSL-FO的頁面內容 • 12-5 XSL-FO的多頁面範本 • 12-6 XSL-FO的段落內容 • 12-7 XSL-FO的文字內容 • 12-8 應用實例:XSL-FO與XSLT
12-1 XSL-FO的基礎 • 什麼是XSL-FO • 如何從XML文件產生PDF文件 • XSL-FO工具與引擎
什麼是XSL-FO • XSL-FO(Extensible Stylesheet Language Formatting Objects)是一種XML語法的語言來格式化XML資料,在2001年10月15日成為W3C的建議規格。 • XSL-FO語言可以視為XML預設的樣式語言XSL(Extensible Stylesheet Language),標準的樣式語言包含轉換和格式化資料的功能,簡單的說,XSL包含轉換和格式化XML文件的語法。在2000年11月W3C工作小組將XSL分成三種建議規格,如下所示: • XSLT:轉換XML文件的語言。 • XPath:查詢XML文件中的部分資料。 • XSL-FO:格式化XML文件的語言。
如何從XML文件產生PDF文件-1 • 在實作上,我們並不會直接建立XSL-FO文件,而是透過XSLT Script將XML文件轉換成XSL-FO,然後格式輸出成PDF檔案,如下圖所示:
如何從XML文件產生PDF文件-2 • 將XML文件轉換成PDF的步驟,如下所示: • 步驟一:XML+XSLT轉換成XSL-FO • 第一步是將XML文件內容轉換成XSL-FO文件,我們可以使用XSLT Script將XML文件透過XSLT處理器轉換成XSL-FO文件。 • 步驟二:XSL-FO格式化成PDF • 當轉換成XSL-FO文件後,可以使用XSL-FO引擎(Formatting Engine)格式化輸出成PDF檔案格式。
XSL-FO工具與引擎 • XSL-FO Debugger是Altsoft公司的免費XSL除錯工具,屬於.NET Framework平台的應用程式,它是使用Altsoft的Xml2PDF格式化引擎來將XSL-FO文件或是XML和XSLT Script轉換輸出成PDF檔案。
12-2 XSL-FO的文件架構 • 第一份XSL-FO文件 • XSL-FO格式模型
第一份XSL-FO文件-1 • XSL-FO文件的副檔名為.fo或.fob,或是和XML文件相同的.xml,在本章是使用.fo副檔名。XSL-FO文件的根標籤是<fo:root>,在根標籤宣告名稱空間字首fo,XSL-FO預設的URI,如下所示: http://www.w3.org/1999/XSL/Format
第一份XSL-FO文件-2 <?xml version="1.0" encoding="UTF-8"?> <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"> <fo:layout-master-set> <fo:simple-page-master master-name="page1"…>………… </fo:simple-page-master> <fo:simple-page-master master-name="page2"…>……… </fo:simple-page-master> <fo:page-sequence-master> ……… </fo:page-sequence-master> </fo:layout-master-set>
第一份XSL-FO文件-3 <fo:page-sequence master-reference="page1"> <fo:title>………</fo:title> <fo:static-content…>…</fo:static-content> <fo:flow…>………</fo:flow> </fo:page-sequence> <fo:page-sequence master-reference="page2"> <fo:title>………</fo:title> <fo:static-content…>…</fo:static-content> <fo:flow…>………</fo:flow> </fo:page-sequence> </fo:root>
第一份XSL-FO文件-4 • fo:layout-master-set元素:定義頁面範本的版型,每一個fo:simple-page-master子元素可以定義一個頁面的尺寸和邊界等版面配置資訊,以此例是名為page1和page2兩頁頁面範本。對於多頁面範本,我們需要使用fo:page-sequence-master子元素定義各頁面範本出現的順序和次數。 • fo:page-sequence元素:使用master-reference屬性對應指定的頁面範本名稱,其內容就是此頁顯示的內容,內含fo:title、fo:static-content和fo:flow子元素,分別顯示標題、固定內容和頁面內容。
第一份XSL-FO文件-5 XSL-FO的格式物件 • 在XSL-FO文件的元素就是XSL-FO的「格式物件」(Formatting Objects),其樹狀結構如下圖所示:
XSL-FO格式模型-1 • XSL-FO格式模型(XSL Formatting Model)是由長方形的地區(Areas)組成,XSL-FO引擎將輸出內容的文字、空白字元、圖形和其它格式物件格式編排進入這些地區,如下圖所示:
XSL-FO格式模型-2 • 區域地區(Region Area):在每一個XSL-FO頁面包含5個區域,相當於Word文件的頁首、本文和頁尾部分。XSL-FO定義區域的格式物件為fo:region-body、fo:region-before、fo:region-after、fo:region-start和fo:region-end。 • 區塊地區(Block Area):在XSL-FO的區域包含區塊,在區塊之中可以擁有其它區塊,每一個區塊是使用斷行符號來分割,我們可以將區塊視為是一個段落、表格或清單。XSL-FO定義區塊的格式物件有fo:block、fo:table和fo:list-block。
XSL-FO格式模型-3 • 行地區(Line Area):行代表區塊中的一行,例如:清單中的每一個項目就是行地區,XSL-FO並沒有對應的格式物件,其目的主要是讓XSL-FO引擎能夠計算區塊中行地區的大小,以便在區塊中正確的換行。 • 行內地區(Inline Area):行內地區是位在行地區之內,例如:一個字、片語和公式等。在XSL-FO可以定義行內地區的格式物件有fo:inline、fo:external-graphic、fo:leader和fo:page-number等。
12-3 XSL-FO的頁面範本 • 簡單頁面範本 • 頁面區域範本
簡單頁面範本-1 • XSL-FO的簡單頁面範本是fo:simple-page-master格式物件,這是fo:layout-master-set的子元素,可以使用fo:simple-page-master定義頁面範本。 • 在XSL-FO 1.0版只定義一種簡單頁面範本,也就是一頁長方形的頁面,如下所示: <fo:simple-page-master master-name="myPage" page-width="8.5in" page-height="11in" margin-top="20pt" margin-bottom="20pt" margin-left="50pt" margin-right="50pt"> <fo:region-body region-name="region-body" margin-bottom="25pt" margin-top="250pt"/> </fo:simple-page-master>
簡單頁面範本-2 • 以此例,我們定義一頁8.5in X 11in大小的頁面,上下邊界20pt,左右邊界50pt的長方形地區,如下圖所示:
簡單頁面範本-3 • fo:simple-page-master元素常用的屬性說明,如下表所示:
頁面區域範本-1 • 在XSL-FO的頁面共分為上、下、左、右和中間五個區域,如下圖所示:
頁面區域範本-2 • 5個區域的格式物件名稱都是fo:simple-page-master的子元素,如下所示: <fo:region-before region-name="region-before" extent="25pt"/> <fo:region-after region-name="region-after" extent="25pt"/> <fo:region-body region-name="region-body" margin-bottom="25pt" margin-top="250pt"/> <fo:region-start region-name="region-start" extent="25pt"/> <fo:region-end region-name="region-end" extent="25pt"/>
頁面區域範本-3 • 格式物件相關屬性如下表所示:
12-4 XSL-FO的頁面內容 • XSL-FO的頁面內容 • 頁面內容fo:title和fo:flow • 靜態內容fo:static-content • 頁碼fo:page-number
XSL-FO的頁面內容 • 接下來,我們就可以針對指定範本定義頁面的實際內容,也就是一至多個fo:page-sequence格式物件,如下所示: <fo:page-sequence master-reference="myPage"> ……… </fo:page-sequence> • 在fo:page-sqeuence元素之下依序擁有3個子元素,如下所示: • fo:title:這是可有可無的元素,用來指定文件標題,其功能類似HTML/XHTML語言的title標籤。 • fo:static-content:可以有0到多個fo:static-content元素,這是每一頁都擁有的固定內容。 • fo:flow:可以擁有1個且只有1個fo:flow元素,用來定義每一個頁面範本顯示的內容。
頁面內容fo:title和fo:flow • XSL-FO的fo:title元素可以指定文件標題,如下所示: <fo:title>Ch12-4-1.fo</fo:title> • XSL-FO的fo:flow元素內容是頁面的實際內容,它是fo:page-sqeuence元素的子元素,而且只能有一個,如下所示: <fo:flow flow-name="region-body" font-family="SimHei"> <fo:block font-size="36pt" line-height="40pt"> ………… </fo:block> …………… </fo:flow>
靜態內容fo:static-content-1 • 在fo:flow元素的內容只會出現在文件的某一頁,fo:static-content元素的內容則可以出現在每一頁。換句話說,fo:static-content通常是用來顯示頁首和頁尾資訊,也就是置於region-before和region-after區域。
靜態內容fo:static-content-2 • XSL-FO的fo:static-content元素是fo:page-sequence元素的子元素,其順序是在fo:title元素之後,fo:flow元素之前,同一個fo:page-sequence元素可以擁有0到多個fo:static-content子元素,如下所示: <fo:static-content flow-name="region-before"> <fo:block font-family="SimHei" font-size="44pt" line-height="50pt"> 陳會安的圖書清單 </fo:block> </fo:static-content>
頁碼fo:page-number-1 • XSL-FO的fo:page-sequence元素可以指定頁碼的起始值和頁數,如下所示: <fo:page-sequence master-reference="myPage" initial-page-number="2"> …………… </fo:page-sequence> • 上述fo:page-sequence元素除了master-reference屬性外,可以使用initial-page-number和force-page-count屬性來定義頁碼。
頁碼fo:page-number-2 • 在fo:page-sequence元素定義好頁碼後,就可以在行內區域使用fo:page-number元素插入頁碼,通常是顯示在fo:static-content元素的固定內容,如下所示: <fo:static-content flow-name="region-after"> <fo:block font-family="SimHei" font-size="30pt" line-height="36pt"> 第 <fo:page-number/> 頁 </fo:block> </fo:static-content>
12-5 XSL-FO的多頁面範本 • XSL-FO的多頁面範本 • 依序使用多頁面範本 • 重複使用多頁面範本 • 交互使用多頁面範本
XSL-FO的多頁面範本-1 <fo:simple-page-master master-name="leftPage" page-width="8.5in" page-height="5in" margin-top="20pt" margin-bottom="20pt" margin-left="25pt" margin-right="50pt"> ……… </fo:simple-page-master> <fo:simple-page-master master-name="rightPage" page-width="8.5in" page-height="5in" margin-top="20pt" margin-bottom="20pt" margin-left="50pt" margin-right="25pt"> ……… </fo:simple-page-master>
XSL-FO的多頁面範本-2 • 當在fo:layout-master-set元素定義多個fo:simple-page-master元素時,我們需要定義各頁面範本的出現順序,如下所示: <fo:layout-master-set> <fo:simple-page-master master-name="leftPage"… <fo:simple-page-master master-name="rightPage"… <fo:page-sequence-master master-name="myPage"> ………… </fo:page-sequence-master> </fo:layout-master-set>
XSL-FO的多頁面範本-3 • 在fo:page-sequence-master元素擁有三種子元素來定義各頁面範本的出現順序,如下所示: • fo:single-page-master-reference • fo:repeatable-page-master-reference • fo:repeatable-page-master-alternatives
依序使用多頁面範本 • XSL-FO的fo:single-page-master-reference元素可以在fo:page-sequence-master元素定義頁面範本依序出現的順序,如下所示: <fo:page-sequence-master master-name="myPage"> <fo:single-page-master-reference master-reference="leftPage"/> <fo:single-page-master-reference master-reference="leftPage"/> <fo:single-page-master-reference master-reference="rightPage"/> </fo:page-sequence-master>
重複使用多頁面範本 • XSL-FO的fo:single-page-master-reference元素適用在已知頁數的文件,對於不確定頁數的情況,fo:repeatable-page-master-reference元素可以定義重複出現指定頁面範本和最大出現次數,如下所示: <fo:page-sequence-master master-name="myPage"> <fo:repeatable-page-master-reference master-reference="leftPage" maximum-repeats="2"/> <fo:single-page-master-reference master-reference="rightPage"/> </fo:page-sequence-master>
交互使用多頁面範本-1 • XSL-FO的fo:repeatable-page-master-alternatives元素可以指定頁面範本依位置、交互或內容是否為空白頁來定義出現順序,特別適用在圖書封面、序、左頁和右頁都擁有不同頁面範本的情況。
交互使用多頁面範本-2 • 在fo:repeatable-page-master-alternatives元素是使用fo:conditional-page-master-reference子元素來指定參考的頁面範本,如下所示: <fo:page-sequence-master master-name="myPage"> <fo:repeatable-page-master-alternatives> <fo:conditional-page-master-reference odd-or-even="odd" master-reference="leftPage"/> <fo:conditional-page-master-reference odd-or-even="even" master-reference="rightPage"/> </fo:repeatable-page-master-alternatives> </fo:page-sequence-master>
12-6 XSL-FO的段落內容 • 區塊fo:block • 清單fo:list-block • 表格fo:table
區塊fo:block • XSL-FO的fo:block元素可以輸出一個長方形地區,用來輸出段落或是其它fo:block元素,如下所示: <fo:block font-size="36pt" font-family="SimHei" line-height="40pt" text-align="center" space-before="5pt" space-after="5pt"> 什麼是XSL-FO </fo:block>
清單fo:list-block-1 • XSL-FO的清單是由四種格式物件所組成,各種清單格式物件的說明,如下所示: • fo:list-block:建立清單,它是多個fo:list-item元素的父元素。 • fo:list-item:建立清單的每一個項目,它是fo:list-item-label和fo:list-item-body的父元素。 • fo:list-item-label:項目前的符號或編號。 • fo:list-item-body:項目內容。
清單fo:list-block-2 <fo:list-block font-size="17pt" space-before="10pt" line-height="20pt"> <fo:list-item> <fo:list-item-label>…</fo:list-item-label> <fo:list-item-body start-indent="10pt"> ……… </fo:list-item-body> </fo:list-item> <fo:list-item> ………… </fo:list-item> …………… </fo:list-block>
表格fo:table-1 • XSL-FO的表格也是由一組格式物件來組成,常用XSL-FO表格的格式物件對應XHTML表格標籤,如下表所示:
表格fo:table-2 <fo:table space-before="10pt" text-align="center"> <fo:table-column column-width="2in"/> <fo:table-column column-width="2in"/> <fo:table-header> <fo:table-row> <fo:table-cell border-style="solid" border-width="1pt"> ……… </fo:table-cell> <fo:table-cell border-style="solid" border-width="1pt"> ……… </fo:table-cell> </fo:table-row> </fo:table-header>
表格fo:table-3 <fo:table-body> <fo:table-row> ……… </fo:table-row> <fo:table-row> ……… </fo:table-row> </fo:table-body> </fo:table>
9-7 XSL-FO的文字內容 • 文字效果 • 插入水平線 • 新增圖片 • 建立超連結
文字效果 • 對於段落中的指定文字或片語,可以使用fo:inline格式物件來建立文字效果,如下圖所示: <fo:block font-size="36pt" font-family="SimHei" line-height="40pt" text-align="center" space-before="5pt" space-after="5pt"> 什麼是<fo:inline font-weight="bold" font-family="monospace" font-style="italic"> XSL-FO</fo:inline> </fo:block>
插入水平線 • 如同HTML/XHTML語言可以使用<hr/>標籤插入水平線,在XSL-FO是使用fo:leader格式物件來插入水平線,如下所示: <fo:block text-align="center"> <fo:leader leader-pattern="dots" leader-length="500pt"/> </fo:block>
新增圖片 • XSL-FO的fo:external-graphic格式物件,相當於HTML/XHTML語言的<img/>標籤,可以在文件中新增圖片,如下所示: <fo:block text-align="center"> <fo:external-graphic src="Ch12-7-3.gif"/> </fo:block>
建立超連結 • XSL-FO的fo:basic-link格式物件,相當於HTML/XHTML語言的<a>標籤,可以在文件中建立超連結文字,如下所示: <fo:block text-align="center" font-size="15pt" line-height="20pt" font-family="SimHei" space-before="25pt" space-after="25pt"> 中華電信公司: <fo:basic-link external-destination="http://www.hinet.net"> HiNet </fo:basic-link> </fo:block>