Makaleleri GitHub'da yayınla

GitHub'ı bir kez bağladığınızda, herhangi bir Clevera makalesini bir doküman sitesi, wiki tarzı bir docs/ klasörü veya bir README koleksiyonu için hazır olacak şekilde bir depoya Markdown dosyası olarak yayınlayabilirsiniz. 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: GitHub'da yayınlama, Pro ve Custom planlarının bir parçasıdır. Free ve Starter planlarında Yayınla sekmesinde "Araçlarınızda yayınlama Pro planına dahildir" ifadesi görünür. Bkz. Plan seçin.
• Clevera'daki rol: Yalnızca çalışma alanı sahibi veya bir Yönetici GitHub'ı bağlayabilir veya bağlantısını kesebilir. Bağlandıktan sonra, bir makaleyi düzenleyebilen herkes onu yayınlayabilir.
• GitHub'daki erişim: Bağlantıyı kuran kişinin, yayınlamak istediğiniz depolara yazma erişimine ve bu kişisel hesap veya kuruluş üzerinde bir GitHub Uygulaması yükleme hakkına (veya onaylayacak bir kuruluş sahibine) sahip olması gerekir.
• Bir makale: Bir videoya veya kayda ait olan makaleyi yayınlarsınız. Önce onu oluşturun; bkz. Bir kaydı makaleye dönüştürün.

Yayınlama işlemi kredi harcamaz.

GitHub'ı bağlayın#

1. Entegrasyonları açın#

   Kenar çubuğunda çalışma alanı menüsünü açın ve Entegrasyonlar'ı seçin. Kullanılabilir entegrasyonlar (veya Geliştirme sekmesi) altında GitHub'ı bulun ve Bağla'ya tıklayın. Düğme, kartın üzerine geldiğinizde görünür.

   

2. Clevera'yı GitHub'da yetkilendirin#

   GitHub sizden Clevera AI uygulamasını yetkilendirmenizi ister. Clevera'nın ait olduğunuz hesapları listeleyebilmesi için kuruluş üyeliklerinize okuma erişimi talep eder. Yetkilendir'e tıklayın.

3. Uygulamayı depolarınıza yükleyin#

   GitHub daha sonra Clevera AI uygulaması yükleme sayfasını açar. Kişisel hesabınızı veya bir kuruluşunuzu seçin, ardından Tüm depolar veya Yalnızca seçili depolar'ı seçin. Uygulama şunları talep eder:

   GitHub izni	Neden
   İçerik: okuma ve yazma	Markdown dosyasını ve görsellerini oluşturmak ve güncellemek için
   Meta veriler: salt okunur	GitHub tarafından her uygulama için gereklidir; Clevera'nın depoları listelemesini sağlar

   Yükle'ye tıklayın. Yayınlamak istediğiniz her kuruluş için tekrarlayın.

4. Bağlantıyı kontrol edin#

   Entegrasyonlar sayfasına döndüğünüzde, GitHub, GitHub hesabınız veya kuruluş adınız ve bir Bağlandı rozeti ile Bağlandı listesine taşınır. Herhangi bir şey yayınlamadan önce "Henüz bir şey yayınlanmadı" yazar.

   

Daha sonra depo ekleyin veya kaldırın#

Clevera yalnızca uygulamanın yüklü olduğu depoları görür. Bunu değiştirmek için Entegrasyonlar'ı açın, GitHub'a tıklayın ve Erişim altında Depo erişimi'ne tıklayın. GitHub'da hesabı açın, Yapılandır'a tıklayın ve depo listesini değiştirin. Yeni depolar, Yayınla sekmesini bir sonraki açışınızda görünür.

Bir makale yayınlayın#

1. Yayınla sekmesini açın#

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

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

2. Hesabı, depoyu ve klasörü seçin#

   Nereye gidecek altında şunları seçin:

   Alan	Ne seçilmeli	Notlar
   Hesap	Kişisel hesabınız veya bir kuruluş	Yalnızca depolarınız birden fazla hesaba ait olduğunda gösterilir
   Depo	Dosya için depo	En son güncellenenler önce gelir. İlki sizin için seçilidir
   Klasör	docs veya articles/guides gibi bir yol	"Markdown dosyası burada oluşturulur. Depo kökü için boş bırakın." docs olarak başlar. Henüz var olmayan klasörler oluşturulur

   Clevera, bir sonraki sefer için seçtiklerinizi hatırlar.

   

3. Yayınla#

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

   İşlem devam ederken Paylaş penceresini kapatabilirsiniz; bittiğinde bir bildirim sizi bilgilendirir.

Dosya nereye gider#

• Dal: Deponun varsayılan dalı (genellikle main). Clevera doğrudan buraya commit yapar; bir pull request açmaz ve başka bir dal seçemezsiniz.
• 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 harflerine çevrilir ("Créer une facture" ifadesi creer-une-facture.md olur). Sadece emojilerden oluşan başlık gibi çevrilecek bir şeyi kalmayan başlıklar, bunun yerine kısa bir sabit 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>/ klasörüne gider.
• Commit mesajı: Add article: <title> veya mevcut bir dosyayı güncellediğinizde Update article: <title>.
• Commit yazarı: Entegrasyonu bağlayan GitHub hesabı.

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

Clevera, en üstte kısa bir ön bilgi bloğu ile GitHub tarzı Markdown yazar:

---
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 geldiği 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österin.

Görseller#

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

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

Bir doküman sitesi ile kullanın#

Bir depodan derleme yapan çoğu statik site oluşturucu (Docusaurus, MkDocs, Jekyll veya Hugo gibi), ön bilgilerden title değerini okur ve bilmedikleri alanları görmezden gelir. Yaygın bir kurulum:

1. Klasör'ü doküman sitenizin okuduğu klasöre yönlendirin, örneğin docs veya content/guides.
2. Her makaleyi orada yayınlayın; sitenizin normal derlemesi yeni commit'i alır.
3. Oluşturucunuzun GitHub uyarılarını, matematiği ve <details> öğesini oluşturup oluşturmadığını kontrol edin; bazıları uyarıları düz tırnak olarak gösterir.

Zaten yayınladığınız bir makaleyi güncelleyin#

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

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

Clevera'da başlık değişirse dosya adı da değişir, bu nedenle yayınlama işlemi eskisinin yanında yeni bir dosya oluşturur. Eski dosyayı GitHub üzerinde kendin sil veya yeniden adlandır.

Clevera'daki hiçbir şey depondan dosya silmez.

GitHub bağlantısını kes#

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

Bağlantıyı kesmek, Clevera'nın erişim belirtecini siler. Clevera'nın GitHub üzerindeki erişimini de kaldırmak için Clevera AI uygulamasını kaldır (GitHub Ayarlar → Uygulamalar → Yüklü GitHub Uygulamaları → Yapılandır → Kaldır) ve Yetkilendirilmiş GitHub Uygulamaları altındaki yetkilendirmeyi iptal et.

Sorun giderme#

İlgili#