幫助:本地風格手冊
與維基百科或維基詞典不同——維基百科和維基詞典本質上是具有單一風格手冊的非常大的書籍——華夏公益教科書上的個別書籍可以根據主題的需要和作者的偏好以截然不同的風格編寫。
- 有一個通用的 Wikibooks:Manual of Style,在為新書編寫本地風格手冊之前應閱讀此手冊。
- 強烈建議在開始之前或作為 使用者頁面子頁面 建立草稿時考慮 書籍結構。
- 如果書籍應該具有獨特的重複 風格元素,例如練習或軼事的方框,這些元素應該作為 模板 提供,並在本地風格手冊中列出並解釋。
- 如果書籍應該具有 內容分組 或 導航 的策略,則應在本地風格手冊中解釋該策略。
- 如果書籍應該對建立進一步的 藝術作品或圖片 具有特定要求,則應在本地風格手冊中提及。
- 如果許多作者參與的書籍,如果一些作者就某種 寫作風格 達成一致,而其他作者沒有遵循該風格,就會變得不一致。應在本地風格手冊中描述特定的寫作風格。
- 旨在遵循某種教學方法的書籍可能需要來自貢獻編輯的特殊考慮。應在本地風格手冊中詳細解釋教學方法。
目的
華夏公益教科書通常是許多貢獻者的作品,為了為使用者提供一致的體驗,維護單一的“聲音”和風格,這在使用作品時變得至關重要。這在它成為合作的負擔和工作整體質量的決定性因素之前應該考慮的東西。
雖然 Wikibooks:Manual of Style 有幾個適用於所有書籍的提示,但每本華夏公益教科書通常都有自己的本地風格手冊,試圖描述所需的“聲音”並解釋如何使用僅適用於該書籍的特定於書籍的模板和其他有用的工具。
語言
只要有可能,書籍應該嘗試對所有英語使用者保持中立,並且不依賴於特定於某個地區的習慣用語或語言。書籍需要一致使用語言,因此,在它們發展的某個階段,需要做出決定,即書籍將依賴於英式英語還是美式英語,或者是否使用這兩種語言的簡單子集(例如兒童的小字,簡單英語,或 E-Prime 等等)。
基本結構
扁平結構(書籍/章節)
扁平結構通常更受歡迎,因為它更容易保持組織和連結。“扁平”意味著只有一級子頁面(書籍/第 1 章,書籍/第 2 章)。
- 優點
- 允許在書籍內部以及從其他書籍和專案中輕鬆連結。
- 從主頁面,可以使用
[[/Chapter/]]連結到章節。 - 在書籍中,可以使用
[[../Chaptername/]]互連章節,而不是使用完整標題。 - 從其他書籍和專案,如果只需要輸入一個變數,例如
{{See also [[Book/{{1}}]]}}等等,模板會簡單得多。
- 從主頁面,可以使用
- 缺點
- 頁面頂部的自動標題僅指向主書籍頁面,而不是指向節標題。
深度結構(書籍/章節/子章節/子子章節/等等)
深度結構具有更強的內在組織。“深度”意味著存在多個子頁面級別(書籍/第 1 章,書籍/第 1 章/第 2 節,書籍/第 2 章/第 5 節/第 9 頁)。
- 優點
- 組織結構是“內建”的,因此子章節自動連結到主章節,從而更便於在書籍中導航。
- 缺點
- 章節、其他書籍和其他專案之間的連結可能會變得更加繁瑣。
- 更改書籍中章節的位置比對主書籍頁面進行一次編輯要困難。參見 Meta: Accidental linking and hard-wired category schemes。
- 打印出來時看起來不像“整潔”。
示例
命名規範
使用“本章名稱”,“節名稱”
大多數書籍(無論是在華夏公益教科書上還是印刷出版)都將所有單詞大寫,除了冠詞和介詞。
- 優點
- 打印出來時看起來更好,因為它遵循大多數出版書籍的標準。
- 缺點
- 連結可能更難。
使用“章節名稱”,“節名稱”
一些書籍(無論是在華夏公益教科書上還是印刷出版)只將書籍和章節標題的第一個字母大寫。
- 優點
- 更熟悉的“維基”式命名方式,如維基百科中所建立的那樣。
- 缺點
- 不符合正常的書籍出版風格。
示例
頁面長度限制
限制頁面長度
一些書籍可能對頁面長度有限制(例如,維基百科人試圖限制文章的頁面長度)。根據 MediaWiki 軟體的定義,每個頁面的絕對限制為 2,097,152 位元組(2,048 kB)。
- 優點
- 限制頁面長度將使使用者更容易下載連線速度較慢的章節。
- 對頁面長度設定一個任意限制可能有助於使整本書的感覺更加一致。
- 缺點
- 可能會導致不必要的任意章節斷裂。
模板
使用模板建立每一章或頁面,通常有助於建立一致的結構。模板可以使用標題、資訊框和其他功能建立大綱,使每一章都與其他章節相似。
- 優點
- 使整本書的感覺更加一致。
- 修改模板比手動編輯每一頁都要快得多。
- 缺點
- 可能存在限制。
- 使新貢獻者更難上手。
所有章節都遵循一個模板?
有些書籍可能會從使用標準化的章節模板中獲益。
- 優點
- 更容易確保每一章都遵循相同的格式。
- 缺點
- 根據模板的不同,可能難以在頁面之間建立多樣性。
- 使新貢獻者更難上手。
不同型別的章節使用不同的模板?
有些書籍可能對不同型別的頁面使用不同的模板。例如,食譜對食譜、食材等使用不同的模板。
- 優點
- 允許針對討論一般主題型別的頁面建立更個性化的(但一致的)樣式。
- 缺點
- 可能會使新貢獻者難以習慣這本書。
複雜模板?
一些非常有用且吸引人的模板可以使用解析器函式建立。
- 優點
- 吸引人且靈活。
- 缺點
- 對於沒有經驗的作者來說很難使用。
示例
維基連結
只使用書內管道連結?
將連結限制在書籍的章節內,使書籍“自包含”。
- 優點
- 將書籍保持在一起,無需依賴外部資源。
- 缺點
- 需要為每個術語建立一個新頁面。
使用跨專案連結?
使用方括號內的字首可以在維基媒體專案之間建立連結。w: 指向維基百科,wikt: 指向維基詞典,等等。
- 優點
- 允許輕鬆解釋術語。
- 缺點
- 使書籍依賴於其他專案。如果進行了這種連結,作者應定期檢查以確保目標頁面沒有被移動。
受限連結?
書籍可能僅在某些情況下使用維基連結,例如,當連結到的資訊遠遠超出了書籍的範圍時。
許多書籍將書外連結限制在每頁的“進一步閱讀”部分。有些甚至更進一步,將書外連結限制在唯一的“參考書目和資源”頁面。
- 優點
- 使書籍相對自包含,因此即使書籍被印刷或使用者沒有網際網路連線,它仍然有用。
- 缺點
- 頁面或章節末尾的連結不如包含在書籍文字本身中的連結容易找到。
導航
使用導航模板?
可以使用導航模板建立索引、目錄或其他書籍功能。
- 優點
- 使用模板建立專業級別的導航功能比重新發明輪子更容易。
- 缺點
- 使新貢獻者更難上手。
使用索引?
索引是一個詳細的列表,通常按字母順序排列,包含書籍中的特定資訊。
- 優點
- 讀者更容易找到他們想要的資訊。
- 缺點
- 索引必須根據書籍中的資訊進行編譯,並在新增或刪除內容時進行維護。
圖片
維基百科中使用的圖片儲存在檔案:名稱空間中,可以儲存在維基百科或維基共享資源中,維基共享資源是一個獨立但密切相關的維基。
合理使用
“合理使用”圖片是受版權保護的作品,根據美國法律,在某些情況下可以被使用。這些圖片儲存在維基百科中,每個使用都必須有法律上的正當理由。
- 優點
- 如果合理使用圖片對書籍不可接受,則允許使用更多圖片。
- 缺點
- 這是一個法律灰色地帶,尤其影響從美國以外訪問維基百科的人,因為使用此類資料可能違反當地法律。
僅限維基共享資源?
維基共享資源託管的媒體要麼屬於公共領域,要麼由版權持有人授權,任何人都可以免費使用。
- 優點
- 透過僅使用維基共享資源上的圖片,更容易轉維基書籍(例如,如果德國維基百科想要製作翻譯,他們可以複製它,而無需為每一張圖片提供法律上的正當理由)。
- 這些圖片通常在維基共享資源的畫廊和類別中進行組織,這有助於找到與書籍相關的或更好的圖片。
- 缺點
- 維基共享資源不允許使用合理使用圖片。
使用縮圖?
縮圖是圖片的小版本,可以透過點選展開。
- 優點
- 允許在頁面上放置許多圖片,而不會佔用太多空間或頻寬。
- 缺點
- 縮圖通常太小,在印刷版本中沒有用。
類別
對所有書籍章節使用一個類別?
- 優點
- 將整本書“集中在一個地方”,方便跟蹤頁面。
- 缺點
- 由於 MediaWiki 軟體的限制,類別一次最多顯示 200 個相同型別的頁面,並在每個組之間進行連結。對於包含 200 多頁面的大型書籍來說,這可能是一個限制,因為連結指向前面的和/或後面的組。可以使用類似 {{CategoryTOC}} 的模板來緩解這種情況,以簡化類別內的導航。
在書籍中使用子類別?
- 優點
- 有助於將特定書籍的相關部分歸類在一起。
- 缺點
- 難以一次看到所有章節。
數學公式
數學、科學和工程類書架上的許多書籍都包含數學公式,並使用特殊符號來顯示數學概念。當使用此類公式或符號時,它們應在整本書中保持一致。例如,一些書籍的 LMOS 建議使用 2+3i 向量符號,而其他書籍的 LMOS 建議使用 2+3j 向量符號。
印刷版
書籍可以有一個或多個可列印版本,並且可以包含 PDF 版本,以便於閱讀和下載。印刷版應使用頁面轉包,以便主書籍頁面上的所有更新自動反映在印刷版文字中。應定期更新 PDF 版本,以保持與主書籍頁面的 consistency。
有一些專門的模板和神奇字詞可用於印刷版和 PDF 版本。例如,印刷版可以使用 __NOTOC__ 來抑制書籍中自動生成的目錄 (TOC)。這樣,印刷版就可以生成自己的 TOC。