FreeBSD 文件計畫入門書

FreeBSD 文件計劃

修訂: 48972
版權
2016-06-21 01:19:43Z 由 kevlo.
摘要

感謝您參與 FreeBSD 文件計劃,您的點滴貢獻,都相當寶貴。

本入手書內容包括:如何開始著手貢獻FreeBSD 文件計劃 (簡稱: FDP )的各項細節,以及會用到的一些工具、軟體 ,以及文件計畫的宗旨。

本入門書仍在持續撰寫中。任何修正或新增內容的建議都非常歡迎。

[ 章節模式 / 完整模式 ]

內容目錄
1. Shell 提示符號(Prompts)
2. 書中所用的編排風格
3. 注意、技巧、重要訊息、警告、與範例的運用。
4. 感謝
1. 概論
1.1. FreeBSD 文件組
1.2. 快速上手
2. 工具
2.1. 必備工具
2.2. 輔助工具
3. 工作副本
3.1. Documentation and Manual Pages
3.2. Choosing a Directory
3.3. Checking Out a Copy
3.4. Updating a Working Copy
3.5. Reverting Changes
3.6. Making a Diff
3.7. Subversion References
4. Documentation Directory Structure
4.1. The Top Level, doc/
4.2. The lang.encoding/ Directories
4.3. Document-Specific Information
5. The Documentation Build Process
5.1. Rendering DocBook into Output
5.2. The FreeBSD Documentation Build Toolset
5.3. Understanding Makefiles in the Documentation Tree
5.4. FreeBSD Documentation Project Make Includes
6. 網站
6.1. 環境變數
6.2. Building and Installing the Web Pages
7. XML Primer
7.1. 概論
7.2. Elements, Tags, and Attributes
7.3. The DOCTYPE Declaration
7.4. Escaping Back to XML
7.5. Comments
7.6. Entities
7.7. Using Entities to Include Files
7.8. Marked Sections
7.9. Conclusion
8. XHTML Markup
8.1. Introduction
8.2. Formal Public Identifier (FPI)
8.3. Sectional Elements
8.4. Block Elements
8.5. In-line Elements
9. DocBook Markup
9.1. Introduction
9.2. FreeBSD Extensions
9.3. Formal Public Identifier (FPI)
9.4. Document Structure
9.5. Block Elements
9.6. In-line Elements
9.7. Images
9.8. Links
10. Style Sheets
10.1. CSS
11. 翻譯
12. PO 翻譯
12.1. Introduction
12.2. 快速上手
12.3. 建立新翻譯
12.4. Translating
12.5. Tips for Translators
12.6. 編譯翻譯的文件
12.7. 提交新翻譯
13. 寫作風格
13.1. 叮嚀
13.2. Guidelines
13.3. 風格指南
13.4. 詞彙表
14. Editor Configuration
14.1. Vim
14.2. Emacs
14.3. nano
15. See Also
15.1. FreeBSD 文件計劃
15.2. XML
15.3. HTML
15.4. DocBook
A. 舉例
A.1. DocBook book
A.2. DocBook article
索引
附表目錄
5.1. Common Output Formats
12.1. 語系名稱
範例目錄
1. 一個範例
5.1. Build a Single HTML Output File
5.2. Build HTML-Split and PDF Output Files
6.1. Build the Full Web Site and All Documents
6.2. Build Only the Web Site in English
6.3. Build and Install the Web Site
7.1. Using an Element (Start and End Tags)
7.2. Using an Element Without Content
7.3. Elements Within Elements; em
7.4. Using an Element with an Attribute
7.5. Single Quotes Around Attributes
7.6. XML Generic Comment
7.7. Erroneous XML Comments
7.8. Defining General Entities
7.9. Defining Parameter Entities
7.10. Using General Entities to Include Files
7.11. Using Parameter Entities to Include Files
7.12. Structure of a Marked Section
7.13. Using a CDATA Marked Section
7.14. Using INCLUDE and IGNORE in Marked Sections
7.15. Using a Parameter Entity to Control a Marked Section
8.1. Normal XHTML Document Structure
8.2. h1, h2, and Other Header Tags
8.3. p Example
8.4. blockquote Example
8.5. ul and ol Example
8.6. Definition Lists with dl
8.7. pre Example
8.8. Simple Use of table
8.9. Using rowspan
8.10. Using colspan
8.11. Using rowspan and colspan Together
8.12. em and strong Example
8.13. tt Example
8.14. Using <a href="...">
8.15. Creating an Anchor
8.16. Linking to a Named Part of a Different Document
8.17. Linking to a Named Part of the Same Document
9.1. Boilerplate book with info
9.2. Boilerplate article with info
9.3. A Simple Chapter
9.4. Empty Chapters
9.5. Sections in Chapters
9.6. para Example
9.7. blockquote Example
9.8. tip and important Example
9.9. example Source
9.10. Rendered example
9.11. itemizedlist and orderedlist Example
9.12. variablelist Example
9.13. procedure Example
9.14. programlisting Example
9.15. co and calloutlist Example
9.16. informaltable Example
9.17. Table with frame="none" Example
9.18. screen, prompt, and userinput Example
9.19. emphasis Example
9.20. acronym Example
9.21. quote Example
9.22. Keys, Mouse Buttons, and Combinations Example
9.23. Applications, Commands, and Options Example
9.24. filename Example
9.25. package Example
9.26. systemitem and Classes Example
9.27. uri Example
9.28. email with a Hyperlink Example
9.29. email Without a Hyperlink Example
9.30. buildtarget and varname Example
9.31. literal Example
9.32. replaceable Example
9.33. guibutton Example
9.34. errorname Example
9.35. xml:id on Chapters and Sections Example
9.36. xref Example
9.37. link to a FreeBSD Documentation Web Page Example
9.38. link to a FreeBSD Web Page Example
9.39. link to an External Web Page Example
12.1. Creating a Spanish Translation of the Porter's Handbook
12.2. 建立 PGP 金鑰文章的法語翻譯。
12.3. 翻譯 Porter 手冊到西班牙文
12.4. 保留 XML 標籤
12.5. Building the Spanish Porter's Handbook
12.6. NanoBSD 文章的西班牙文翻譯
12.7. Explaining-BSD 文章的韓文 UTF-8 翻譯
A.1. DocBook book
A.2. DocBook article

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

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

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