diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..45c1ae3 --- /dev/null +++ b/Makefile @@ -0,0 +1,24 @@ +# ============================================================ +# AT Transit mockup — Makefile +# เรียกดูคำสั่งทั้งหมด: make help +# ============================================================ + +PORT ?= 8090 + +.PHONY: help setup pack serve + +help: ## แสดงรายการคำสั่งทั้งหมด + @echo "AT Transit mockup — คำสั่งที่มี:" + @echo " make setup แตก resource/images.zip → .image/ (ครั้งแรกหลัง clone)" + @echo " make pack re-zip .image/ → resource/images.zip (หลังแก้รูป)" + @echo " make serve รัน static server ที่ http://localhost:$(PORT)/ui/index.html" + @echo " make serve PORT=8080 เปลี่ยน port ตามต้องการ" + +setup: ## แตกไฟล์รูปภาพ (ครั้งแรกหลัง clone) + ./setup.sh + +pack: ## re-zip ไฟล์รูปภาพ (หลังแก้รูป) + ./setup.sh pack + +serve: ## รัน static server + python3 -m http.server $(PORT) diff --git a/README.md b/README.md index 33e8b96..8c31bd3 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ Static HTML mockup / ดีไซน์ต้นแบบเว็บข้อ ``` web-at-transit-mock/ ├── maintheme.png ← ภาพธีม/ดีไซน์ต้นแบบ +├── Makefile ← คำสั่งรวม (make setup / pack / serve) ├── ui/ ← Single-page app (hash router) │ ├── index.html shell หน้าเดียว │ ├── router.js / i18n.js / pwa.js / sw.js @@ -17,16 +18,16 @@ web-at-transit-mock/ │ └── partials/ view ละ 1 ไฟล์ (router fetch + inject) ├── resource/ │ ├── data/ ← ข้อมูล mock: routes.json, schedules.json, stations.json, ... -│ └── images.zip ← ★ รูปทั้งหมด (บีบไว้ — แตกด้วย setup.sh) -└── .image/ ← รูปทั้งหมด (hidden — เกิดหลังรัน setup.sh, ไม่ commit) +│ └── images.zip ← ★ รูปทั้งหมด (บีบไว้ — แตกด้วย make setup) +└── .image/ ← รูปทั้งหมด (hidden — เกิดหลัง make setup, ไม่ commit) ``` ## วิธี run ```bash cd web-at-transit-mock -./setup.sh # 1. แตก resource/images.zip → .image/ (ครั้งเดียว) -python3 -m http.server 8090 # 2. รัน static server +make setup # 1. แตก resource/images.zip → .image/ (ครั้งเดียว) +make serve # 2. รัน static server (Ctrl+C เพื่อหยุด) ``` แล้วเปิดเบราว์เซอร์ที่: @@ -35,28 +36,25 @@ python3 -m http.server 8090 # 2. รัน static server http://localhost:8090/ui/index.html ``` +ดูคำสั่งทั้งหมด: `make help` + ### เงื่อนไขสำคัญ -1. **ต้องรัน `./setup.sh` ก่อน** — ไม่งั้นรูปพังทั้งหน้า (relative path `../.image/...` หาไฟล์ไม่เจอ) +1. **ต้องรัน `make setup` ก่อน** — ไม่งั้นรูปพังทั้งหน้า (relative path `../.image/...` หาไฟล์ไม่เจอ) 2. **ต้อง serve จาก root ของ repo** (ไม่ใช่จาก `ui/`) — รูปและข้อมูลอ้างอิงด้วย relative path 3. **ห้ามเปิด `file://`** — fetch JSON + relative path จะใช้ไม่ได้ ต้องผ่าน static server เสมอ -4. เปลี่ยน port ได้โดยแก้เลข `8090` (เช่น `python3 -m http.server 8080`) +4. เปลี่ยน port ได้ด้วย `make serve PORT=8080` ## การจัดการรูปภาพ (images) รูปทั้งหมด (~31MB) อยู่ใน folder hidden `.image/` (ถูก `.gitignore` → ไม่ push ขึ้น git) โดยแจกผ่านไฟล์เดียว `resource/images.zip`: -- **แตกไฟล์ (ครั้งแรกหลัง clone)**: - - ```bash - ./setup.sh - ``` - +- **แตกไฟล์ (ครั้งแรกหลัง clone)**: `make setup` - **เพิ่ม/เปลี่ยนรูป**: แก้ไฟล์ใน `.image/` แล้ว re-zip: ```bash - ./setup.sh pack + make pack ``` แล้ว commit `resource/images.zip`