From 297db1384c4c8bf197e2a13960a3869d5a2379c8 Mon Sep 17 00:00:00 2001 From: twystpaki <50775957+twystpaki@users.noreply.github.com> Date: Tue, 8 Jul 2025 10:32:02 +0700 Subject: [PATCH] docs: update Thai README to match the main README (#545) --- docs/README.th.md | 99 +++++++++++++++++++++++------------------------ 1 file changed, 48 insertions(+), 51 deletions(-) diff --git a/docs/README.th.md b/docs/README.th.md index 0ed820ed..e8a215c3 100644 --- a/docs/README.th.md +++ b/docs/README.th.md @@ -10,54 +10,33 @@ - [x] สร้างด้วย [Astro](https://astro.build) และ [Tailwind CSS](https://tailwindcss.com) - [x] มีอนิเมชั่นและการเปลี่ยนหน้าอย่างลื่นไหล -- [x] รองรับโหมดสว่าง / โหมดมืด +- [x] โหมดสว่าง / โหมดมืด - [x] ปรับแต่งสีธีมและแบนเนอร์ได้ - [x] Responsive design (หน้าตาเว็บปรับเปลี่ยนตามขนาดจอ) -- [ ] การแสดงความคิดเห็น -- [x] การค้นหา -- [x] TOC (สารบัญ) +- [x] ฟังก์ชันการค้นหา ขับเคลื่อนด้วย [Pagefind](https://pagefind.app/) +- [x] [คุณสมบัติเพิ่มเติมสำหรับมาร์กดาวน์](https://github.com/saicaca/fuwari/blob/main/docs/README.th.md#-markdown-extended-syntax) +- [x] สารบัญ +- [x] RSS feed +## 🚀 เริ่มต้นใช้งาน -## จำเป็นต้อง - -- Node.js <= 22 -- pnpm <= 9 - -## 🚀 วิธีใช้งาน 1 - -เริ่มต้นโปรเจ็กต์ในเครื่องโดยใช้ [create-fuwari](https://github.com/L4Ph/create-fuwari) - -```sh -# npm -npm create fuwari@latest - -# yarn -yarn create fuwari - -# pnpm -pnpm create fuwari@latest - -# bun -bun create fuwari@latest - -# deno -deno run -A npm:create-fuwari@latest -``` - -1. แก้ไขไฟล์การตั้งค่า `src/config.ts` เพื่อปรับแต่งบล็อกของคุณ -2. รันคำสั่ง `pnpm new-post ` เพื่อสร้างโพสต์ใหม่ใน `src/content/posts/` และแก้ไขไฟล์โพสต์นั้นๆ ให้สมบูรณ์ -3. Deploy เว็บบล็อกของคุณไปยัง Vercel, Netlify, GitHub Pages หรือบริการอื่นๆ โดยอ้างอิงวิธีการจาก[คู่มือนี้](https://docs.astro.build/en/guides/deploy/) อย่าลืมแก้ไขการตั้งค่าเว็บไซต์ในไฟล์ `astro.config.mjs` ก่อนที่คุณจะ deploy เว็บ - -## 🚀 วิธีใช้งาน 2 - -1. [Generate repository ใหม่](https://github.com/saicaca/fuwari/generate)ขึ้นมาจากแม่แบบนี้ หรือจะ fork repository นี้ก็ได้ -2. เริ่มแก้ไขบล็อกของคุณแบบ local โดยการ clone repository ของคุณ (จากข้อ 1) ไว้ในเครื่องของคุณ แล้วรันคำสั่ง `pnpm install` และ `pnpm add sharp` เพื่อติดตั้ง dependencies ที่จำเป็น - - ติดตั้ง [pnpm](https://pnpm.io) ด้วยคำสั่ง `npm install -g pnpm` ถ้ายังไม่เคยติดตั้ง +1. สร้าง repository ใหม่สำหรับบล็อกของคุณ: + - [Generate repository ใหม่](https://github.com/saicaca/fuwari/generate) ขึ้นมาจากแม่แบบนี้ หรือจะ fork repository นี้ก็ได้ + - หรือจะสร้างโดยการเลือกรันคำสั่งต่อไปนี้ คำสั่งใดคำสั่งหนึ่ง: + ```sh + npm create fuwari@latest + yarn create fuwari + pnpm create fuwari@latest + bun create fuwari@latest + deno run -A npm:create-fuwari@latest + ``` +2. เริ่มแก้ไขบล็อกของคุณแบบ local โดยการ clone repository ของคุณ (จากข้อ 1) ไว้ในเครื่องของคุณ แล้วรันคำสั่ง `pnpm install` เพื่อติดตั้ง dependencies ที่จำเป็น + - ติดตั้ง [pnpm](https://pnpm.io) ด้วยคำสั่ง `npm install -g pnpm` ก่อน ถ้ายังไม่เคยติดตั้ง 3. แก้ไขไฟล์การตั้งค่า `src/config.ts` เพื่อปรับแต่งบล็อกของคุณ 4. รันคำสั่ง `pnpm new-post ` เพื่อสร้างโพสต์ใหม่ใน `src/content/posts/` และแก้ไขไฟล์โพสต์นั้นๆ ให้สมบูรณ์ 5. Deploy เว็บบล็อกของคุณไปยัง Vercel, Netlify, GitHub Pages หรือบริการอื่นๆ โดยอ้างอิงวิธีการจาก[คู่มือนี้](https://docs.astro.build/en/guides/deploy/) อย่าลืมแก้ไขการตั้งค่าเว็บไซต์ในไฟล์ `astro.config.mjs` ก่อนที่คุณจะ deploy เว็บ -## ⚙️ Frontmatter ของโพสต์ +## 📝 Frontmatter (ส่วนหัวไฟล์) ของโพสต์ ```yaml --- @@ -72,16 +51,34 @@ lang: jp # เขียนค่านี้เมื่อภาษาข --- ``` -## 🧞 คำสั่ง +## 🧩 Markdown Extended Syntax -คำสั่งที่รันได้ใน terminal จาก root ของโปรเจค: +เดิมที Astro มีการสนับสนุน[ภาษามาร์กดาวน์แบบของ GitHub](https://github.github.com/gfm/) ไว้อยู่แล้ว แต่ Fuwari ได้เพิ่มเติมคุณสมบัติพิเศษอื่นๆ เข้าไปอีก: -| คำสั่ง | ผลที่เกิด | -|:------------------------------------|:--------------------------------------------------| -| `pnpm install` และ `pnpm add sharp` | ติดตั้ง dependencies | -| `pnpm dev` | เปิดเซิร์ฟเวอร์เพื่อพัฒนาเว็บแบบ local ที่ `localhost:4321` | -| `pnpm build` | Build เว็บไซต์แบบพร้อมใช้งานจริงไปยังโฟลเดอร์ `./dist/` | -| `pnpm preview` | ดูตัวอย่าง build ของคุณแบบ local ก่อนที่จะ deploy จริง | -| `pnpm new-post ` | สร้างโพสต์ใหม่ | -| `pnpm astro ...` | รันคำสั่ง CLI เช่น `astro add`, `astro check` | -| `pnpm astro --help` | ดูข้อมูลเพิ่มเติมเกี่ยวกับ Astro CLI | +- Admonitions หรือ กล่องข้อมูลพิเศษ ([ดูตัวอย่างและการใช้งาน](https://fuwari.vercel.app/posts/markdown-extended/#admonitions)) +- การ์ด GitHub Repository ([ดูตัวอย่างและการใช้งาน](https://fuwari.vercel.app/posts/markdown-extended/#github-repository-cards)) +- บล็อกโค้ดขั้นสูง ด้วย Expressive Code ([ดูตัวอย่าง](https://fuwari.vercel.app/posts/expressive-code/) / [เอกสารประกอบ](https://expressive-code.com/)) + +## ⚡ คำสั่ง + +คำสั่งที่รันได้ใน 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 ` | สร้างโพสต์ใหม่ | +| `pnpm astro ...` | รันคำสั่ง CLI เช่น `astro add`, `astro check` | +| `pnpm astro --help` | แสดงวิธีใช้งาน Astro CLI | + +## ✏️ การมีส่วนร่วม + +กรุณาอ่าน [แนวทางการมีส่วนร่วม](https://github.com/saicaca/fuwari/blob/main/CONTRIBUTING.md) สำหรับรายละเอียดวิธีการมีส่วนร่วมในโปรเจกต์นี้ + +## 📄 สัญญาอนุญาต + +โปรเจกต์นี้เผยแพร่ภายใต้สัญญาอนุญาตแบบ MIT License