章 1. 概論

內容目錄
1.1. FreeBSD 文件組
1.2. 快速上手

歡迎參與 FreeBSD 文件計劃( 簡稱 FDP ) 。維持優秀質量的文件對 FreeBSD 的成功來說十分重要,您的點滴貢獻都是十分寶貴的。

本文件描述:『 FDP 的架構有哪些』、『如何撰寫並提交文件』、 『如何有效運用工具來協助撰稿』。

歡迎大家對 FDP 做出貢獻。唯一的成員要求就有貢獻的意願。

本入門書指出如何:

1.1. FreeBSD 文件組

FDP 負責四類 FreeBSD 文件

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

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

  • 線上手冊 ( manual pages ):英文版的系統 manual 並不是由 FDP 所撰寫的,因為它們是屬於 base system 的部份。 然而,FDP 可以修改這些文件,來讓這些文件寫得更清楚,甚至是勘正錯誤的地方。

  • 網站: 這是 FreeBSD 在網路上的主要部份,位於 http://www.FreeBSD.org/ 以及許多其他 mirror 站。這網站是許多人第一次接觸 FreeBSD 的地方

翻譯團隊負責翻譯使用手冊和網站到不同的語言。線上手冊目前並未翻譯

FreeBSD 網站、使用手冊、和 FAQ 的文件原始碼可以在 https://svn.FreeBSD.org/doc/ 的文件庫取得。

線上手冊的原始碼則是在 https://svn.FreeBSD.org/base/ 的原始碼庫可以取得。

文件提交訊息可以用 svn log 察看。 提交訊息也會保存在http://lists.FreeBSD.org/mailman/listinfo/svn-doc-all

這些儲存庫的網頁版位於https://svnweb.FreeBSD.org/doc/https://svnweb.FreeBSD.org/base/

許多人會寫 FreeBSD 的教學文件或是 how-to 文章。有些保存在 FDP 的檔案中。其他一些文件則是作者希望放在他處。FDP 會盡力提供這些文件的連結。

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

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

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