跳轉到內容

華夏公益教科書:命名約定

來自華夏公益教科書,開放的書籍,開放的世界

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

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

新書籍的命名約定

[編輯原始碼]

按照慣例,每個模組都與一本特定書籍相關聯。 相關聯的書籍構成了模組標題的第一部分(例如,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 的內部類別)。 所有其他模板和類別都保留用於華夏公益教科書本身、跨多個書籍使用或未來的書籍。

建議,但不是強制要求,影像和其他媒體的命名應遵循模組命名約定。 因此,這些頁面應遵循其相關書籍的約定。 這些頁面遵循命名約定的要求不如模組嚴格,因為它們通常位於後臺。

在許多情況下,這些頁面可能跨越多個書籍,在這種情況下,不必遵循這些約定。 與華夏公益教科書本身相關的頁面(例如政策頁面)同樣免除。

華夏公益教科書