維基百科:模板樣式

  此頁面介紹的是模板樣式指引。關於模板樣式的使用方法，請見「幫助:模板樣式」。

模板樣式（TemplateStyles）是允許非管理員用戶寫入和管理模板的CSS樣式的功能。

規範

基本規範

1. 模板樣式頁應和特定模板或某系列模板有關，且應被特定模板或某一系列模板引用
2. 孤立的模板樣式頁應使用WP:CSD#G15快速刪除
3. 樣式必須只會影響到關聯模板的輸出。
   • 說明：如果添加模板到頁面時，卻會影響不相關部分的顯示樣式，這將導致頁面顯示混亂。

命名規範

1. 模板樣式頁應置於特定模板的子頁面，並以style或style-功能命名
   • 例如應使用Template:MyTemplate/styles.css或Template:MyTemplate/styles-foo.css而不是Template:Styles.css或Template:Foo.css
   • 說明：這方便於辨識及編輯樣式頁。
2. 如需要單獨的模板樣式頁需先取得共識，並由管理員建立，例如Template:Hello.css
   • 說明：例如共享的CSS
3. 可能廣泛應用到所有模板的模板樣式應置於Template:ShareCSS的子頁面
4. 進行模板樣式測試的沙盒應置於子頁面，如Template:Foo/sandbox.css。

內容規範

1. CSS中定義的規則或類別應以關聯模板名稱作為前綴命名
   • 例如.row的樣式規則在模板樣式頁中應使用.myTemplate-row；同理tr應使用.myTemplate tr來定義規則。
   • 說明：模板名稱基本上不會重複，以關聯模板名稱作為前綴命名可以避免引用到條目時有CSS規則名稱衝突問題
2. 樣式頁使用的選擇器和類別名稱應該是唯一的，並以使用ASCII字元為主，避免使用中文。
   • 如需使用中文（如模板名稱有中文）應使用漢語拼音拼出其音作為名稱
   • 說明：這減少了CSS規則發生衝突的可能性。
3. 背景圖片只能使用無需署名的圖片（例如公有領域），不能使用合理使用的圖片，即便用於條目時有符合合理使用也不能。
   • 說明：一般使用圖片的情況下，能夠點擊圖片連到檔案說明頁查看姓名標示或版權協議。但使用在背景的圖片將無法這麼做。
4. 不建議使用!important。
   • 說明：使用!important將導致用戶自訂CSS難以甚至無法覆蓋模板樣式。
5. 不建議使用#id-styles。
   • 說明：HTML ID應該在頁面上是唯一的，但模板通常不會在一個頁面只被引用一次，即使是單一用途的模板也可能有無法預期的使用方式，因此推薦使用類別而不是ID來作為樣式選擇器。

其他規範

1. 主頁面移動時也應移動相應的模板樣式頁，
   • 例如Template:1移動到Template:2那麼若有Template:1/2.css也要移動到Template:2/2.css
2. 樣式頁的保護層級應該和模板一致。
   • 說明：如果模板是高風險模板，那麼樣式頁也會是高風險的。

     如果模板不是高風險模板而沒有被保護，那麼破壞模板本身就能夠造成混亂。

     如果樣式頁的保護層級比模板高，因為模板頁能夠編輯，將會促使編輯者於在模板頁添加行內樣式。

3. 禁止在簽名中加入任何模板樣式

   更多資訊：WP:SIG § TLCSS

   • 說明：當在簽名中使用模板樣式時，當模板樣式變更時可能會改變之前或已存檔的簽名