维基教科书:维基计划 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 清理 - 将此模板放置在所有不良模块及其讨论页顶部。