เผยแพร่บทความไปยัง GitHub

เชื่อมต่อ GitHub เพียงครั้งเดียว คุณก็สามารถเผยแพร่บทความ Clevera ใดๆ ไปยังที่เก็บข้อมูลในรูปแบบไฟล์ Markdown เพื่อเตรียมพร้อมสำหรับเว็บไซต์เอกสาร, โฟลเดอร์สไตล์วิกิ docs/ หรือคอลเลกชัน README บทความนี้ครอบคลุมถึงการเชื่อมต่อ การเลือกที่เก็บข้อมูลและโฟลเดอร์ ลักษณะของไฟล์ และวิธีการทำงานของการอัปเดต

ก่อนที่คุณจะเริ่ม#

• แผนบริการ: การเผยแพร่ไปยัง GitHub เป็นส่วนหนึ่งของแผน Pro และ Custom สำหรับแผน Free และ Starter แท็บ เผยแพร่ จะแสดงข้อความ "การเผยแพร่ไปยังเครื่องมือของคุณรวมอยู่ในแผน Pro แล้ว" ดูที่ เลือกแผนบริการ
• บทบาทใน Clevera: เฉพาะเจ้าของพื้นที่ทำงานหรือผู้ดูแลระบบเท่านั้นที่สามารถเชื่อมต่อหรือยกเลิกการเชื่อมต่อ GitHub ได้ เมื่อเชื่อมต่อแล้ว ใครก็ตามที่สามารถแก้ไขบทความได้ก็สามารถเผยแพร่บทความนั้นได้
• การเข้าถึงใน GitHub: ผู้ที่ทำการเชื่อมต่อจำเป็นต้องมีสิทธิ์เขียน (write access) ในที่เก็บข้อมูลที่คุณต้องการเผยแพร่ และมีสิทธิ์ติดตั้ง GitHub App บนบัญชีส่วนตัวหรือองค์กรนั้น (หรือให้เจ้าขององค์กรเป็นผู้อนุมัติ)
• บทความ: คุณสามารถเผยแพร่บทความที่เป็นของวิดีโอหรือการบันทึกได้ โปรดสร้างบทความก่อน ดูที่ เปลี่ยนการบันทึกให้เป็นบทความ

การเผยแพร่ไม่ใช้เครดิต

เชื่อมต่อ GitHub#

1. เปิดการเชื่อมต่อ#

   ในแถบด้านข้าง ให้เปิดเมนูพื้นที่ทำงานและเลือก การเชื่อมต่อ ค้นหา GitHub ภายใต้ การเชื่อมต่อที่มีให้ใช้งาน (หรือแท็บ การพัฒนา) แล้วคลิก เชื่อมต่อ ปุ่มจะปรากฏขึ้นเมื่อคุณชี้เมาส์ไปที่การ์ด

   

2. ให้สิทธิ์ Clevera บน GitHub#

   GitHub จะขอให้คุณให้สิทธิ์แอป Clevera AI โดยแอปจะขอสิทธิ์อ่านการเป็นสมาชิกองค์กรของคุณ เพื่อให้ Clevera สามารถแสดงรายการบัญชีที่คุณเป็นสมาชิกอยู่ได้ คลิก ให้สิทธิ์ (Authorize)

3. ติดตั้งแอปบนที่เก็บข้อมูลของคุณ#

   จากนั้น GitHub จะเปิดหน้าการติดตั้งแอป Clevera AI เลือกบัญชีส่วนตัวหรือองค์กรของคุณ จากนั้นเลือก ที่เก็บข้อมูลทั้งหมด หรือ เลือกเฉพาะที่เก็บข้อมูล แอปจะขอสิทธิ์ดังนี้:

   สิทธิ์ของ GitHub	เหตุผล
   เนื้อหา: อ่านและเขียน	เพื่อสร้างและอัปเดตไฟล์ Markdown และรูปภาพของไฟล์นั้น
   ข้อมูลเมตา: อ่านอย่างเดียว	GitHub กำหนดให้มีสำหรับทุกแอป เพื่อให้ Clevera สามารถแสดงรายการที่เก็บข้อมูลได้

   คลิก ติดตั้ง ทำซ้ำสำหรับแต่ละองค์กรที่คุณต้องการเผยแพร่

4. ตรวจสอบการเชื่อมต่อ#

   กลับมาที่หน้า การเชื่อมต่อ GitHub จะย้ายไปอยู่ในรายการ เชื่อมต่อแล้ว พร้อมชื่อบัญชี GitHub หรือชื่อองค์กรของคุณและป้ายกำกับ เชื่อมต่อแล้ว ก่อนที่คุณจะเผยแพร่สิ่งใด ระบบจะแสดงข้อความ "ยังไม่มีการเผยแพร่"

   

เพิ่มหรือลบที่เก็บข้อมูลในภายหลัง#

Clevera จะมองเห็นเฉพาะที่เก็บข้อมูลที่ติดตั้งแอปไว้เท่านั้น หากต้องการเปลี่ยนแปลง ให้เปิด การเชื่อมต่อ คลิก GitHub และภายใต้ การเข้าถึง ให้คลิก การเข้าถึงที่เก็บข้อมูล บน GitHub ให้เปิดบัญชี คลิก กำหนดค่า (Configure) และเปลี่ยนรายการที่เก็บข้อมูล ที่เก็บข้อมูลใหม่จะปรากฏขึ้นในครั้งถัดไปที่คุณเปิดแท็บ เผยแพร่

เผยแพร่บทความ#

1. เปิดแท็บเผยแพร่#

   ในโปรแกรมแก้ไข ให้คลิก แชร์ และเปิดแท็บ เผยแพร่ ภายใต้ เผยแพร่บทความนี้ ให้คลิกที่ไทล์ GitHub ภายใต้ พร้อมเผยแพร่

   บทความจะถูกเผยแพร่ในภาษาที่คุณเปิดอยู่ในโปรแกรมแก้ไข โปรดสลับภาษาที่แถบด้านบนก่อนหากต้องการเผยแพร่ฉบับแปล

2. เลือกบัญชี ที่เก็บข้อมูล และโฟลเดอร์#

   ภายใต้ ปลายทาง ให้เลือก:

   ฟิลด์	สิ่งที่ต้องเลือก	หมายเหตุ
   บัญชี	บัญชีส่วนตัวหรือองค์กรของคุณ	จะแสดงเฉพาะเมื่อที่เก็บข้อมูลของคุณอยู่ในบัญชีมากกว่าหนึ่งบัญชี
   ที่เก็บข้อมูล	ที่เก็บข้อมูลสำหรับไฟล์	แสดงรายการที่อัปเดตล่าสุดก่อน รายการแรกจะถูกเลือกไว้ให้คุณ
   โฟลเดอร์	เส้นทาง เช่น docs หรือ articles/guides	"ไฟล์ Markdown จะถูกสร้างขึ้นที่นี่ เว้นว่างไว้สำหรับรูทของที่เก็บข้อมูล" เริ่มต้นเป็น docs โฟลเดอร์ที่ยังไม่มีอยู่จะถูกสร้างขึ้น

   Clevera จะจดจำสิ่งที่คุณเลือกไว้สำหรับครั้งถัดไป

   

3. เผยแพร่#

   คลิก เผยแพร่ไปยัง GitHub คุณจะเห็นข้อความ "กำลังค้นหาสำเนาที่มีอยู่ใน GitHub" จากนั้นเป็น กำลังเขียนหน้าเว็บ เมื่อเสร็จสิ้น คุณจะเห็นข้อความ "เผยแพร่ไปยัง GitHub แล้ว" คลิก เปิดใน GitHub เพื่อดูไฟล์

   คุณสามารถปิดหน้าต่างแชร์ในขณะที่ระบบกำลังทำงานได้ โดยจะมีแจ้งเตือนบอกคุณเมื่อเสร็จสิ้น

ปลายทางของไฟล์#

• สาขา: สาขาเริ่มต้นของที่เก็บข้อมูล (โดยปกติคือ main) Clevera จะคอมมิตลงไปโดยตรง โดยจะไม่เปิด Pull Request และคุณไม่สามารถเลือกสาขาอื่นได้
• ชื่อไฟล์: ชื่อเรื่องที่เป็นตัวพิมพ์เล็ก โดยเปลี่ยนช่องว่างเป็นขีดกลาง และลงท้ายด้วย .md เช่น "Create your first invoice" จะกลายเป็น create-your-first-invoice.md ชื่อเรื่องในสคริปต์อื่นหรือที่มีเครื่องหมายกำกับเสียงจะถูกสะกดเป็นตัวอักษรละตินก่อน ("Créer une facture" จะกลายเป็น creer-une-facture.md) ชื่อเรื่องที่ไม่มีส่วนใดให้สะกดได้ เช่น ชื่อเรื่องที่เป็นอีโมจิล้วน จะได้รับรหัสคงที่สั้นๆ แทน (article- บวก 8 ตัวอักษร) ชื่อไฟล์จะถูกตัดที่ 80 ตัวอักษร
• รูปภาพ: ภาพหน้าจอของบทความจะถูกเก็บไว้ใน assets/<file name>/ ภายในโฟลเดอร์เดียวกัน ในคอมมิตเดียวกัน
• ข้อความคอมมิต: Add article: <title> หรือ Update article: <title> เมื่อคุณอัปเดตไฟล์ที่มีอยู่เดิม
• ผู้คอมมิต: บัญชี GitHub ที่เชื่อมต่อการเชื่อมต่อนี้

ลักษณะของไฟล์#

Clevera เขียน Markdown แบบ GitHub-flavored พร้อมบล็อก front matter สั้นๆ ที่ด้านบน:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

วิดีโอที่เป็นต้นทางของบทความจะไม่ถูกเพิ่มลงในไฟล์ วิดีโอ Clevera ที่วางไว้ในบทความจะกลายเป็นลิงก์ไปยังโปรแกรมเล่นวิดีโอเฉพาะเมื่อเปิดลิงก์แชร์ของวิดีโอนั้นไว้ ดูที่ แสดงวิดีโอในบทความ

รูปภาพ#

ภาพหน้าจอจะถูกคอมมิตไปยังที่เก็บข้อมูลของคุณข้างไฟล์ และ Markdown จะลิงก์ไปยังภาพเหล่านั้นด้วยเส้นทางสัมพัทธ์ (assets/<file name>/…) ภาพเหล่านี้จะยังคงทำงานได้โดยไม่ต้องใช้ Clevera และในที่เก็บข้อมูลส่วนตัว ภาพเหล่านี้จะยังคงเป็นส่วนตัวเช่นเดียวกับส่วนอื่นๆ ของที่เก็บข้อมูล

ไฟล์วิดีโอที่คุณอัปโหลดลงในบทความจะไม่ถูกคอมมิต แต่จะยังคงเป็นลิงก์ไปยัง Clevera ซึ่งจะหมดอายุหลังจากผ่านไปสักระยะ ให้เผยแพร่อีกครั้งเพื่อต่ออายุ

ใช้งานกับเว็บไซต์เอกสาร#

เครื่องมือสร้างเว็บไซต์แบบคงที่ส่วนใหญ่ที่สร้างจากที่เก็บข้อมูล (เช่น Docusaurus, MkDocs, Jekyll หรือ Hugo) จะอ่าน title จาก front matter และละเว้นฟิลด์ที่เครื่องมือไม่รู้จัก การตั้งค่าทั่วไปคือ:

1. กำหนด โฟลเดอร์ ไปยังโฟลเดอร์ที่เว็บไซต์เอกสารของคุณอ่าน เช่น docs หรือ content/guides
2. เผยแพร่แต่ละบทความที่นั่น; การสร้างเว็บไซต์ตามปกติของคุณจะดึงคอมมิตใหม่ไปใช้งาน
3. ตรวจสอบว่าเครื่องมือสร้างของคุณแสดงผลการแจ้งเตือนของ GitHub, คณิตศาสตร์ และ <details> หรือไม่; บางเครื่องมืออาจแสดงการแจ้งเตือนเป็นเพียงข้อความอ้างอิงธรรมดา

อัปเดตบทความที่คุณเผยแพร่ไปแล้ว#

การเผยแพร่เป็นแบบทางเดียว การแก้ไขที่คุณทำใน Clevera จะคงอยู่ใน Clevera จนกว่าคุณจะเผยแพร่อีกครั้ง และการเปลี่ยนแปลงที่ทำกับไฟล์บน GitHub จะไม่ถูกส่งกลับมายัง Clevera

เมื่อคุณเผยแพร่ไปยังที่เก็บข้อมูลและโฟลเดอร์เดิม Clevera จะพบไฟล์ที่มีชื่อเดียวกันและแสดงข้อความ "บทความนี้มีอยู่ใน GitHub แล้ว" คลิก ดูไฟล์ เพื่อเปิดไฟล์ที่มีอยู่เดิม จากนั้นเลือก:

หากชื่อเรื่องมีการเปลี่ยนแปลงใน Clevera ชื่อไฟล์ก็จะเปลี่ยนไปด้วย ดังนั้นการเผยแพร่จะสร้างไฟล์ใหม่ขึ้นมาข้างๆ ไฟล์เดิม คุณต้องลบหรือเปลี่ยนชื่อไฟล์เก่าบน GitHub ด้วยตัวเอง

ไม่มีสิ่งใดใน Clevera ที่จะลบไฟล์ออกจากที่เก็บข้อมูลของคุณ

ยกเลิกการเชื่อมต่อ GitHub#

1. เปิด การเชื่อมต่อ คลิกเมนู ⋯ บนแถว GitHub แล้วเลือก ยกเลิกการเชื่อมต่อ (หรือคลิก GitHub แล้วเลือก ยกเลิกการเชื่อมต่อ)
2. ยืนยัน "คุณจะไม่สามารถเผยแพร่ไปยังที่นั่นได้อีกจากตัวแก้ไข เนื้อหาที่คุณเผยแพร่ไปแล้วจะยังคงอยู่ใน GitHub"

การยกเลิกการเชื่อมต่อจะเป็นการลบโทเค็นการเข้าถึงของ Clevera หากต้องการลบการเข้าถึงของ Clevera บน GitHub ด้วย ให้ถอนการติดตั้งแอป Clevera AI (ไปที่ การตั้งค่า GitHub → Applications → Installed GitHub Apps → Configure → Uninstall) และเพิกถอนการอนุญาตภายใต้ Authorized GitHub Apps

การแก้ไขปัญหา#

เนื้อหาที่เกี่ยวข้อง#