- 013 月
-
檔案名稱規範
1.頁面檔名規範
靜態頁面都是統一放在專案目錄底下,那要怎樣跟工程師來溝通檔案的歸類及檔名呢?所以在頁面檔名上,我們有一套命名的規則。命名規則分為四個部份:目錄名稱-主要名稱_屬性名稱(備註).副檔名。
- 最前面第一部份是目錄名稱,用-串接,如果檔案是在根目錄,這個部份可以省略。
- 第二部份是檔案的主要名稱或動作名稱 (index、list、add、upd、del)。
- 第三部份為檔案的屬性名稱 (frm、ok、success、failure)。
- 第四部份為備註用名稱,用來暗示同一支程式,但因應狀況而有不同表現之用,所以實際動態程式的檔名不會包含這部份。
除了第一部份以外,其他都用_串接。第五部份是副檔名一律用.html。而在實務操作上,若目錄名稱要以真正的目錄來呈現也是可以的,這樣在設計或套版時就要多注意相對路徑上的差異及替換,只要在專案一開始溝通好規則,並全部採用一致的設計風格即可。
2.圖片檔名規範
除了頁面檔名有規範外,圖檔我們也整理了一套命名規則:類別-區塊名-識別(編號)-版本.副檔名。類別是指這張圖是bg背景圖、icon、btn…等,區塊名則是搭配CSS Layout所命名的區塊名稱,識別則是指這張圖代表的意義、功能、header、content、footer這些,版本則以v1、v2…以此類推。如果是搭配JS模組的圖,則前面還會再加上JS模組的名稱。
圖檔有一個命名規範有幾個好處:- 檔案以名稱排序的話,這樣同一類別的圖檔會聚集在一起,這樣比較好找檔案。
- 搭配CSS Layout的命名方式,CSS會變得更容易理解及維護。
- 利於SEO的優化。
3.腳本檔名規範
目前腳本我們大致上是以jQuery函式庫為大宗,命名規則為:jquery.套件名.min.副檔名。盡量都用小寫,並以JSMin工具壓縮過(JSMin前最好先以JSLint驗證檢查一下腳本語法,以確保min後語法不會出狀況)。
Posted by admin Posted on 01 3 月
Post Comments 0