Chapter 2 工具

Table of Contents
2.1 必備工具
2.2 輔助工具

FDP 使用一堆工具來協助管理 FreeBSD 文件、轉換文件格式等等。 因此,若要進行 FDP 工作的話,必須要學會這些工具才行。

這些工具都可以用 Ports 或 Packages 來安裝,以節省許多安裝的工夫。

您必須安裝這些工具,才能使用接下來各章節會介紹到的例子。 這些工具的用法,會在後續相關章節談到。

建議安裝 textproc/docproj: 裝了 textproc/docproj 可以更省時省力,它是個 組合型的 port(meta-port),本身並非軟體,只是將一些常用工具組合起來而已。 裝了這個 port 之後,『應該』就會自動下載、安裝本章所會介紹到的工具了。 若要處理中文的話,建議再裝 chinese/docproj 會比較好。

在這些 packages 當中,你可能會需要使用 JadeTeX 這個 macro 設定, 一旦選擇使用該 macro 的話,它會接著去裝 TeX。由於 TeX 算是個蠻大的套件, 除非你需要輸出 Postscript 或 PDF 格式,否則就不必裝了。

所以請考慮是否要節省編譯時間、硬碟空間,以判定要不要裝 JadeTeX (以及 TeX) 了。若要一併裝起來的話:

# make JADETEX=yes install

或是,不裝的話:

# make JADETEX=no install

或者,也可以選擇 textproc/docproj-jadetex 或是 textproc/docproj-nojadetex 這兩個之一來裝, 它們都是已事先設定 JADETEX 變數的 slave ports, 都一樣會裝 docproj 差別僅在於有沒有 JadeTeX 而已。 請注意:若只要輸出 HTML 或 ASCII 格式文件,那就不用裝 JadeTeX, 而若要輸出 PostScript、PDF 格式,就需要裝 TeX 才行。

2.1 必備工具

2.1.1 軟體

這些都是在進行 FreeeBSD 文件計劃時所會需要用上的工具程式, 而且可以用來轉換文件為 HTML、plain text以及 RTF 格式。這些相關套件在 textproc/docproj 都已經全部收錄了。

Jade (textproc/jade)

DSSSL 規格的實作程式,可用來把標記語言的文件(marked up)轉換為其他格式,像是:HTML 及 TeX

Tidy (www/tidy)

HTML “pretty printer”,可用來把自動產生的 HTML 內容整理得更易閱讀、以便日後維護。

Links (www/links)

文字操作模式的 WWW 瀏覽器(browser)可以把 HTML 檔轉為 plain text 格式。

peps (graphics/peps)

文件中有些圖是存成 EPS 格式的,這些必須要轉為 PNG 格式, 才能讓一般瀏覽器可以正常觀看。

2.1.2 DTD 及 Entity

由於 FDP 有用到許多 DTD 跟 Entity,因此在開工前,要裝上這些才行。

HTML DTD (textproc/html)

HTML 是用於 WWW 的標記語言,且也是 FreeBSD 網頁所使用的格式。

DocBook DTD (textproc/docbook)

DocBook 是專門用來製作技術文件的標示語言版本, FreeBSD 全部文件都是以 DocBook 所寫成的。

ISO 8879 entities (textproc/iso8879)

在 ISO 8879:1986 之中有 19 個 entity 被許多 DTD 所大量使用, 包括了數學符號、拉丁字母符號(尖重音等音節符號也是)以及希臘符號。

2.1.3 樣式表(Stylesheets)

這些樣式表都是用來轉換、重排文件的螢幕顯示、列印等效果處理

Modular DocBook 樣式表 (textproc/dsssl-docbook-modular)

Modular DocBook 樣式表,是用來把 DocBook 的標記語言文件轉換為其他格式,像是: HTML 或 RTF。

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

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