華夏公益教科書:維基計劃 Macintosh/指南

語氣

Mac 書籍是為擁有少量到中等計算機經驗的使用者編寫的，他們可能是在家裡或大型網路的客戶端。因此，Mac 書籍應該力求輕便和輕鬆。語言的使用方式應該使閱讀 Mac 書籍本身成為一種有趣的活動。笑話應該微妙且不過度使用。最重要的是，任何事情都不應該以犧牲清晰度為代價。讀者應該能夠在通讀一遍書籍後吸收所有內容。將關鍵概念從一個部分重複到另一個部分（可能在括號中），作為提醒。

語言規範

為了保持一致性，請遵循以下語言規範

• 在所有 Mac 華夏公益教科書中使用美式拼寫。
• 使用序列逗號。
• 避免使用省略號 (...) 來結束句子。

結構

Mac 華夏公益教科書的組織“樹”如下所示

• 主頁
  • 部分（可選）
    • 章節、附錄和詞彙表
      • 子章節（可選）

將每個子章節巢狀在比它“更大”的章節中。

關於部分的一句話

部分僅用於涵蓋應用程式套件的書籍。這些書籍不會在主頁上鍊接到章節，而是連結到部分。每個部分都像一本獨立的書籍，包含引言和連結到該部分自身章節和附錄的目錄。

使用“部分”的書籍的一個完美示例是 iLife 書籍。每個應用程式都有自己的部分，因此也有自己的目錄和詞彙表。這極大地簡化了 iLife 書籍的瀏覽。

關於子章節的一句話

子章節會使事情複雜化。如果可能，避免使用它們，但如果一個章節在一個頁面上變得過於龐大和難以處理（例如，解釋 Mac OS X Tiger 中每個應用程式的章節），則可以將它們加入。請不要在子章節中再巢狀子章節。

主頁

每個華夏公益教科書都必須有一個主頁。這從引言部分開始。引言按以下順序排列

1. 關於華夏公益教科書中描述的產品的部分
2. 關於華夏公益教科書本身的部分，解釋了它對新使用者的意義以及華夏公益教科書涵蓋的內容和未涵蓋的內容

   * 包括強制性的“假設了解 Mac OS X Tiger 訊息”。

3. 關於如何使用華夏公益教科書的部分

   * 選單命令和檔案的巢狀（如果願意，可以從另一個華夏公益教科書中逐字複製）

   * 對容易混淆的相似詞語（例如，視窗與Windows）和可互換詞語（例如，應用程式與程式）的澄清

   * 解釋華夏公益教科書中使用的每種資訊框或其他特殊模板。

主頁的第二部分必須是目錄，包含指向所有章節、附錄和詞彙表的連結。編寫目錄程式碼可能很令人困惑。請嚴格遵循以下格式

# [[Chapter 1]] {{stage short}}
#: Chapter 1 description
# [[Chapter 2]] {{stage short}}
#: Chapter 2 description
# [[Chapter 3]] {{stage short}}
#: Chapter 3 description
# Appendices
#:* [[Appendix A]] {{stage short}}
#:*: Appendix A description
#:* [[Appendix B]] {{stage short}}
#:*: Appendix B description 
# [[Glossary]] {{stage short}}
#: Glossary description

有關完美目錄的示例，請參閱 Mac OS X Tiger 華夏公益教科書。

禁止廣告！

提及應用程式（免費軟體、共享軟體、開源軟體或正版軟體）、硬體品牌或網站是合法且有幫助的，但這本華夏公益教科書不應該是廣告的平臺，它包含的任何教程也不應該依賴於非蘋果產品。

書籍，而不是百科全書

請記住，Mac 華夏公益教科書是書籍，而不是百科全書。保持輕鬆的語氣。這本華夏公益教科書應該是 Mac OS X 使用者的最佳朋友，而不是枯燥的百科全書。

影像

在重要的地方插入彩色截圖、產品圖片和圖表。在必要時使用它們，但不要隨意使用，這樣頁面就可以透過撥號連線載入。還要確保截圖中不顯示任何“haxie”、主題等。保持螢幕整潔，讓普通使用者熟悉（例如，使用捆綁的蘋果桌布，不要過度自定義工具欄，也不要顯示任何替代圖示）。此外，在談論視窗或選單時，截圖不應包含其他內容。通常，全屏截圖的寬度應為 830 畫素。

截圖應居中（除非不切實際），始終以縮圖形式顯示，並以以下格式標記：“圖 1 - 這是一個標題，它很“枯燥”（不有趣或有趣），不包含說明”。

注意： 請檢視我們的影像目錄，其中包含一些您可以在寫作中使用的精美影像。

表格

在適當的情況下使用表格。

• 表格寬度應設定為 830 畫素
• 邊框應設定為 0
• 單元格填充應設定為 3
• 單元格應為 4D804D（深綠色）或 B5E3B5（淺綠色）
• 表格應以以下方式標記：“表 1. 這是一個簡單的標題”。

資訊框

在有意義的地方使用資訊框。使用以下模板

{{Mac Warning Box|Put Warning text here.}}

{{Mac Note Box|Put Note Text here.}}

{{Mac Trick Box|Put Trick Text here.}}

{{Mac Background Box|Put Background Text here.}}

維基計劃模板

這些模板應用於顯示與 Macintosh 維基計劃的關聯。

• 模板：WP Mac 模組 - 在所有模組的討論頁頂部使用此模板。
• 模板：WP Mac 清理 - 將此模板放置在所有不良模組及其討論頁頂部。