Xuất bản bài viết lên GitLab

Kết nối GitLab một lần và bạn có thể xuất bản bất kỳ bài viết nào trên Clevera vào một dự án GitLab dưới dạng tệp Markdown, sẵn sàng cho trang tài liệu, thư mục docs/ hoặc sổ tay dự án. Bài viết này bao gồm các nội dung về cách kết nối, chọn dự án và thư mục, tệp trông như thế nào và cách các bản cập nhật hoạt động.

Trước khi bạn bắt đầu#

• Gói: việc xuất bản lên GitLab là một phần của gói Pro và Custom. Trên gói Free và Starter, tab Xuất bản hiển thị "Việc xuất bản lên các công cụ của bạn đã được bao gồm trong gói Pro". Xem Chọn gói.
• Vai trò trong Clevera: chỉ chủ sở hữu không gian làm việc hoặc Quản trị viên mới có thể kết nối hoặc ngắt kết nối GitLab. Sau khi đã kết nối, bất kỳ ai có quyền chỉnh sửa bài viết đều có thể xuất bản bài viết đó.
• Chỉ dành cho GitLab.com: Clevera kết nối với GitLab.com. Các máy chủ GitLab tự quản lý không được hỗ trợ.
• Vai trò trong GitLab: Clevera liệt kê các dự án mà tài khoản kết nối có vai trò Nhà phát triển (Developer) trở lên. Để commit vào một nhánh mặc định được bảo vệ, tài khoản đó thường cần quyền Người duy trì (Maintainer) (xem Nhánh được bảo vệ).
• Một bài viết: bạn xuất bản bài viết thuộc về một video hoặc bản ghi. Hãy tạo bài viết trước; xem Chuyển bản ghi thành bài viết.

Việc xuất bản không sử dụng tín dụng.

Kết nối GitLab#

1. Mở Tích hợp#

   Trong thanh bên, hãy mở menu không gian làm việc và chọn Tích hợp. Tìm GitLab trong mục Tích hợp khả dụng (hoặc tab Phát triển) và nhấp vào Kết nối.

2. Đăng nhập vào GitLab và ủy quyền#

   Đăng nhập vào GitLab.com nếu bạn chưa đăng nhập. GitLab yêu cầu bạn ủy quyền cho Clevera với các phạm vi sau:

   Phạm vi GitLab	Lý do
   api	API tệp của GitLab cần quyền này để tạo và cập nhật tệp
   read_user	Để hiển thị tên người dùng GitLab của bạn trong Clevera
   read_repository	Để kiểm tra xem tệp đã tồn tại hay chưa
   write_repository	Để commit tệp Markdown và hình ảnh của tệp đó

   Nhấp vào Ủy quyền.

3. Kiểm tra kết nối#

   Bạn sẽ quay lại trang Tích hợp với thông báo "GitLab đã kết nối thành công với" theo sau là tên người dùng GitLab của bạn. GitLab chuyển sang danh sách Đã kết nối với huy hiệu Đã kết nối. Trước khi bạn xuất bản bất cứ thứ gì, nó sẽ hiển thị "Chưa có nội dung nào được xuất bản".

Xuất bản bài viết#

1. Mở tab Xuất bản#

   Trong trình chỉnh sửa, nhấp vào Chia sẻ và mở tab Xuất bản. Trong phần Xuất bản bài viết, nhấp vào ô GitLab trong mục Sẵn sàng xuất bản.

   Bài viết được xuất bản bằng ngôn ngữ bạn đang mở trong trình chỉnh sửa. Hãy chuyển đổi ngôn ngữ ở thanh trên cùng trước để xuất bản bản dịch.

2. Chọn dự án và thư mục#

   Trong phần Nơi lưu trữ, hãy chọn:

   Trường	Nội dung cần chọn	Ghi chú
   Kho lưu trữ	Dự án GitLab cho tệp	Các dự án mà bạn có quyền Nhà phát triển trở lên, các dự án được cập nhật gần đây nhất sẽ hiển thị trước. Dự án đầu tiên được chọn mặc định cho bạn
   Thư mục	Đường dẫn như docs hoặc articles/guides	"Tệp Markdown được tạo tại đây. Để trống nếu muốn lưu ở thư mục gốc của kho lưu trữ." Bắt đầu là docs. Các thư mục chưa tồn tại sẽ được tạo mới

   Clevera sẽ ghi nhớ lựa chọn của bạn cho lần sau.

   

3. Xuất bản#

   Nhấp vào Xuất bản lên GitLab. Bạn sẽ thấy "Đang tìm bản sao hiện có trong GitLab", sau đó là Đang viết trang. Khi hoàn tất, bạn sẽ thấy "Đã xuất bản lên GitLab." Nhấp vào Mở trong GitLab để xem tệp.

   Bạn có thể đóng cửa sổ Chia sẻ trong khi quá trình chạy; một thông báo sẽ cho bạn biết khi quá trình hoàn tất.

Nơi tệp được lưu trữ#

• Nhánh: nhánh mặc định của dự án (thường là main). Clevera commit trực tiếp vào nhánh đó; nó không mở yêu cầu hợp nhất (merge request) và bạn không thể chọn nhánh khác.
• Tên tệp: tiêu đề ở dạng chữ thường, các khoảng trắng được chuyển thành dấu gạch nối, kết thúc bằng .md. "Create your first invoice" trở thành create-your-first-invoice.md. Các tiêu đề bằng ngôn ngữ khác hoặc có dấu sẽ được chuyển sang chữ Latinh trước ("Créer une facture" trở thành creer-une-facture.md). Một tiêu đề không còn ký tự nào để chuyển đổi, chẳng hạn như tiêu đề chỉ gồm biểu tượng cảm xúc, sẽ nhận được một mã cố định ngắn thay thế (article- cộng với 8 ký tự). Tên tệp được cắt bớt ở 80 ký tự.
• Hình ảnh: ảnh chụp màn hình của bài viết sẽ nằm trong assets/<file name>/ bên trong cùng thư mục, trong cùng một commit.
• Thông báo commit: Add article: <title>, hoặc Update article: <title> khi bạn cập nhật tệp hiện có.
• Tác giả commit: tài khoản GitLab đã kết nối tích hợp.

Nhánh được bảo vệ#

GitLab bảo vệ nhánh mặc định theo mặc định và thường chỉ Người duy trì (Maintainer) mới có thể đẩy (push) lên đó. Nếu tài khoản được kết nối là Nhà phát triển (Developer), commit sẽ bị từ chối với thông báo "GitLab refused the commit: you need Developer access or higher, and the branch must not be protected." Bạn hãy cấp cho tài khoản đó vai trò Người duy trì, hoặc cho phép Nhà phát triển đẩy lên trong phần Cài đặt → Kho lưu trữ → Nhánh được bảo vệ trong dự án.

Tệp trông như thế nào#

Clevera viết Markdown mà GitLab hiển thị, với một khối front matter ngắn ở trên cùng:

---
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"
---

Video mà bài viết lấy từ đó không được thêm vào tệp. Một video Clevera được đặt trong bài viết sẽ trở thành liên kết đến trình phát của nó, chỉ khi liên kết chia sẻ của video đó được bật. Xem Hiển thị video trong bài viết.

Hình ảnh#

Ảnh chụp màn hình được commit vào dự án của bạn bên cạnh tệp và các liên kết Markdown trỏ đến chúng theo đường dẫn tương đối (assets/<file name>/…). Chúng vẫn hoạt động mà không cần Clevera, và trong một dự án riêng tư, chúng vẫn giữ tính bảo mật như phần còn lại của dự án.

Tệp video bạn đã tải lên bài viết không được commit. Nó vẫn là một liên kết đến Clevera và sẽ hết hạn sau một thời gian; hãy xuất bản lại để gia hạn.

Sử dụng với trang tài liệu#

Nếu GitLab Pages hoặc trình tạo trang tĩnh khác (như MkDocs, Docusaurus hoặc Hugo) xây dựng tài liệu của bạn từ dự án, hãy trỏ Thư mục vào thư mục mà trình tạo đó đọc. Mỗi lần xuất bản là một commit bình thường, vì vậy quy trình của bạn chạy như bình thường. Hầu hết các trình tạo đều đọc title từ front matter và bỏ qua các trường mà chúng không biết.

Cập nhật bài viết bạn đã xuất bản#

Việc xuất bản chỉ diễn ra theo một chiều. Các chỉnh sửa bạn thực hiện trong Clevera vẫn nằm trong Clevera cho đến khi bạn xuất bản lại, và các thay đổi được thực hiện đối với tệp trong GitLab sẽ không bao giờ quay trở lại Clevera.

Khi bạn xuất bản vào cùng một dự án và thư mục, Clevera tìm thấy tệp có cùng tên và hiển thị "Bài viết này đã có trong GitLab." Nhấp vào Xem tệp để mở tệp hiện có, sau đó chọn:

Nếu tiêu đề thay đổi trong Clevera, tên tệp cũng thay đổi, vì vậy việc xuất bản sẽ tạo ra một tệp mới bên cạnh tệp cũ. Hãy tự xóa hoặc đổi tên tệp cũ trong GitLab. Không có gì trong Clevera tự động xóa tệp khỏi dự án của bạn.

Ngắt kết nối GitLab#

1. Mở Tích hợp, nhấp vào menu ⋯ trên hàng GitLab và chọn Ngắt kết nối (hoặc nhấp vào GitLab rồi chọn Ngắt kết nối).
2. Xác nhận. "Bạn không còn có thể xuất bản lên đó từ trình chỉnh sửa. Nội dung bạn đã xuất bản vẫn nằm trong GitLab."

Việc ngắt kết nối sẽ xóa các token của Clevera. Để thu hồi quyền truy cập của Clevera trên GitLab, hãy mở menu ảnh đại diện GitLab của bạn → Chỉnh sửa hồ sơ → Ứng dụng, tìm Clevera trong mục Ứng dụng được ủy quyền và nhấp vào Thu hồi.

Khắc phục sự cố#

Nội dung liên quan#