Skip to content

Repository files navigation

Python for Developers

โปรเจกต์หนังสือพื้นฐานภาษา Python ออนไลน์สำหรับ Developer สร้างด้วย Astro, Starlight และ Tailwind CSS 4

สถานะปัจจุบัน: เตรียมหลักสูตร Language Fundamentals 6 ภาค 24 บท และโครง User Management Core แล้ว แต่ยังไม่ได้เริ่มเขียนเนื้อหาแต่ละบท

สิ่งที่เตรียมไว้แล้ว

  • หน้าแรกและ identity ของหนังสือ Python
  • หน้าสารบัญ ลำดับบท และหน้าโครงของแต่ละบท
  • โครงโปรเจกต์ท้ายเล่ม User Management Core แบบ CLI และ in-memory
  • ระบบ navigation, search และ light/dark theme
  • Tailwind CSS 4 และฟอนต์ภาษาไทย
  • หน้า 404, sitemap และ social preview
  • GitHub Actions สำหรับ deploy ไปยัง GitHub Pages

ความต้องการของระบบ

  • Node.js 22.12.0 ขึ้นไป
  • npm 9.6.5 ขึ้นไป

เริ่มใช้งาน

npm install
npm run dev

เว็บไซต์สำหรับพัฒนาจะแสดงที่ http://localhost:4321/

โครงสร้างเนื้อหา

src/content/docs/
├── index.mdx
├── chapters/
│   ├── index.md
│   ├── 01-platform/
│   ├── 02-language/
│   ├── 03-type-design/
│   ├── 04-data/
│   ├── 05-production/
│   └── 06-next-level/
└── about.md

ไฟล์บททั้งหมดมี frontmatter และลำดับ navigation พร้อมแล้ว สามารถเริ่มเขียนเนื้อหาใต้ frontmatter ของแต่ละไฟล์ได้ทันที

คำสั่ง

คำสั่ง การทำงาน
npm run dev เปิด development server
npm run check ตรวจ type และไฟล์ Astro
npm run build ตรวจโค้ดและสร้าง production build
npm run preview เปิดดู production build

GitHub Pages

เมื่อสร้าง repository และ push ไป branch main workflow จะ build และ deploy เว็บไซต์โดยอัตโนมัติ ค่า site และ base จะอ่านจาก GITHUB_REPOSITORY จึงรองรับทั้ง GitHub project site และ user site

สำหรับ custom domain หรือการ build นอก GitHub สามารถกำหนดค่าได้ด้วย:

  • SITE_URL เช่น https://example.com
  • BASE_PATH เช่น /python-fundamentals-for-developers หรือ /

License

MIT © Premix Labs

About

Online Python fundamentals book for developers

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages