Publikasikan artikel ke GitHub

Hubungkan GitHub sekali saja dan kamu bisa memublikasikan artikel Clevera apa pun ke repositori sebagai file Markdown, yang siap digunakan untuk situs dokumentasi, folder bergaya wiki docs/, atau koleksi README. Artikel ini membahas cara menghubungkan, memilih repositori dan folder, tampilan file, serta cara kerja pembaruan.

Sebelum kamu mulai#

• Paket: memublikasikan ke GitHub adalah bagian dari paket Pro dan Custom. Pada paket Free dan Starter, tab Publikasikan akan menampilkan "Memublikasikan ke alat kamu sudah termasuk dalam paket Pro". Lihat Pilih paket.
• Peran di Clevera: hanya pemilik ruang kerja atau Administrator yang dapat menghubungkan atau memutuskan koneksi GitHub. Setelah terhubung, siapa pun yang dapat mengedit artikel dapat memublikasikannya.
• Akses di GitHub: orang yang menghubungkan memerlukan akses tulis ke repositori yang ingin kamu tuju, dan hak untuk menginstal Aplikasi GitHub di akun pribadi atau organisasi tersebut (atau pemilik organisasi untuk menyetujuinya).
• Artikel: kamu memublikasikan artikel yang menjadi bagian dari video atau rekaman. Buat artikelnya terlebih dahulu; lihat Ubah rekaman menjadi artikel.

Proses publikasi tidak menggunakan kredit.

Hubungkan GitHub#

1. Buka Integrasi#

   Di bilah sisi, buka menu ruang kerja dan pilih Integrasi. Temukan GitHub di bawah Integrasi yang tersedia (atau tab Pengembangan) dan klik Hubungkan. Tombol tersebut muncul saat kamu mengarahkan kursor ke kartu.

   

2. Otorisasi Clevera di GitHub#

   GitHub memintamu untuk mengotorisasi aplikasi Clevera AI. Aplikasi ini meminta akses baca ke keanggotaan organisasimu, sehingga Clevera dapat mencantumkan akun tempat kamu bergabung. Klik Otorisasi.

3. Instal aplikasi di repositorimu#

   GitHub kemudian membuka halaman instalasi aplikasi Clevera AI. Pilih akun pribadi atau organisasi, lalu pilih Semua repositori atau Hanya pilih repositori tertentu. Aplikasi ini meminta:

   Izin GitHub	Mengapa
   Konten: baca dan tulis	Untuk membuat dan memperbarui file Markdown beserta gambarnya
   Metadata: hanya-baca	Diperlukan oleh GitHub untuk setiap aplikasi; memungkinkan Clevera mencantumkan repositori

   Klik Instal. Ulangi untuk setiap organisasi yang ingin kamu tuju untuk publikasi.

4. Periksa koneksi#

   Kembali ke Integrasi, GitHub akan pindah ke daftar Tersambung dengan nama akun atau organisasi GitHub kamu beserta lencana Tersambung. Sebelum kamu memublikasikan apa pun, statusnya akan bertuliskan "Belum ada yang dipublikasikan".

   

Tambah atau hapus repositori nanti#

Clevera hanya melihat repositori tempat aplikasi diinstal. Untuk mengubahnya, buka Integrasi, klik GitHub, dan di bawah Akses klik Akses repositori. Di GitHub, buka akun tersebut, klik Konfigurasi, dan ubah daftar repositori. Repositori baru akan muncul saat kamu membuka tab Publikasikan berikutnya.

Publikasikan artikel#

1. Buka tab Publikasikan#

   Di editor, klik Bagikan dan buka tab Publikasikan. Di bawah Publikasikan artikel, klik ubin GitHub 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 akun, repositori, dan folder#

   Di bawah Tujuan, pilih:

   Bidang	Apa yang harus dipilih	Catatan
   Akun	Akun pribadi atau organisasi kamu	Hanya ditampilkan jika repositorimu milik lebih dari satu akun
   Repositori	Repositori untuk file tersebut	Yang paling baru diperbarui muncul pertama. 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

   Clevera akan mengingat pilihanmu untuk waktu berikutnya.

   

3. Publikasikan#

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

   Kamu bisa menutup jendela Bagikan saat proses berjalan; notifikasi akan memberitahumu setelah selesai.

Tempat file disimpan#

• Cabang: cabang default repositori (biasanya main). Clevera melakukan commit langsung ke cabang tersebut; tidak membuka pull request dan kamu tidak bisa memilih cabang 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 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 GitHub yang menghubungkan integrasi.

Tampilan file#

Clevera menulis Markdown bergaya GitHub 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 repositorimu di samping file, dan Markdown menautkannya berdasarkan jalur relatif (assets/<file name>/…). Gambar tersebut tetap berfungsi tanpa Clevera, dan di repositori 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#

Sebagian besar generator situs statis yang membangun dari repositori (seperti Docusaurus, MkDocs, Jekyll, atau Hugo) membaca title dari front matter dan mengabaikan bidang yang tidak mereka kenali. Pengaturan umum:

1. Arahkan Folder ke folder yang dibaca situs dokumentasimu, misalnya docs atau content/guides.
2. Publikasikan setiap artikel di sana; build normal situsmu akan mengambil commit baru.
3. Periksa apakah generator kamu merender peringatan GitHub, matematika, dan <details>; beberapa menampilkan peringatan sebagai kutipan biasa.

Perbarui artikel yang sudah dipublikasikan#

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

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

Jika judul diubah di Clevera, nama file juga akan berubah, sehingga penerbitan akan membuat file baru di samping file lama. Hapus atau ganti nama file lama di GitHub sendiri.

Tidak ada fitur di Clevera yang menghapus file dari repositori kamu.

Putuskan sambungan GitHub#

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

Memutuskan sambungan akan menghapus token akses Clevera. Untuk menghapus akses Clevera di GitHub juga, hapus instalan aplikasi Clevera AI (Pengaturan GitHub → Applications → Installed GitHub Apps → Configure → Uninstall) dan cabut otorisasi di bawah Authorized GitHub Apps.

Pemecahan masalah#

Terkait#