Knowledge Base Wiki

Search for LIMS content across all our Wiki Knowledge Bases.

Type a search term to find related articles by LIMS subject matter experts gathered from the most trusted and dynamic collaboration tools in the laboratory informatics industry.

模板样式(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. 禁止在簽名中加入任何模板樣式
    • 說明:當在簽名中使用模板樣式時,當模板樣式變更時可能會改變之前或已存檔的簽名