Dev Trail

เจ้าของผลงานเล่าไว้แบบนี้

https://misternay.github.io/basic-knowledge-sdlc/ # Dev Trail เว็บทบทวนความรู้สำหรับนักพัฒนา 14 หัวข้อ อ่านให้เข้าใจ ลองตอบคำถาม ทำแบบฝึกหัด และทำบททดสอบแบบจับเวลา ไม่มี login ไม่มีฐานข้อมูล ไม่เก็บคะแนน เนื้อหาทั้งหมดเป็นไฟล์ JSON ใน repo นี้ ## เริ่มใช้งานบนเครื่อง ```bash npm install npm run dev # เปิด http://localhost:5173 npm run check:content # ตรวจไฟล์เนื้อหาทั้งหมด npm test # ตรวจเนื้อหา + แบบฝึกหัด + ตัวแปลง Markdown npm run build # ตรวจเนื้อหาแล้ว build ลง dist/ ``` ต้องใช้ Node 20 ขึ้นไป (แนะนำ 24) ## ขึ้น GitHub Pages 1. สร้าง repo บน GitHub แล้ว push โค้ดนี้ขึ้น branch `main` 2. ที่ repo ไปที่ **Settings → Pages → Build and deployment → Source** เลือก **GitHub Actions** 3. ทุกครั้งที่ push ขึ้น `main` workflow `.github/workflows/deploy.yml` จะตรวจเนื้อหา รันเทสต์ build แล้ว deploy เว็บจะอยู่ที่ `https://<username>.github.io/<repo>/` Pull request จะถูกตรวจเหมือนกันแต่ไม่ deploy ไฟล์เนื้อหาที่ผิดรูปแบบจึงไม่มีทางขึ้นเว็บ ## โครงสร้าง ``` content/ topics/<id>.json เนื้อหาแต่ละหัวข้อ (หรือ .md ก็ได้) tracks.json 4 เส้นทาง exams.json ชนิดบททดสอบ AUTHORING.md กติกาการเขียนเนื้อหา scripts/check-content.mjs src/ lib/validate.js ตัวตรวจเนื้อหา ใช้ร่วมกันทั้งหน้านำเข้าและตอน build lib/markdown.js แปลง Markdown เป็น topic lib/checks.js ตรวจคำตอบแบบฝึกหัด components/ หน้าต่าง ๆ ของแอป tests/ ``` ## เพิ่มหรือแก้เนื้อหา - **แก้ไฟล์ตรง ๆ:** แก้ `content/topics/<id>.json` แล้วรัน `npm run check:content` - **

โดย misternay · ดูโพสต์ต้นทาง