FreeBSD 文件計畫入門書
Prev |  | Next

# Chapter 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。

Prev | Home | Next
快速上手篇 |  | 輔助工具

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

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