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

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

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

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

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

เชื่อมต่อ GitLab#

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

   ในแถบด้านข้าง ให้เปิดเมนูพื้นที่ทำงานและเลือก การเชื่อมต่อ ค้นหา GitLab ภายใต้ การเชื่อมต่อที่มีให้ (หรือแท็บ การพัฒนา) แล้วคลิก เชื่อมต่อ

2. ลงชื่อเข้าใช้ GitLab และให้สิทธิ์#

   ลงชื่อเข้าใช้ GitLab.com หากคุณยังไม่ได้ลงชื่อเข้าใช้ GitLab จะขอให้คุณอนุญาตให้ Clevera เข้าถึงด้วยขอบเขตดังต่อไปนี้:

   ขอบเขตของ GitLab	เหตุผล
   api	API ไฟล์ของ GitLab จำเป็นต้องใช้เพื่อสร้างและอัปเดตไฟล์
   read_user	เพื่อแสดงชื่อผู้ใช้ GitLab ของคุณใน Clevera
   read_repository	เพื่อตรวจสอบว่ามีไฟล์อยู่แล้วหรือไม่
   write_repository	เพื่อคอมมิตไฟล์ Markdown และรูปภาพของไฟล์นั้น

   คลิก อนุญาต

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

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

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

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

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

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

2. เลือกโปรเจกต์และโฟลเดอร์#

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

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

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

   

3. เผยแพร่#

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

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

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

• สาขา: สาขาเริ่มต้นของโปรเจกต์ (ปกติคือ main) Clevera จะคอมมิตไปยังสาขานั้นโดยตรง โดยจะไม่เปิดคำขอรวม (merge 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> เมื่อคุณอัปเดตไฟล์ที่มีอยู่เดิม
• ผู้คอมมิต: บัญชี GitLab ที่เชื่อมต่อการเชื่อมต่อนี้

สาขาที่ได้รับการป้องกัน#

GitLab จะป้องกันสาขาเริ่มต้นโดยค่าเริ่มต้น และโดยปกติจะมีเพียงผู้ดูแลเท่านั้นที่สามารถพุชข้อมูลไปยังสาขานั้นได้ หากบัญชีที่เชื่อมต่อเป็นนักพัฒนา การคอมมิตจะถูกปฏิเสธพร้อมข้อความ "GitLab ปฏิเสธการคอมมิต: คุณต้องมีสิทธิ์เข้าถึงระดับนักพัฒนาหรือสูงกว่า และสาขาต้องไม่ได้รับการป้องกัน" คุณสามารถให้บทบาทผู้ดูแลแก่บัญชีนั้น หรืออนุญาตให้นักพัฒนาพุชข้อมูลได้ภายใต้ การตั้งค่า → ที่เก็บข้อมูล → สาขาที่ได้รับการป้องกัน ในโปรเจกต์

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

Clevera เขียน Markdown ที่ GitLab สามารถแสดงผลได้ พร้อมบล็อกข้อมูลส่วนหน้า (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 ซึ่งจะหมดอายุหลังจากผ่านไประยะหนึ่ง ให้เผยแพร่อีกครั้งเพื่อต่ออายุ

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

หาก GitLab Pages หรือเครื่องมือสร้างเว็บไซต์แบบคงที่อื่นๆ (เช่น MkDocs, Docusaurus หรือ Hugo) สร้างเอกสารของคุณจากโปรเจกต์ ให้ชี้ โฟลเดอร์ ไปยังโฟลเดอร์ที่เครื่องมืออ่าน การเผยแพร่แต่ละครั้งคือการคอมมิตปกติ ดังนั้นไปป์ไลน์ของคุณจะทำงานตามปกติ เครื่องมือสร้างส่วนใหญ่จะอ่าน title จากข้อมูลส่วนหน้าและละเว้นช่องที่ไม่รู้จัก

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

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

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

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

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

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

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

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

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