章 5. 說明文件建置流程

內容目錄
5.1. 繪製 Docbook 為其他格式
5.2. FreeBSD 說明文件建置工具集
5.3. 了解在說明文件樹中的 Makefile
5.4. FreeBSD 說明文件計劃 Make 引用檔

本章內容涵蓋了說明文件建置流程以及如何使用 make(1) 來控制如何建置。

5.1. 繪製 Docbook 為其他格式

從單一個 DocBook 原始檔可以產生各種不同類型的輸出,想要輸出的類型可用 FORMATS 變數來設定。已知的格式清單列在 KNOWN_FORMATS 中:

% cd ~/doc/en_US.ISO8859-1/books/handbook
% make -V KNOWN_FORMATS
表格 5.1. 常見輸出格式
FORMATS檔案類型說明
htmlHTML,單檔單一 book.htmlarticle.html
html-splitHTML,多檔多個 HTML 檔案,每個章或節一個檔案,供一般網站使用。
pdfPDF可攜的文件格式

預設輸出的格式會依文件而有所不同,但同常是 html-split。其他格式可設定 FORMATS 為特定值來選擇。在 FORMATS 設定所需格式的清單可一次輸出多個格式。

範例 5.1. 建置單頁 HTML 輸出檔
% cd ~/doc/en_US.ISO8859-1/books/handbook
% make FORMATS=html

範例 5.2. 建置分頁 HTML 及 PDF 輸出檔
% cd ~/doc/en_US.ISO8859-1/books/handbook
% make FORMATS="html-split pdf"

本文及其他文件,可由此下載: ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/

若有 FreeBSD 方面疑問,請先閱讀 FreeBSD 相關文件,如不能解決的話,再洽詢 <questions@FreeBSD.org>。

關於本文件的問題,請洽詢 <doc@FreeBSD.org>。