Book: 结构化文档

book 内容类型适合建立结构化的、多页面的超文本，例如站点资源指南、手册、常见问题 (FAQ) 等， 它允许文档有章、节、小节等。book 可以协作完成，当然不是必须的。 有相应权限的作者可以添加或者编辑一个 book 的页面，也可以排列或者重新排序存在的文档。

Book 在每个页面的底部拥有额外的导航元素，可以通过文本、前一页、 向上 和 下一页 链接进行移动。 前一页 和 下一页 链接显示的是 book 中前后节点的标题。 另外一个导航方式是启用 手册导航 区块。

用户还可以选择 book 页面底部的 打印版本 链接来生成一个包含当前页面及其下属所有页面的对打印机友好的显示。

管理员可以查看 book 的轮廓，在那里它还可以改变节的标题及其 权重 (用于对节重新排序)。 在这个轮廓中，同时还允许编辑和/或删除 book 页面。 包括页面(page)在内的许多内容类型 (如 blog 文章、新闻、投票等) 都可以通过查看该文章时选择 轮廓 标签加入到一个 book 当中。

你可以:

  • 建立新的 book 页面: 建立内容 >> 手册页面。

  • 管理某个 book (从列表选择一个 book): 管理 >> 内容 >> 手册。

  • 在 管理 >> 设置 >> 内容类型 >> 手册页面设置工作流和其他全局 book 设置。

  • 启用手册导航区块: 管理 >> 区块。

  • 在 管理 >> 访问控制控制谁可以建立、编辑和维护 book 页面。

用协作书写的手册来维护 FAQ

协作手册让你在站点轻易地组织一个常见问题 (FAQ)。最主要的益处是你不需要自己撰写所有的问题/答案 - 让社区帮你完成！

为了设置一个 FAQ，你必须建立一个新的手册，用以组织所有的相关内容，步骤如下：

  1. 单击 建立内容 >> 手册页面
  2. 输入一个贴切的标题，象 “神奇水滴之旅 - FAQ” 就相当不错。
  3. 将 上层 设置为 <顶层> 表示这是新手册的起始页面。
  4. 将手册页面的文本内容输入到 正文 区域。
  5. 暂时将 日志信息 留空。
  6. 使用权重来定位这个手册在 book 模块页面列表的位置。

在你提交这个手册页面后，你已经准备好添加常见问题了。

为你的 FAQ 建立新的页面。 在你的 FAQ 建立新的页面的过程类似上面的步骤，不过在 上层 选项中，要选择刚才建立好的 FAQ 手册页面。

将存在的非手册页面加入 FAQ。 你随时都可以将一个文章加入到你的 FAQ：

  1. 在该文章的顶部单击 轮廓 标签。
  2. 通过选择 上层 将文章放到相应的手册中。

注意:

  • 手册是相当有弹性的，他们可以有 管理员HOWTO、 最终用户HOWTO 等章节，随着你对 book 模块了解的深入，你可以重新组织手册内的文章使得他们更有条理。

  • 任何文章相对应的评论，在你将该文章加入手册后，评论也跟着被转换过去。 这是一个很棒的特性，因为大量的群众的智慧通过评论分享。 记住所有此后的评论及其修改均自动反映到你的手册中。

  • 你可能希望在将文章加入你的 FAQ 时编辑它的标题，因为清晰明了的标题能极大地提升可导航性。

  • 手册页面可以来自任何的内容类型 (blog 文章、新闻稿件、静态页面等)。 如果你要直接建立手册页面，那么可以使用 建立内容 >> 手册页面 链接。

  • 如果你没有看见 编辑 链接或 轮廓 标签，那么你可能是没有足够的 权限。

定制手册导航菜单

默认情况下，手册的导航菜单区块只出现在手册相关的页面-换句话说是在手册顶层页面 (www.example.com/books/book-name) 及其子页面 (www.example.com/books/book-name/child-page)。 这是因为该区块中的代码不是一个实际的菜单- 它只是模拟一个菜单，因此它绝不会出现在 ..admin/menu 页面。

这意味着你不能让手册导航区块永久出现在首页 (假如你使用 book 模块建立一个静态的层次结构的话) 或者其他任何非手册页面。

这看起来是一个不小的局限，不过幸运的是我们可以使用 代码片断 来建立手册导航菜单，这样就可以让它出现在任何需要的地方，而不仅仅是手册页面。