Makaleleri Bitbucket'a yayınla

Bitbucket'ı bir kez bağla; böylece herhangi bir Clevera makalesini, bir doküman sitesi veya kodunun yanındaki bir docs/ klasörü için hazır olacak şekilde, Markdown dosyası olarak bir Bitbucket deposuna yayınlayabilirsin. Bu makale; bağlantı kurmayı, depo ve klasör seçimini, dosyanın nasıl göründüğünü ve güncellemelerin nasıl çalıştığını kapsar.

Başlamadan önce#

• Plan: Bitbucket'a yayınlama, Pro ve Custom planlarının bir parçasıdır. Free ve Starter planlarında Yayınla sekmesi "Araçlarınıza yayınlama Pro planına dahildir" uyarısını gösterir. Bkz. Bir plan seçin.
• Clevera'daki rol: Yalnızca çalışma alanı sahibi veya bir Yönetici Bitbucket bağlantısını kurabilir veya kesebilir. Bağlantı kurulduktan sonra, bir makaleyi düzenleyebilen herkes onu yayınlayabilir.
• Yalnızca Bitbucket Cloud: Clevera, bitbucket.org adresine bağlanır. Bitbucket Data Center ve Server desteklenmez.
• Bitbucket'ta erişim: Bağlantıyı kuran hesap, yayınlamak istediğin depolara katkıda bulunabilmeli ve ana dala yazma erişimine sahip olmalıdır.
• Bir makale: Bir videoya veya kayda ait olan makaleyi yayınlarsın. Önce onu oluştur; bkz. Bir kaydı makaleye dönüştürme.

Yayınlama işlemi kredi harcamaz.

Bitbucket'ı bağla#

1. Entegrasyonları aç#

   Kenar çubuğunda çalışma alanı menüsünü aç ve Entegrasyonlar'ı seç. Kullanılabilir entegrasyonlar (veya Geliştirme sekmesi) altında Bitbucket'ı bul ve Bağla'ya tıkla.

2. Bitbucket'ta erişim izni ver#

   Henüz oturum açmadıysan Bitbucket'ta oturum aç. Bitbucket, Clevera'ya erişim izni vermeni ister:

   Bitbucket izni	Neden
   Hesap: okuma	Bitbucket adını Clevera'da göstermek için
   Depolar: okuma	Depoları listelemek ve bir dosyanın zaten var olup olmadığını kontrol etmek için
   Depolar: yazma	Markdown dosyasını ve görsellerini commit etmek için

   Erişim izni ver'e tıkla.

3. Bağlantıyı kontrol et#

   Bitbucket adının takip ettiği "Bitbucket başarıyla bağlandı" mesajıyla Entegrasyonlar sayfasına dönersin. Bitbucket, Bağlandı rozetiyle Bağlandı listesine taşınır. Herhangi bir şey yayınlamadan önce "Henüz bir şey yayınlanmadı" yazar.

Bir makale yayınla#

1. Yayınla sekmesini aç#

   Düzenleyicide Paylaş'a tıkla ve Yayınla sekmesini aç. Makaleyi yayınla altında, Yayınlamaya hazır kısmındaki Bitbucket kutucuğuna tıkla.

   Makale, düzenleyicide açık olan dilde yayınlanır. Bir çeviri yayınlamak için önce üst çubuktan dili değiştir.

2. Depoyu ve klasörü seç#

   Nereye gidecek altında şunları seç:

   Alan	Ne seçilmeli	Notlar
   Depo	Dosya için Bitbucket deposu	Bitbucket çalışma alanlarında katkıda bulunabileceğin, en son güncellenenler başta olmak üzere depolar. İlki senin için seçilidir
   Klasör	docs veya articles/guides gibi bir yol	"Markdown dosyası burada oluşturulur. Depo kök dizini için boş bırak." docs olarak başlar. Henüz var olmayan klasörler oluşturulur

   Clevera, bir dahaki sefere ne seçtiğini hatırlar.

   

3. Yayınla#

   Bitbucket'a yayınla'ya tıkla. "Bitbucket'ta mevcut bir kopya aranıyor" mesajını, ardından Sayfa yazılıyor yazısını görürsün. İşlem bittiğinde "Bitbucket'a yayınlandı" mesajını görürsün. Dosyayı görmek için Bitbucket'ta aç'a tıkla.

   İşlem devam ederken Paylaş penceresini kapatabilirsin; işlem bittiğinde bir bildirim seni bilgilendirir.

Dosya nereye gider#

• Dal: Deponun ana dalı (genellikle main veya master). Clevera doğrudan buraya commit eder; bir pull request açmaz ve başka bir dal seçemezsin.
• Dosya adı: Küçük harflerle başlık, boşluklar tire işaretine dönüştürülmüş ve .md ile bitiyor. "Create your first invoice" ifadesi create-your-first-invoice.md olur. Diğer alfabelerdeki veya aksanlı başlıklar önce Latin harfleriyle yazılır ("Créer une facture" ifadesi creer-une-facture.md olur). Yalnızca emojilerden oluşan bir başlık gibi yazılacak bir şeyi kalmayan başlıklar, bunun yerine kısa sabit bir kod alır (article- artı 8 karakter). İsimler 80 karakterde kesilir.
• Görseller: Makalenin ekran görüntüleri aynı commit içinde, aynı klasörün içindeki assets/<file name>/ dizinine gider.
• Commit mesajı: Add article: <title> veya mevcut bir dosyayı güncellediğinde Update article: <title>.
• Commit yazarı: Entegrasyonu bağlayan Bitbucket hesabı.

Dal kısıtlamaları#

Eğer deponun ana dalında bir dal kısıtlaması varsa (örneğin, değişikliklerin yalnızca pull request'ler aracılığıyla yapılması veya yazma işleminin belirli kişilerle sınırlandırılması), Clevera'nın commit'i reddedilir; örneğin "Bu Bitbucket deposuna commit etmek için yazma erişimine ihtiyacınız var." mesajıyla. Bağlı hesabı Depo ayarları → Dal kısıtlamaları altından dala yazabilen kişilere ekle veya bu kuralın olmadığı bir depoya yayınla.

Dosya nasıl görünür#

Clevera, Bitbucket'ın dosya görünümünün gösterebileceği, üst kısmında kısa bir front matter bloğu olan düz Markdown yazar. Ham HTML içermez, çünkü Bitbucket bunu render etmez.

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

Makalenin kaynağı olan video dosyaya eklenmez. Makalenin içine yerleştirilen bir Clevera videosu, yalnızca o videonun paylaşım bağlantısı açık olduğunda oynatıcısına bir bağlantı haline gelir. Bkz. Bir makalede video gösterme.

Görseller#

Ekran görüntüleri, dosyanın yanına depoya commit edilir ve Markdown onlara göreli yolla (assets/<file name>/…) bağlantı verir. Clevera olmadan da çalışmaya devam ederler ve özel bir depoda, deponun geri kalanı kadar özel kalırlar.

Makaleye yüklediğin bir video dosyası commit edilmez. Bir süre sonra süresi dolan bir Clevera bağlantısı olarak kalır; yenilemek için tekrar yayınla.

Bir doküman sitesiyle kullan#

Eğer statik site oluşturucu (MkDocs, Docusaurus veya Hugo gibi) dokümanlarını depodan oluşturuyorsa, Klasör'ü okuduğu klasöre yönlendir. Her yayınlama normal bir commit'tir, bu nedenle Bitbucket Pipelines veya diğer build işlemlerin her zamanki gibi çalışır. Çoğu oluşturucu front matter'dan title değerini okur ve bilmediği alanları görmezden gelir.

Zaten yayınladığın bir makaleyi güncelle#

Yayınlama yalnızca tek yönlüdür. Clevera'da yaptığın düzenlemeler tekrar yayınlayana kadar Clevera'da kalır ve Bitbucket'taki dosyada yapılan değişiklikler asla Clevera'ya geri dönmez.

Aynı depo ve klasöre yayınladığında, Clevera aynı isimli dosyayı bulur ve "Bu makale zaten Bitbucket'ta var." mesajını gösterir. Mevcut dosyayı açmak için Görüntüle'ye tıkla, ardından şunlardan birini seç:

Eğer başlık Clevera'da değiştiyse, dosya adı da değişir, bu nedenle yayınlama eski dosyanın yanında yeni bir dosya oluşturur. Eski dosyayı Bitbucket'ta kendin sil veya yeniden adlandır. Clevera'daki hiçbir şey depondan dosya silmez.

Bitbucket bağlantısını kes#

1. Entegrasyonlar'ı aç, Bitbucket satırındaki ⋯ menüsüne tıkla ve Bağlantıyı kes'i seç (veya Bitbucket'a ve ardından Bağlantıyı kes'e tıkla).
2. Onayla. "Artık düzenleyiciden buraya yayınlayamazsın. Zaten yayınladığın içerik Bitbucket'ta kalır."

Bağlantıyı kesmek Clevera'nın token'larını siler. Clevera'nın Bitbucket'taki erişimini de iptal etmek için Bitbucket Kişisel ayarlar'ını aç, Uygulama yetkilendirmeleri'ne git ve Clevera'yı iptal et.

Sorun giderme#

İlgili#