C++ 程式設計 Wikibook 約定
除非此處另有說明,否則作為一般規則,Wikibooks:風格手冊中的所有指南均有效。
以下約定是 C++ 程式設計書籍的本地風格手冊,旨在為專案提供穩定性和一致性。
我們使用Wikibooks:命名策略中描述的“斜槓約定”。
建議:絕不 有爭議 --Panic (討論) 2010年7月27日 (UTC) 10:32 已更改:基於實際設定 --Panic (討論) 2010年7月27日 (UTC) 10:32
有兩個索引:一個章節版本和一個全部內容版本(透過轉錄)。新頁面應同時列在C++ 程式設計/所有章節[ 編輯 ]索引和C++ 程式設計索引中。
從主頁面索引的章節應在一個頁面上。但是,單個頁面大小不應超過約 30k。較大的頁面應拆分。
透過新增內容,幫助我們為本書提供一些結構,為此,請儘可能建立更多不同的獨立章節/部分和子部分,使用獨特的(如果可行)專門主題,以便讓讀者對語言有最完整和邏輯的理解,您還可以新增空的章節/部分,以便未來的貢獻者可以新增內容。
每個對本書進行非瑣碎更改的人員都可以在作者部分新增自己。這可以透過新增您的姓名/別名幷包含到您的維基媒體頁面、網頁或可聯絡的活動電子郵件地址的連結來完成。
建議:2005年9月19日 投票:2005年9月21日 移至採納:--Panic 2006年1月17日 (UTC) 04:24
我們使用一級標題(=標題=)表示各個部分。為了允許轉錄,主要子模組應始終以最多一個二級標題(==標題==)開頭。
建議:2005年9月20日 無爭議,移至採納:--Panic 2006年1月17日 (UTC) 04:24
為了允許從其他來源採用,本書中的程式碼示例沒有強制的大括號/縮排風格。但是,請在一個示例中保持一致。
沒有采用單一的風格標準(例如:大括號風格),以便於更輕鬆地匯入任何其他程式碼片段,它也向讀者展示了他們可以做出的所有選擇,因此您可以使用您喜歡的風格並修改本書中任何現有的程式碼,但作者無需遵循特定的風格。
應在整本書中指出常見的程式設計錯誤。
建議:2005年9月18日 無爭議,移至採納:--Panic 2006年1月17日 (UTC) 04:24
{{NOTE|使用模板作為通知,向讀者提供額外/非標準/常見做法的通知。}}
建議:2004年11月27日 無爭議,移至採納:--Panic 2006年1月17日 (UTC) 04:24
{{TODO|文字中應該包含TODO框,告知讀者此處需要填寫內容。|C++ 程式設計}} :可以新增使用者名稱的附加引數。(自定義待辦事項列表)
建議:2005年9月18日 未引起爭議,移至採納:--Panic 2006年1月17日 (UTC)04:24
為保持一致性,應儘可能使用美式英語。
建議:--Panic 2008年7月31日 (UTC)02:20 未引起爭議,移至採納:--Panic (討論) 2008年8月10日 (UTC)06:03
應優先使用連字元(即如果可能就使用)。連字元旨在幫助理解。
建議:--Panic 2009年8月21日 (UTC)19:11 未引起爭議,移至採納:--Panic (討論) 2010年6月20日 (UTC)01:07
如果一個建議的問題在7天內未被質疑、爭論或修改,則應將其從建議部分移至採納部分。
建議:--Panic 2006年1月17日 (UTC)05:02 未引起爭議,移至採納:--Panic 2006年3月4日 (UTC)03:48
本書將只包含一個印刷版本,該版本可能包含按章節劃分的子部分。
建議:--Panic 2008年4月10日 (UTC)00:05 未引起爭議,移至採納:--Panic (討論) 2008年7月19日 (UTC)17:18
封面將顯示書籍的歷史索引,並且對封面進行任何重大更改(>51%)都必須經過之前的討論,並最終達成無異議接受。
建議:--Panic 2008年4月10日 (UTC)00:19 未引起爭議,移至採納:--Panic (討論) 2008年7月19日 (UTC)17:23
