7.0 KiB
7.0 KiB
🍥Fuwari
แม่แบบสำหรับเว็บบล็อกแบบ static สร้างด้วย Astro
🖥️ ตัวอย่างการใช้งานจริง (Vercel)
✨ คุณสมบัติ
- สร้างด้วย Astro และ Tailwind CSS
- มีอนิเมชั่นและการเปลี่ยนหน้าอย่างลื่นไหล
- โหมดสว่าง / โหมดมืด
- ปรับแต่งสีธีมและแบนเนอร์ได้
- Responsive design (หน้าตาเว็บปรับเปลี่ยนตามขนาดจอ)
- ฟังก์ชันการค้นหา ขับเคลื่อนด้วย Pagefind
- คุณสมบัติเพิ่มเติมสำหรับมาร์กดาวน์
- สารบัญ
- RSS feed
🚀 เริ่มต้นใช้งาน
- สร้าง repository ใหม่สำหรับบล็อกของคุณ:
- Generate repository ใหม่ ขึ้นมาจากแม่แบบนี้ หรือจะ fork repository นี้ก็ได้
- หรือจะสร้างโดยการเลือกรันคำสั่งต่อไปนี้ คำสั่งใดคำสั่งหนึ่ง:
npm create fuwari@latest yarn create fuwari pnpm create fuwari@latest bun create fuwari@latest deno run -A npm:create-fuwari@latest
- เริ่มแก้ไขบล็อกของคุณแบบ local โดยการ clone repository ของคุณ (จากข้อ 1) ไว้ในเครื่องของคุณ แล้วรันคำสั่ง
pnpm installเพื่อติดตั้ง dependencies ที่จำเป็น- ติดตั้ง pnpm ด้วยคำสั่ง
npm install -g pnpmก่อน ถ้ายังไม่เคยติดตั้ง
- ติดตั้ง pnpm ด้วยคำสั่ง
- แก้ไขไฟล์การตั้งค่า
src/config.tsเพื่อปรับแต่งบล็อกของคุณ - รันคำสั่ง
pnpm new-post <filename>เพื่อสร้างโพสต์ใหม่ในsrc/content/posts/และแก้ไขไฟล์โพสต์นั้นๆ ให้สมบูรณ์ - Deploy เว็บบล็อกของคุณไปยัง Vercel, Netlify, GitHub Pages หรือบริการอื่นๆ โดยอ้างอิงวิธีการจากคู่มือนี้ อย่าลืมแก้ไขการตั้งค่าเว็บไซต์ในไฟล์
astro.config.mjsก่อนที่คุณจะ deploy เว็บ
📝 Frontmatter (ส่วนหัวไฟล์) ของโพสต์
---
title: โพสต์แรกของฉัน
published: 2023-09-09
description: นี่คือโพสต์แรกของเว็บบล็อก Astro อันใหม่ของฉัน
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
lang: jp # เขียนค่านี้เมื่อภาษาของโพสต์นั้นๆ แตกต่างจากภาษาของเว็บไซต์ที่ตั้งค่าไว้ใน `config.ts` เท่านั้น
---
🧩 Markdown Extended Syntax
เดิมที Astro มีการสนับสนุนภาษามาร์กดาวน์แบบของ GitHub ไว้อยู่แล้ว แต่ Fuwari ได้เพิ่มเติมคุณสมบัติพิเศษอื่นๆ เข้าไปอีก:
- Admonitions หรือ กล่องข้อมูลพิเศษ (ดูตัวอย่างและการใช้งาน)
- การ์ด GitHub Repository (ดูตัวอย่างและการใช้งาน)
- บล็อกโค้ดขั้นสูง ด้วย Expressive Code (ดูตัวอย่าง / เอกสารประกอบ)
⚡ คำสั่ง
คำสั่งที่รันได้ใน terminal จาก root ของโปรเจกต์:
| คำสั่ง | การทำงาน |
|---|---|
pnpm install |
ติดตั้ง dependencies |
pnpm dev |
เปิดเซิร์ฟเวอร์สำหรับการพัฒนาแบบ local ที่ localhost:4321 |
pnpm build |
Build เว็บไซต์สำหรับใช้งานจริงไปยังโฟลเดอร์ ./dist/ |
pnpm preview |
ดูตัวอย่าง build ของคุณแบบ local ก่อนที่จะ deploy จริง |
pnpm check |
ดำเนินการตรวจสอบหาข้อผิดพลาดในโค้ดของคุณ |
pnpm format |
จัดรูปแบบโค้ดของคุณด้วย Biome |
pnpm new-post <filename> |
สร้างโพสต์ใหม่ |
pnpm astro ... |
รันคำสั่ง CLI เช่น astro add, astro check |
pnpm astro --help |
แสดงวิธีใช้งาน Astro CLI |
✏️ การมีส่วนร่วม
กรุณาอ่าน แนวทางการมีส่วนร่วม สำหรับรายละเอียดวิธีการมีส่วนร่วมในโปรเจกต์นี้
📄 สัญญาอนุญาต
โปรเจกต์นี้เผยแพร่ภายใต้สัญญาอนุญาตแบบ MIT License
