Publikasikan artikel ke Bitbucket

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

Sebelum kamu mulai#

• Paket: memublikasikan ke Bitbucket 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 sambungan Bitbucket. Setelah tersambung, siapa pun yang dapat mengedit artikel dapat memublikasikannya.
• Hanya Bitbucket Cloud: Clevera terhubung ke bitbucket.org. Bitbucket Data Center dan Server tidak didukung.
• Akses di Bitbucket: akun yang menghubungkan harus dapat berkontribusi ke repositori yang ingin kamu tuju, dengan akses tulis ke cabang utama.
• Sebuah 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 Bitbucket#

1. Buka Integrasi#

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

2. Berikan akses di Bitbucket#

   Masuk ke Bitbucket jika kamu belum masuk. Bitbucket akan memintamu untuk memberikan akses ke Clevera:

   Izin Bitbucket	Mengapa
   Akun: baca	Untuk menampilkan nama Bitbucket kamu di Clevera
   Repositori: baca	Untuk mencantumkan repositori dan memeriksa apakah file sudah ada
   Repositori: tulis	Untuk melakukan commit file Markdown dan gambarnya

   Klik Berikan akses.

3. Periksa koneksi#

   Kamu akan kembali ke Integrasi dengan pesan "Bitbucket berhasil tersambung ke" diikuti oleh nama Bitbucket kamu. Bitbucket 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 Bitbucket 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 repositori dan folder#

   Di bawah Tujuan, pilih:

   Bidang	Apa yang harus dipilih	Catatan
   Repositori	Repositori Bitbucket untuk file tersebut	Repositori yang dapat kamu kontribusikan, di seluruh ruang kerja Bitbucket kamu, 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

   Clevera akan mengingat pilihanmu untuk waktu berikutnya.

   

3. Publikasikan#

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

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

Ke mana file pergi#

• Cabang: cabang utama repositori (biasanya main atau master). Clevera melakukan commit langsung ke cabang tersebut; Clevera 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 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 Bitbucket yang menghubungkan integrasi.

Batasan cabang#

Jika repositori memiliki batasan cabang pada cabang utamanya (misalnya, perubahan hanya melalui pull request, atau penulisan dibatasi untuk orang tertentu), commit Clevera akan ditolak, misalnya dengan "You need write access to commit to this Bitbucket repository." Tambahkan akun yang terhubung ke daftar orang yang dapat menulis ke cabang tersebut di bawah Pengaturan repositori → Batasan cabang, atau publikasikan ke repositori tanpa aturan tersebut.

Tampilan file#

Clevera menulis Markdown biasa yang dapat ditampilkan oleh tampilan file Bitbucket, dengan blok front matter singkat di bagian atas. File ini tidak berisi HTML mentah, karena Bitbucket tidak merendernya.

---
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 repositori kamu 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#

Jika generator situs statis (seperti MkDocs, Docusaurus, atau Hugo) membangun dokumentasi kamu dari repositori, arahkan Folder ke folder yang dibacanya. Setiap publikasi adalah commit normal, jadi Bitbucket Pipelines atau proses build kamu yang lain 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 memublikasikan kembali, dan perubahan yang dibuat pada file di Bitbucket 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 Bitbucket." 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 Bitbucket sendiri. Tidak ada fitur di Clevera yang menghapus file dari repositori kamu.

Putuskan sambungan Bitbucket#

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

Memutuskan sambungan akan menghapus token Clevera. Untuk mencabut akses Clevera di Bitbucket juga, buka Pengaturan pribadi Bitbucket kamu, buka Otorisasi aplikasi, dan cabut akses Clevera.

Pemecahan masalah#

Terkait#