本章內容涵蓋了說明文件建置流程以及如何使用 make(1) 來控制如何建置。
從單一個 DocBook 原始檔可以產生各種不同類型的輸出,想要輸出的類型可用 FORMATS
變數來設定。已知的格式清單列在 KNOWN_FORMATS
中:
%
cd ~/doc/en_US.ISO8859-1/books/handbook
%
make -V KNOWN_FORMATS
FORMATS 值 | 檔案類型 | 說明 |
---|---|---|
html | HTML,單檔 | 單一 book.html 或 article.html 。 |
html-split | HTML,多檔 | 多個 HTML 檔案,每個章或節一個檔案,供一般網站使用。 |
pdf | 可攜的文件格式 |
預設輸出的格式會依文件而有所不同,但同常是 html-split
。其他格式可設定 FORMATS
為特定值來選擇。在 FORMATS
設定所需格式的清單可一次輸出多個格式。
%
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>。