跳转到内容

维基教科书:命名约定

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

由于维基教科书包含许多书籍,因此诸如“目录”之类的页面可能经常导致无法确定其所属的书籍。 因此,为了帮助区分属于一本特定书籍的页面和属于另一本特定书籍的页面,必须使用一系列命名约定。

强烈建议不遵循这些约定的现有维基教科书适当地移动其页面,以符合这些约定。

新书籍的命名约定

[编辑源代码]

按照惯例,每个模块都与一本特定书籍相关联。 相关联的书籍构成了模块标题的第一部分(例如,Cookbook:RiceCookbook 的一部分)。 因此,书籍以分层方式排列。

目前,新书籍只允许使用两套约定,建议书籍只符合其中的一套。 允许书籍混合使用这两套约定,但不建议这样做。

一般准则

[编辑源代码]
  • 不要在标题中缩写书籍名称 - 例如,属于 How To Build A Computer 的模块始终应以“How To Build A Computer”开头,绝不缩写,例如“HTBAC”。
  • 在整个标题中使用描述性标题 - 仅仅因为一个页面完全在书籍范围内,并不意味着标题可以超出第一级而变得通用。 建议所有级别的标题都应该能够很好地提示模块的内容。

子页面约定

[编辑源代码]

子页面约定推荐用于新书。

子页面约定,其中标题以 [[Name/Section]] 格式给出,利用了 MediaWiki 的子页面功能自动创建分层结构。 因此,书籍层次结构中的一个页面将自动链接回书籍的主页(使用诸如“__NOTOC__”之类的标签)。 这对于任何具有线性或树状结构且范围狭窄且定义明确的书籍来说都很方便。

使用子页面约定的书籍示例

命名空间约定

[编辑源代码]

命名空间约定,其中标题以 [[Name:Section]] 格式给出,其标题类似于 MediaWiki 中的命名空间,标题的各个部分由冒号分隔。 这最适合具有更一般图状结构的书籍,或者如果书籍涵盖更广泛且定义不太明确的范围(例如,Cookbook)。 但是,默认情况下不会提供指向书籍主页面 的回链接,必须手动将其写入每个页面。 当然,这允许灵活地创建和编写这些回链接。

请注意,维基教科书保留使用“WB”作为其快捷方式,“Transwiki”作为维基媒体的跨维基约定,以及使用任何名为“bookshelf”的模块进行一般书籍组织。

使用命名空间约定的书籍示例

现有书籍的命名约定

[编辑源代码]

一般而言,书籍的命名约定应在整本书中执行,新添加的书籍必须遵循现有书籍的约定。 如果一本特定书籍不严格符合上述两种约定中的任何一种,建议将其修改为符合上述两种约定中的一种。 先前被认为可以接受但已不再使用的命名约定包括

  • 连字符约定:[[Name - Section]]
  • 消歧义约定:[[Section (Name)]],以维基百科用于其消歧义页面的约定命名
  • [[Name: Section]]
  • [[Name / Section]]
  • [[Section]],其中没有提及书籍名称

模板、类别、图像和其他媒体的命名约定

[编辑源代码]

对于每本名为 Book Title 的书籍,模板子空间 Template:Book Title 和类别子空间 Category:Book Title 预留给书籍内部使用(例如,Category:Wikibooks Pokédex:Normal PokémonWikibooks Pokédex 的内部类别)。 所有其他模板和类别都保留用于维基教科书本身、跨多个书籍使用或未来的书籍。

建议,但不是强制要求,图像和其他媒体的命名应遵循模块命名约定。 因此,这些页面应遵循其相关书籍的约定。 这些页面遵循命名约定的要求不如模块严格,因为它们通常位于后台。

在许多情况下,这些页面可能跨越多个书籍,在这种情况下,不必遵循这些约定。 与维基教科书本身相关的页面(例如政策页面)同样免除。

华夏公益教科书