為何需要規範
網頁專案若缺乏統一規範,容易造成命名混亂、維護困難與風格不一致。以下整理常見的製作規範,供團隊協作與個人專案參考。
1. 文件命名規範
- 名稱應簡潔、易理解,避免過長或無意義。
- 目錄通常需有一個預設首頁,例如 index.html。
- 檔案名稱建議使用小寫英文、數字與底線。
- 同類檔案可使用編號,例如 news_001.html。
2. 圖片命名規範
圖片名稱可由「類型 + 含義」組成,例如:
- banner_home.jpg
- logo_company.png
- menu_about.png
- icon_arrow.png
若有多狀態圖片,可使用 _on、_off 或 _hover 等後綴區分。
3. 目錄結構規範
- 根目錄放置首頁與必要設定檔。
- images 或 assets 存放圖片資源。
- css 存放樣式表。
- js 存放腳本。
- 各主要欄目可建立獨立目錄。
4. 尺寸與版面規範
版面尺寸可依專案需求調整,但應保持一致。常見做法包括:
- 以主要解析度為設計基準。
- 內容區寬度固定或採用響應式設計。
- Banner、圖示與縮圖使用統一尺寸。
- 避免單頁過長,必要時分段或分頁。
5. HTML head 區塊規範
head 中建議包含:
- 字元集宣告。
- 頁面標題。
- CSS 外部樣式連結。
- 必要時加入 meta description、author、robots 等。
例如:
<meta charset="UTF-8" />
<title>網站名稱</title>
<link href="css/style.css" rel="stylesheet" />
6. CSS 撰寫規範
- 優先使用外部樣式表。
- 保留、偽類與自定義樣式可依區塊分類。
- 避免過深選擇器與過多 !important。
- 命名清楚,方便他人理解。
7. 導航與連結規範
- 導覽層級不宜過深。
- 連結文字應清楚描述目標。
- 目前位置應有標示。
- 長頁面可加入回頂部或頁內錨點。
8. 內容與品質規範
- 標題簡潔明確。
- 段落清楚,避免錯字。
- 圖片應有 alt 文字。
- 外部資源引用需注意授權與連結有效性。
結語
規範的目的不是限制創意,而是讓協作更順暢、維護更簡單、使用者體驗更一致。專案開始前先建立共識,後續會省下大量溝通與修正成本。