FreeBSD 文件計畫入門書
前一頁 |  | 下一頁

# 章 1. 概論

歡迎參與 FreeBSD 文件計劃。維持優秀質量的文件對 FreeBSD 的成功來說十分重要， 而 FreeBSD 文件計劃(以下皆以 FDP 來代表 FreeBSD Documentation Project 的縮寫) 則與這些文件撰寫、更新息息相關，因此您的點滴貢獻都是十分寶貴的。

本文件最主要的目的，就是清楚告訴您：『FDP 的架構有哪些』、『如何撰寫並提交文件給 FDP』、 『如何有效運用工具來協助撰稿』。

我們歡迎每個熱心的志士來加入 FDP 行列。FDP 並不限定每月必須交出多少稿量，才能加入。 您唯一須要作的就是訂閱 FreeBSD documentation project 郵遞論壇 。

讀完本份文件，您將會：

- 瞭解有哪些文件是由 FDP 所維護的。

- 可以看懂 FDP 所維護的 SGML 原始文件。

- 知道如何來對文件作修改。

- 知道如何投稿自己的修改部份，並最後正式進入 FreeBSD 文件內。

# 1.1. FreeBSD 文件的組成部分

FDP 總共負責 FreeBSD 的 4 種類別的文件：

線上手冊(manual)

  英文版的系統 manual 並不是由 FDP 所撰寫的，因為它們是屬於 base system 的部份。 然而，FDP 可以(也曾這麼做過)修改這些文件，來讓這些文件寫得更清楚，甚至是勘正錯誤的地方。

  翻譯團隊負責將系統的線上手冊翻譯為不同的語言。 這些譯本都由 FDP 維護。

FAQ

  FAQ 主要是收集在各論壇或 newsgroup 會常問到或有可能會問到的 FreeBSD 相關問題與答案 。 (簡單講，就是『問答集』格式) 通常會擺在這裡面的問答格式，不會放太長的詳細內容。

使用手冊(Handbook)

  使用手冊主要是給 FreeBSD 使用者提供詳盡的線上參考資料。

Web site

  FreeBSD 主要各項介紹方面的 WWW 部份，歡迎逛逛 http://www.FreeBSD.org/ 以及許多其他 mirror 站。這網站是許多人第一次接觸 FreeBSD 的地方。

這四個文件組成部分都可透過 FreeBSD CVS tree 來取得。也就是說，這些文件的修改記錄對於任何人都是公開的， 而且無論是誰都可以用像是 CSup, CVSup 或 CTM 將文件取出來(checkout)並放在自己機器上做備份或副本參考等用途。

此外，許多人會寫些教學文件或維護有關 FreeBSD 內容的網站。(若作者同意的話)其中有些資料會保存在 FreeBSD 正式 CVS repository 內。而其他的文件，可能作者不希望被放在 FreeBSD repository 內而另存他處。 總之，FDP 會盡力提供這些文件的連結。

前一頁 | 內容 | 下一頁
感謝 |  | 在開工之前...

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

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