Makaleleri GitLab'da yayınla

GitLab'ı bir kez bağladığında, herhangi bir Clevera makalesini bir doküman sitesi, docs/ klasörü veya proje el kitabı için hazır olacak şekilde bir GitLab projesine Markdown dosyası olarak yayınlayabilirsin. Bu makale; bağlantı kurmayı, proje 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: GitLab'da yayınlama, Pro ve Custom planlarının bir parçasıdır. Free ve Starter planlarında Yayınla sekmesi "Araçlarınızda yayınlama Pro planına dahildir" uyarısını gösterir. Bkz. Plan seçin.
• Clevera'daki rol: GitLab'ı yalnızca çalışma alanı sahibi veya bir Yönetici bağlayabilir veya bağlantısını kesebilir. Bağlantı kurulduktan sonra, bir makaleyi düzenleyebilen herkes onu yayınlayabilir.
• Sadece GitLab.com: Clevera, GitLab.com'a bağlanır. Kendi kendine barındırılan (self-managed) GitLab sunucuları desteklenmez.
• GitLab'daki rol: Clevera, bağlanan hesabın Geliştirici veya daha yüksek bir role sahip olduğu projeleri listeler. Korumalı bir varsayılan dala commit yapmak için, o hesabın genellikle Maintainer (Bakımcı) olması gerekir (bkz. Korumalı dallar).
• Bir makale: Bir videoya veya kayda ait olan makaleyi yayınlarsın. Önce onu oluştur; bkz. Bir kaydı makaleye dönüştürün.

Yayınlama işlemi kredi harcamaz.

GitLab'ı 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 GitLab'ı bul ve Bağla'ya tıkla.

2. GitLab'da oturum aç ve yetkilendir#

   Henüz yapmadıysan GitLab.com'da oturum aç. GitLab, Clevera'yı şu kapsamlarla yetkilendirmeni ister:

   GitLab kapsamı	Neden
   api	GitLab'ın dosya API'si, dosyaları oluşturmak ve güncellemek için buna ihtiyaç duyar
   read_user	GitLab kullanıcı adını Clevera'da göstermek için
   read_repository	Bir dosyanın zaten var olup olmadığını kontrol etmek için
   write_repository	Markdown dosyasını ve görsellerini commit etmek için

   Yetkilendir'e tıkla.

3. Bağlantıyı kontrol et#

   GitLab kullanıcı adının takip ettiği "GitLab başarıyla bağlandı" mesajıyla Entegrasyonlar sayfasına dönersin. GitLab, 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 GitLab 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. Projeyi ve klasörü seç#

   Nereye gidecek altında şunları seç:

   Alan	Ne seçilmeli	Notlar
   Depo	Dosya için GitLab projesi	Geliştirici veya daha yüksek yetkiye sahip olduğun, en son güncellenen projeler başta gelir. İ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 seçtiklerini hatırlar.

   

3. Yayınla#

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

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

Dosya nereye gider#

• Dal: Projenin varsayılan dalı (genellikle main). Clevera doğrudan buraya commit yapar; bir merge request açmaz ve başka bir dal seçemezsin.
• Dosya adı: Küçük harflerle başlık, boşluklar tireye 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 bir başlık gibi çevrilecek hiçbir şeyi kalmayan bir başlık, 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>/ klasörüne gider.
• Commit mesajı: Add article: <title> veya mevcut bir dosyayı güncellediğinde Update article: <title>.
• Commit yazarı: Entegrasyonu bağlayan GitLab hesabı.

Korumalı dallar#

GitLab, varsayılan dalı varsayılan olarak korur ve genellikle sadece Maintainer'lar (Bakımcılar) buraya push yapabilir. Bağlı hesap bir Geliştirici ise, commit "GitLab commit'i reddetti: Geliştirici erişimi veya daha yükseği gerekir ve dal korumalı olmamalıdır" hatasıyla reddedilir. Ya o hesaba Maintainer rolü ver ya da projedeki Ayarlar → Depo → Korumalı dallar kısmından Geliştiricilerin push yapmasına izin ver.

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

Clevera, GitLab'ın işlediği Markdown'ı, en üstte kısa bir front matter bloğu ile 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ına projenize commit edilir ve Markdown onlara göreceli yolla (assets/<file name>/…) bağlantı verir. Clevera olmadan da çalışmaya devam ederler ve özel bir projede, projenin geri kalanı kadar özel kalırlar.

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

Bir doküman sitesiyle kullan#

GitLab Pages veya başka bir statik site oluşturucu (MkDocs, Docusaurus veya Hugo gibi) dokümanlarını projeden oluşturuyorsa, Klasör'ü okuduğu klasöre yönlendir. Her yayınlama normal bir commit'tir, bu yüzden pipeline'ın 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 sadece tek yönlüdür. Clevera'da yaptığın düzenlemeler, tekrar yayınlayana kadar Clevera'da kalır ve GitLab'daki dosyada yapılan değişiklikler asla Clevera'ya geri dönmez.

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

Başlık Clevera'da değiştiyse, dosya adı da değişir, bu yüzden yayınlama eski dosyanın yanında yeni bir dosya oluşturur. Eski dosyayı GitLab'da kendin sil veya yeniden adlandır. Clevera'daki hiçbir şey projenden dosya silmez.

GitLab bağlantısını kes#

1. Entegrasyonlar'ı aç, GitLab satırındaki ⋯ menüsüne tıkla ve Bağlantıyı kes'i seç (veya GitLab'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 GitLab'da kalır."

Bağlantıyı kesmek Clevera'nın token'larını siler. Clevera'nın GitLab'daki erişimini de kaldırmak için, GitLab avatar menünü aç → Profili düzenle → Uygulamalar, Yetkili uygulamalar altında Clevera'yı bul ve Yetkiyi kaldır'a tıkla.

Sorun giderme#

İlgili#