Publikasikan artikel ke GitLab

Hubungkan GitLab sekali saja dan kamu dapat memublikasikan artikel Clevera apa pun ke proyek GitLab sebagai file Markdown, yang siap digunakan untuk situs dokumentasi, folder docs/, atau buku panduan proyek. Artikel ini membahas cara menghubungkan, memilih proyek dan folder, tampilan file, serta cara kerja pembaruan.

Sebelum kamu mulai#

• Paket: memublikasikan ke GitLab adalah bagian dari paket Pro dan Custom. Pada paket Free dan Starter, tab Publikasikan akan menampilkan "Memublikasikan ke alatmu sudah termasuk dalam paket Pro". Lihat Pilih paket.
• Peran di Clevera: hanya pemilik ruang kerja atau Administrator yang dapat menghubungkan atau memutuskan sambungan GitLab. Setelah tersambung, siapa pun yang dapat mengedit artikel dapat memublikasikannya.
• Hanya GitLab.com: Clevera terhubung ke GitLab.com. Server GitLab yang dikelola sendiri (self-managed) tidak didukung.
• Peran di GitLab: Clevera mencantumkan proyek di mana akun yang terhubung memiliki peran Developer atau lebih tinggi. Untuk melakukan commit ke branch default yang dilindungi, akun tersebut biasanya memerlukan peran Maintainer (lihat Branch yang dilindungi).
• Artikel: kamu memublikasikan artikel yang menjadi bagian dari video atau rekaman. Buat artikelnya terlebih dahulu; lihat Ubah rekaman menjadi artikel.

Memublikasikan tidak menggunakan kredit.

Hubungkan GitLab#

1. Buka Integrasi#

   Di bilah sisi, buka menu ruang kerja dan pilih Integrasi. Temukan GitLab di bawah Integrasi yang tersedia (atau tab Pengembangan) dan klik Hubungkan.

2. Masuk ke GitLab dan berikan otorisasi#

   Masuk ke GitLab.com jika kamu belum masuk. GitLab akan memintamu untuk memberikan otorisasi kepada Clevera dengan cakupan berikut:

   Cakupan GitLab	Mengapa
   api	API file GitLab memerlukannya untuk membuat dan memperbarui file
   read_user	Untuk menampilkan nama pengguna GitLab kamu di Clevera
   read_repository	Untuk memeriksa apakah file sudah ada
   write_repository	Untuk melakukan commit file Markdown dan gambarnya

   Klik Berikan otorisasi.

3. Periksa koneksi#

   Kamu akan kembali ke Integrasi dengan pesan "GitLab berhasil tersambung ke" diikuti oleh nama pengguna GitLab kamu. GitLab akan berpindah ke daftar Tersambung dengan lencana Tersambung. Sebelum kamu memublikasikan apa pun, statusnya akan terbaca "Belum ada yang dipublikasikan".

Publikasikan artikel#

1. Buka tab Publikasikan#

   Di editor, klik Bagikan dan buka tab Publikasikan. Di bawah Publikasikan artikel, klik ubin GitLab di bawah Siap untuk dipublikasikan.

   Artikel dipublikasikan dalam bahasa yang sedang kamu buka di editor. Ubah bahasa di bilah atas terlebih dahulu untuk memublikasikan terjemahan.

2. Pilih proyek dan folder#

   Di bawah Tempat penyimpanan, pilih:

   Bidang	Apa yang dipilih	Catatan
   Repositori	Proyek GitLab untuk file tersebut	Proyek di mana kamu memiliki peran Developer atau lebih tinggi, diurutkan berdasarkan yang paling baru diperbarui. Yang pertama dipilihkan untukmu
   Folder	Jalur seperti docs atau articles/guides	"File Markdown dibuat di sini. Biarkan kosong untuk root repositori." Dimulai sebagai docs. Folder yang belum ada akan dibuat secara otomatis

   Clevera akan mengingat pilihanmu untuk waktu berikutnya.

   

3. Publikasikan#

   Klik Publikasikan ke GitLab. Kamu akan melihat "Mencari salinan yang ada di GitLab", lalu Menulis halaman. Setelah selesai, kamu akan melihat "Berhasil dipublikasikan ke GitLab." Klik Buka di GitLab untuk melihat filenya.

   Kamu dapat menutup jendela Bagikan saat proses berlangsung; notifikasi akan memberitahumu saat proses selesai.

Tempat file disimpan#

• Branch: branch default proyek (biasanya main). Clevera melakukan commit langsung ke branch tersebut; Clevera tidak membuka merge request dan kamu tidak dapat memilih branch lain.
• Nama file: judul dalam huruf kecil, dengan spasi diubah menjadi tanda hubung, diakhiri dengan .md. "Create your first invoice" menjadi create-your-first-invoice.md. Judul dalam skrip lain atau dengan aksen akan dieja dalam huruf Latin terlebih dahulu ("Créer une facture" menjadi creer-une-facture.md). Judul yang tidak memiliki karakter untuk dieja, seperti yang hanya terdiri dari emoji, akan mendapatkan kode tetap singkat (article- ditambah 8 karakter). Nama dipotong pada 80 karakter.
• Gambar: tangkapan layar artikel masuk ke assets/<file name>/ di dalam folder yang sama, dalam commit yang sama.
• Pesan commit: Add article: <title>, atau Update article: <title> saat kamu memperbarui file yang sudah ada.
• Penulis commit: akun GitLab yang menghubungkan integrasi.

Branch yang dilindungi#

GitLab melindungi branch default secara bawaan, dan biasanya hanya Maintainer yang dapat melakukan push ke branch tersebut. Jika akun yang terhubung adalah Developer, commit akan ditolak dengan pesan "GitLab refused the commit: you need Developer access or higher, and the branch must not be protected." Berikan peran Maintainer ke akun tersebut, atau izinkan Developer untuk melakukan push di bawah Pengaturan → Repositori → Branch yang dilindungi di dalam proyek.

Tampilan file#

Clevera menulis Markdown yang dirender oleh GitLab, dengan blok front matter singkat di bagian atas:

---
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 asal artikel tidak ditambahkan ke file. Video Clevera yang ditempatkan di dalam artikel menjadi tautan ke pemutarnya, hanya jika tautan berbagi video tersebut aktif. Lihat Tampilkan video dalam artikel.

Gambar#

Tangkapan layar di-commit ke proyekmu di samping file, dan Markdown menautkannya berdasarkan jalur relatif (assets/<file name>/…). Gambar tersebut tetap berfungsi tanpa Clevera, dan dalam proyek pribadi, gambar tersebut tetap bersifat pribadi seperti bagian lainnya.

File video yang kamu unggah ke dalam artikel tidak di-commit. File tersebut tetap menjadi tautan ke Clevera yang akan kedaluwarsa setelah beberapa waktu; publikasikan kembali untuk memperbaruinya.

Gunakan dengan situs dokumentasi#

Jika GitLab Pages atau generator situs statis lainnya (seperti MkDocs, Docusaurus, atau Hugo) membangun dokumentasimu dari proyek tersebut, arahkan Folder ke folder yang dibacanya. Setiap publikasi adalah commit normal, jadi pipeline kamu berjalan seperti biasa. Sebagian besar generator membaca title dari front matter dan mengabaikan bidang yang tidak mereka kenali.

Perbarui artikel yang sudah dipublikasikan#

Publikasi hanya berjalan satu arah. Editan yang kamu buat di Clevera tetap di Clevera sampai kamu memublikasikannya kembali, dan perubahan yang dibuat pada file di GitLab tidak akan pernah kembali ke Clevera.

Saat kamu memublikasikan ke proyek dan folder yang sama, Clevera menemukan file dengan nama yang sama dan menampilkan "Artikel ini sudah ada di GitLab." Klik Lihat untuk membuka file yang ada, lalu pilih:

Jika judul diubah di Clevera, nama file juga berubah, sehingga publikasi membuat file baru di samping file lama. Hapus atau ganti nama file lama di GitLab sendiri. Tidak ada fitur di Clevera yang menghapus file dari proyekmu.

Putuskan sambungan GitLab#

1. Buka Integrasi, klik menu ⋯ pada baris GitLab dan pilih Putuskan sambungan (atau klik GitLab lalu Putuskan sambungan).
2. Konfirmasi. "Kamu tidak dapat lagi memublikasikannya dari editor. Konten yang sudah kamu publikasikan tetap ada di GitLab."

Memutuskan sambungan akan menghapus token Clevera. Untuk mencabut akses Clevera di GitLab juga, buka menu avatar GitLab kamu → Edit profil → Aplikasi, temukan Clevera di bawah Aplikasi yang diotorisasi dan klik Cabut.

Pemecahan masalah#

Terkait#