維基百科:模板樣式

模板樣式(TemplateStyles)是允許非管理員使用者寫入和管理模板的CSS樣式的功能。

規範

基本規範

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

命名規範

  1. 模板樣式頁應置於特定模板的子頁面,並以stylestyle-功能命名
    • 例如應使用Template:MyTemplate/styles.cssTemplate:MyTemplate/styles-foo.css而不是Template:Styles.cssTemplate: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. 禁止在簽名中加入任何模板樣式
    • 說明:當在簽名中使用模板樣式時,當模板樣式變更時可能會改變之前或已存檔的簽名