跳转到内容

使用维基教科书/如何构建维基教科书

来自维基教科书,开放世界开放书籍


精心策划的书籍比没有经过精心策划的书籍更有可能取得成功。 甚至在你开始写作之前,你应该记下一些关于你想要书籍的内容,它应该涵盖哪些材料,以及它将以什么顺序涵盖这些材料。

在你开始写作之前,你的书籍应该有一个定义。 目标受众是谁? 范围? 深度? 书籍将使用什么语言? 本项目的所有书籍,英语维基教科书,都需要用英语书写。 但是,作者可以控制他们是否想要在书籍中使用英式英语或美式英语。 一旦书籍确定了一种方言,书籍中的所有页面都应该使用该方言,以帮助保持书籍的统一性。 一些作者甚至可能选择使用英语的另一种子集,例如 e-prime 或 BE-850。 这是作者在写作之前应该决定的问题。

为你的书籍创建一个大纲,无论是这里在维基教科书上,还是在纸上,甚至是在你的脑海中。 相信我们,你现在的计划越多,你的书籍在将来就越好。 以后不得不重构书籍通常是一个漫长而艰难的过程,涉及页面移动和大量编辑来修复链接。 尽你最大的努力第一次就把事情做好,你的努力将得到回报。

标题和命名规范

[编辑 | 编辑源代码]

我们有一个命名策略,它试图以标准的方式保持维基教科书上的所有书籍和书籍页面井井有条。 所有书籍页面都应该以书籍名称作为前缀,后面跟着一个斜杠,后面跟着页面名称。 例如,“我的书/我的页面”是正确的,“我的页面”是不正确的。 还要记住,其他类型的分隔符是不可接受的。 例如,以下是不允许的命名书籍中页面的方式

My Book:My Page
My Book - My Page
My Book > My Page
My Book My Page

特定维基教科书的作者通常会在本地风格手册中描述他们喜欢的结构。

你可以决定是让书籍结构“扁平”还是“深度”。 两种方式都没有官方偏好。 我们将在下面描述这两种结构

扁平结构

[编辑 | 编辑源代码]

如果书籍采用扁平结构(没有章节),则每个页面应以以下方式命名

  • 书籍标题/页面名称

在这种结构中,每个页面都距离书籍主页面一级。 这使得页面之间的链接更容易,但也意味着你的书籍中的每个页面都必须具有唯一的页面名称。

深度结构

[编辑 | 编辑源代码]

如果书籍采用深度或“层次化”结构(页面属于章节),则每个页面应以以下方式命名

Book_Title/Chapter_Name
Book_Title/Chapter_Name/Page_Name

所有页面都属于一个章节,并且页面名称只需要对章节唯一,而不需要对整本书唯一。 这是组织书籍的一种很好的逻辑方式,但是维护章节页面可能很繁琐,而且链接需要更长,这可能不受一些编辑的欢迎。

设计模式

[编辑 | 编辑源代码]

正在开发的书籍不会完全成形,也不会以完美的书籍形状出现。 创建书籍的过程会导致书籍呈现出许多形式,这些形式本身在维基教科书上是不可接受的。 但是,只要进展持续,书籍的各个阶段不仅可以在短期内被接受,而且还可以成为书籍作者的有效工具。

书籍是大型项目,通常无法想象作者能够以线性方式一次完成一个页面地写作。 事实上,应该假设大多数作者只是维基教科书上的临时成员,他们随时可能放弃他们在这里的工作。

考虑到这一点,希望看到书籍长期成功的作者应该在开发书籍的同时,尽量最大限度地提高未来作者接手的能力,以防原始作者突然离开。 书籍应该从一个明确的计划开始,例如目录大纲。 从大纲开始,页面应该进展到几种中间形式之一。 这些中间形式允许书籍快速增加大小和信息内容,而无需过多地担心组织或格式。 在书籍在这些中间形式之一中扩展到很大程度之后,编辑、修订者和审阅者可以润色书籍,使其变得更好,并最终使其成为特色书籍。 允许其他作者快速轻松地接手原始作者遗留工作的书籍的一般设计模式是

大纲 → 中间形式 → 书籍 → 特色书籍

关于中间形式的警告

[编辑 | 编辑源代码]

请注意,中间形式不被认为是稳定的,甚至不被认为是可接受的书籍。 如果一个处于中间形式的书籍长期被遗弃,它有很高的风险被删除。 存根在维基教科书上比较容忍,我们社区的很大一部分会抵制删除它们,除非它们处于特别糟糕的状态。 巨型百科全书违反政策,除非跨维基将显著改善维基百科上的内容(这不太可能),否则巨型百科全书可以很快被删除。 类似课程的书籍比巨型百科全书更容忍,但如果你不注意它们,它们仍然有被跨维基到维基教科书的风险。

简而言之,稍微违反我们关于内容和结构的一些规则可以帮助书籍快速增长。 但是,这些被打破的规则在长期内是不可接受的。 只要书籍正在积极编辑,并且作者意识到它需要及时改进其形式和结构,维基教科书上的编辑会容忍它。

下面我们将讨论各种中间形式,以及如何将它们发展成符合政策的书籍。

存根是一个页面,或者几个页面,只包含少量入门文本。 这些入门文本通常可以解释页面将要涵盖的内容,并提供少量介绍性文本,其他作者可以帮助扩展。 一个“好的存根”应该

  1. 清楚地解释页面将要涵盖的内容
  2. 提供对主题的简要介绍
  3. 提供一个组织框架(例如命名标题),以帮助显示信息应该放在哪里。

不包含这些信息的存根很可能对未来的作者来说是一种阻碍,而不是一种帮助,因此很可能应该被删除。

要扩展存根,主要有两个选择

  1. 添加更多内容,就像在内容转储中一样,或者像在巨型百科全书中一样导入它。
  2. 通过创建大纲添加更多结构。

内容转储

[编辑 | 编辑源代码]

内容转储是指将大量材料以无序的方式添加到页面中。 这对于快速增加书籍的大小非常有用,但是如果要长期保留在维基教科书上,内容需要进行组织、排序和整理。 许多使用这种方法的书籍变得庞大:单个大型页面上有很多材料。 要扩展这些书籍,应该将它们分成子页面,赋予一个适当的目录,并进行适当的组织。

大纲不一定是草稿,因为它们不需要包含任何内容。 大纲是计划和准备书籍的好方法,但一个由原作者长期放弃的独立大纲通常没有帮助或价值。 大纲可以帮助作者开始写作。 它们不利于吸引新作者的兴趣。 如果你写了一个大纲,但没有时间继续工作,它可能会被删除。

书籍的大纲阶段应该简短。 大纲应该尽快填充至少基本数量的内容,以便未来的作者和编辑有一些原始材料可以参考。 编辑需要内容来修复和塑造。 作者需要明确的指示,说明内容应该放置在何处以及如何改进。

要扩展大纲,应该在列表中的每个页面上添加内容,解释页面应该涵盖的内容。 然后,每个页面都可以按照给定的指南单独扩展。

宏百科

[编辑 | 编辑源代码]

维基教科书上的页面可以使用从维基百科导入的文章进行填充。 这可以是利用现有主题信息并使用现有免费材料快速扩展书籍的好方法。 在未来的作者能够以有意义的方式开始贡献类似书籍的内容之前,宏百科需要进行广泛的格式化删除(去维基化)。 这是因为维基百科通常使用比维基教科书更密集的格式化风格。

要扩展宏百科,你需要删除维基百科特有的格式和模板,并开始将材料转换为说明性叙述。

在学校课程的进展过程中,信息可以随着课堂上的接收而写入书籍。 诸如讲义、阅读笔记、作业及其解答以及通过课程接收到的其他信息,可以在学习时上传。 与课程相关的材料不需要像维基百科文章那样进行格式化删除,但它们通常需要进行大量的重构、组织和编辑。

要扩展与课程相关的书籍,材料需要扩展到简单的笔记之外,变成叙事散文。 它还需要以逻辑的方式进行组织,因为许多课程并不总是以线性方式进行主题内容的处理。

[编辑 | 编辑源代码]

链接列表是比大纲更高级的一种形式。 链接列表是链接到其他书籍、其他维基(例如维基共享资源、维基百科或维基文库)或其他可以获取有关该主题信息的网站的集合。 链接列表可以帮助组织资源并找到导入原始材料的地方,但它们也很危险。 链接列表、“链接农场”或目录违反了政策,如果它们没有迅速发展,很可能会被删除。 如果你想维护一个供自己使用的资源列表,通常最好将其放在自己的用户空间中,因为许多此类内容政策不适用。

要扩展链接列表,请访问每个链接,从中收集信息,并将其带到维基教科书。 一旦你将必要的信息带到这里(例如在内容转储中),你就可以删除该列表,将其移动到引用中,或将其添加到单独的参考书目页面。

页面标题和导航模板

[编辑 | 编辑源代码]

使用模板是将书籍中的所有页面链接在一起,并维护页面之间统一风格的最简单方法之一。 一些常见模板位于页面顶部(页面标题模板)和页面底部(页面页脚)。 这些模板通常提供指向目录的链接,并且通常还包含指向上一页和下一页的链接。

← 将书籍捐赠给维基教科书 · 使用维基教科书 · 架子、类别和分类 →

华夏公益教科书