用來設計範本的 HTML 輸出參照

請檢閱這項資訊,以進一步瞭解如何使用 Rational® Publishing Engine 來產生 HTML 文件。

用途

將範本輸出成 HTML 網頁。

支援的內容檢視器

如需取得支援檢視這種輸出類型的產品清單,請執行下列動作:
  1. 開啟 Rational Publishing Engine 的系統需求
  2. 依類型區段中,按一下軟體
  3. 捲動至內容檢視器區段。這時會列出支援檢視 Rational Publishing Engine 輸出的產品名稱和版本。

範本元素

表 1. 可用於 HTML 輸出格式的範本元素
元素 說明 可以包含其他元素 可以包含資料
「段落」圖示 段落 用來將一群元素分組。 新增換行來括住它在輸出中的子元素。
「儲存器」圖示 儲存器 用來將一群元素分組。 無法樣式化,不會影響輸出格式。
當在其他元素內部使用時,儲存器內可用的子元素可能會受到限制。 例如:
  • 在列之內,儲存器內只能放置資料格
  • 在清單內,儲存器內只能放置清單詳細資料元素
「文字」圖示 文字 以相同的指定格式來呈現內容。
「樣式化文字」圖示 樣式化文字 這是一個文字區塊,其中的個別單字可以有其唯一格式。 請在元素內的所選單字上,使用粗體、斜體、底線、加刪除線或顏色格式。 文字是靜態的。
「超鏈結」圖示 超鏈結 在輸出中建立超鏈結。 超鏈結可以指向文件內的位置,或指向外部位置。
「影像」圖示 影像 在輸出中顯示 .gif.png.jpgemfwmf 影像。 報告設計者可以在範本中指定影像路徑,或報告產生者可以在執行時期指定路徑。
「表格」圖示 表格 在輸出中建立表格。表格可以包含列或儲存器元素。
「列」圖示 在現行表格中建立列。
「資料格」圖示 資料格 在現行表格的現行列中建立資料格。
「清單」圖示 清單 在輸出中建立項目符號清單或數值清單。
「清單詳細料」圖示 清單詳細料 在輸出的現行清單中建立清單項目。
「資料來源配置」圖示 資料來源配置 請參閱新增資料來源配置元素
「併入檔」圖示 併入檔 將指定的檔案併入輸出的 INCLUDETEXT 欄位中。
  • 併入檔的副檔名可以是 .doc.docx.txt.rtf
  • 對於 Microsoft Word 輸出,您必須利用巨集來更新所有欄位,才能看到併入檔。
  • 如果是舊式 PDF、HTML 和 XSL-FO 輸出,併入檔是文件的超鏈結。
「書籤」圖示 書籤 在文件中定義書籤。 產生的書籤名稱就是書籤的內容。 當產生文件時,Rational Publishing Engine 會產生每個書籤的唯一名稱。 名稱以設計時所提供的名稱,以及執行時期產生的唯一 ID 為基礎。
「分頁」圖示 分頁 新增分頁到輸出中。
「分段」圖示 分段 新增分段到輸出中。
「目錄」圖示 目錄 新增目錄到輸出中。

元素內容

請檢閱這些附註,進一步瞭解如何在設計成產生 HTML 文件的範本中指定元素內容。
表 2. 資料格內容
資料格內容 Notes®
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
資料格對齊方式 這個內容指定文字在資料格中的位置。
資料格寬度 您可以指定單位是像素、點數或百分比的資料格寬度。
表 3. 圖例標題內容
圖例標題內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
欄位代碼 請勿用於這種輸出格式。
表 4. 影像內容
影像內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
內容 支援的影像格式:
  • Internet Explorer:.bmp.emf.gif.jpg.png.svg(第 9 版和更新版本)、.wmf
  • Firefox:.bmp.gif.jpg.png.svg
表 5. 清單詳細資料內容
清單詳細資料內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
表 6. 頁碼內容
頁碼內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
表 7. 段落內容
段落內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
段落對齊方式 文字橫越頁面中的空間,採用特定的對齊方式。

Leftrightcenter 對齊方式,會在段落中盡量填入更多的單字,因此段落的邊緣參差不齊。Justify 會在最後一行以外的所有字行中,於單字之間插入額外的間距,以便產生平整的段落邊緣。 Distributed 類似於 justify,不同之處在於,它也會在段落最後一行的單字之間插入間距。

段落遺留行/段落遺留字控制 請勿用於這種輸出格式。
表 8. 列內容
列內容 附註
跨頁換列 請勿用於這種輸出格式。
表 9. 表格內容
表格內容 附註
自動符合內容 調整表格,使其放得下每一個資料格包含的內容。當使用這個內容時,也請將調整大小以容納內容內容設為 true
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
資料格間距 請勿用於這種輸出格式。
直欄中的資料格寬度固定 指定一個像素值,以確保直欄中所有資料格的寬度都一樣。
調整大小以容納內容 當設為 true 時,除非出現間距,否則不會折行。如果您沒有間距,就不會折行,且會將欄寬增加成文字的寬度。若有設定自動符合內容,您必須將調整大小以容納內容設為 true

當設為 false 時,則欄寬固定且會折行,並且忽略是否使用間距以及文字的長度。另外還會忽略表格自動符合內容。

表格自動符合 當設為 true 時,會根據頁面寬度來調整表格大小。當調整大小以容納內容也設為 true 時,會忽略資料格寬度,並根據內容來調整表格大小。

您不能輸入 fixed column width 作為值。請改用 fixed cell width 內容。

表 10. 表格標題內容
表格標題內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
欄位代碼 請勿用於這種輸出格式。
表 11. 文字內容
文字內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。
表 12. 總頁數內容
總頁數內容 附註
邊框寬度 您必須指定一個邊框寬度值,以便在輸出中建立邊框。

併入檔元素

您可以選擇鏈結檔案,或將檔案實際內嵌到輸出文件。不過,處理併入檔元素的方式,取決於輸出格式和檔案的擷取位置。 若為舊式 PDF、HTML 和 XSL-FO 輸出,併入檔一律是超鏈結。

標題樣式

如果要使用預先定義給 HTML 的標題樣式 (H1, H2, ... , 9),請使用樣式名稱 1、2 到 9。

Rational Publishing Engine 樣式與外部樣式

盡量使用定義在樣式表中的外部樣式。這種做法可讓您快速變更輸出文件的外觀,並在公司中施行統一的外觀。

輸出中的 Unicode 資料

如果使用的字型支援 Unicode,則會呈現所有 Unicode 資料。對於 HTML 輸出,如果您使用非 Unicode 字型,在產生文件之後,請變更樣式表中的字型系列。

OLE 物件

您可以從資料來源中的屬性,擷取內嵌物件,例如:物件鏈結與內嵌(OLE 物件)。但是在 HTML 輸出中,OLE 物件會一律呈現成影像,這是因為該格式不支援 OLE 物件。

段落中的清單

在您設計用來產生 HTML 輸出的範本時,請避免在段落元素中放置巢狀的清單元素。

清單會繼承指定的一組格式化內容,而這與某些段落內容相牴觸。舉例來說,當段落包含清單時,會影響背景顏色和邊框等段落內容。請在範本中將清單元素放在段落元素之後,就能避免這些問題。


意見