Add Makefile and switch README to make workflow
- Add Makefile with help/setup/pack/serve targets (PORT overridable) - README: document make setup / make serve / make pack instead of raw ./setup.sh and python http.server commands
This commit is contained in:
1 parent
dd27606d43
commit
38c7cc27c1
2 files changed
+35
-13
No files matched your search
@@ -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)
|
||||
@@ -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`
|
||||
|
||||
Reference in new issue
Block a user