跳轉到內容

華夏公益教科書:命名規範

來自華夏公益教科書
(重定向自 Wikibooks:NC)

由於華夏公益教科書包含許多書籍,因此諸如“目錄”之類的頁面可能經常出現,而無法明確它們屬於哪本書。 因此,為了幫助區分屬於一本特定書籍的頁面和屬於另一本特定書籍的頁面,必須使用一系列命名約定。

強烈建議不遵循這些約定的現有華夏公益教科書適當地移動其頁面,以使其符合這些約定。

新書籍的命名規範

[編輯原始碼]

按照慣例,每個模組都與一本書相關聯。 相關聯的書籍構成了模組標題的第一部分(例如,Cookbook:RiceCookbook 的一部分)。 因此,這些書籍以分層方式排列。

目前,對於新書籍,只允許兩種命名約定集,建議一本書只符合兩種約定之一。 允許但並不推薦一本書混合使用兩種約定。

一般指南

[編輯原始碼]
  • 不要在標題中縮寫書籍名稱 - 例如,屬於 How To Build A Computer 的模組應該始終以“How To Build A Computer”開頭,並且絕不在其中使用縮寫形式,例如“HTBAC”。
  • 在整個過程中使用描述性標題 - 僅僅因為一個頁面完全在書籍的範圍內並不意味著標題可以超出第一層級而變得通用。 建議所有級別的標題都應該很好地暗示模組的內容。

子頁面約定

[編輯原始碼]

建議對於新書籍使用子頁面約定。

子頁面約定,其中標題以 [[Name/Section]] 的形式給出,利用了 MediaWiki 的子頁面功能來自動建立分層結構。 因此,書籍層次結構中的頁面將自動連結回書籍的主頁(使用諸如“__NOTOC__”之類的標籤)。 這對於任何具有線性或樹狀結構並且範圍狹窄、定義明確的書籍來說都很方便。

使用子頁面約定的書籍示例

名稱空間約定

[編輯原始碼]

名稱空間約定,其中標題以 [[Name:Section]] 的形式給出,其標題類似於 MediaWiki 中的名稱空間,標題的各個部分由冒號分隔。 這最適合具有更通用圖狀結構的書籍,或者如果書籍涵蓋更廣泛、定義不明確的範圍(例如,Cookbook)。 但是,預設情況下不會提供到書籍主頁面上的回溯連結,必須手動將其寫入到每個頁面上。 當然,這允許靈活地建立和編寫這些回溯連結。

請注意,華夏公益教科書將其 快捷方式 保留為“WB”,將其 Wikimedia 的跨維基約定保留為“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 的內部類別)。 所有其他模板和類別都為華夏公益教科書本身、跨多個書籍的使用或將來的書籍保留。

建議但不是必需的,影像和其他媒體應根據模組命名約定命名。 因此,這些頁面應遵循其相關聯書籍的約定。 與模組相比,這些頁面符合命名約定的要求較不嚴格,因為它們通常駐留在後臺。

在許多情況下,這些頁面可能跨越多個書籍,在這種情況下,不必遵循這些約定。 與華夏公益教科書本身相關的頁面(如政策頁面)也類似地不受此限制。

華夏公益教科書