Dokümantasyon › Bağlantılar
GitHub
Web sitenizin kurulduğu depoyu bağlayın. EOMA sizin inceleyip birleştirdiğiniz bir pull request açar, ana dalınıza asla yazmaz.
10 saniyede
- EOMA sizin seçtiğiniz depolara bir uygulama kurar ve yalnızca onların içinde çalışır.
- Her değişiklik
eoma/draft/…adlı kendi dalında bir pull request olarak gelir. Ana dalınıza asla yazılmaz. - Siz birleştirene kadar ziyaretçilerinize hiçbir şey ulaşmaz. O adım her zaman sizde kalır.
Başlamadan önce
- Web siteniz GitHub'daki bir Git deposundan kurulmuş olmalıdır. Siteniz WordPress ise onu bağlayın, bkz. Entegrasyonlar.
- Depoya bir uygulama kurma izniniz olmalı. Kişisel bir hesapta bu sizsiniz; bir organizasyonda bir sahip ya da bir sahibin onayladığı biri.
- EOMA'da markanın sahibi olmanız gerekir, aksi halde satır "Yalnızca sahip" gösterir.
Adımlar
1. Bağlayın düğmesine basın ve depoları seçin
Ayarlar → Entegrasyonlar → Yayınlama · CMS & siteler grubu → GitHub satırı.
┌─ Ayarlar ──────────────────┬──────────────────────────────────┐
│ ÇALIŞMA ALANI │ Yayınlama · CMS & siteler │
│ Plan & Kullanım │ WordPress [ Bağlayın ] │
│ ● Entegrasyonlar ← burası │ GitHub [ Bağlayın ] ← │
└────────────────────────────┴──────────────────────────────────┘
Bağlayın sizi GitHub'ın kendi kurulum ekranına gönderir. GitHub hangi hesaba ya da organizasyona kurulacağını sorar, sonra all repositories ("tüm depolar") mı yoksa only select repositories ("yalnızca seçili depolar") mı yetkilendireceğinizi sorar. only select repositories seçeneğini seçin ve sitenizin kurulduğu depoyu seçin. Bu sayfadaki en önemli karar budur: sonrasında olan her şeyin sınırıdır.
2. Depoyu ve dalı seçin
EOMA'ya döndüğünüzde satır Depo seç gösterir. Basıldığında Repo Seçin açılır, yani erişim verdiğiniz depoların listesi ve altında bir Branch ("Dal") açılır menüsü.
Seçtiğiniz dal taban daldır: EOMA'nın karşılaştırdığı ve pull request'lerini yönelttiği dal.
Sitelerin çoğunda bu main dalıdır ve sizin için zaten seçilidir. Save ("Kaydet") düğmesine
basın.
3. Bir işi onaylayın ve GitHub'ı seçin
Bağlamak EOMA'ya gidecek bir yer verir. Kendi başına hiçbir şey göndermez. İlk pull request, Aksiyonlar ekranında bitmiş bir taslağı onaylayıp hedef olarak GitHub'ı seçtiğinizde ortaya çıkar.
Ne göreceksiniz
GitHub satırı ve "Bağlayın" düğmesi
Yayınlama · CMS & siteler grubunda, ikinci satır. Sahip olmayanlar düğmenin yerinde Yalnızca sahip görür.
GitHub'ın kendi kurulum ekranı
EOMA'nın parçası değildir. Depo erişiminin verildiği yer burasıdır ve sonradan değiştirilebileceği tek yer de burasıdır.
"Select Repository", depo listesi ve "Branch"
Yetkilendirdiğiniz her depo için bir satır, tam adını ve varsayılan dalını gösterir. Seçimin altında bir Branch açılır menüsü. Sol altta şunu okuyan bir bağlantı: "Don't see your repo? Manage repository access on GitHub →" ("Deponuzu göremiyor musunuz? Depo erişimini GitHub'da yönetin").
Bir depo seçildikten sonraki satır
Düğmenin yerini owner/repo · branch alır, yanında Depoyu değiştir ve Bağlantıyı Kes
bulunur. Depoyu değiştir aynı seçiciyi yeniden açar, bağlantıyı kesip baştan başlamadan başka bir
depoya geçebilirsiniz.
Pull request, GitHub'da
EOMA'da değil. eoma/draft/<id> adlı bir dal, değişen dosyalar ve taban dalınıza yöneltilmiş bir
pull request. EOMA bağlantıyı aksiyonun üzerine de geri gönderir, böylece iki taraftan da
açabilirsiniz.
Sayıları okumak
EOMA tam olarak ne yazar. Etki alanı budur ve bilerek dardır:
| EOMA şunu yapar | EOMA şunu yapmaz |
|---|---|
eoma/draft/<aksiyon id> adlı bir dala commit atar, her iş için bir dal |
main dalına ya da seçtiğiniz taban dala commit atmaz |
| O işin ürettiği tek dosyayı yazar | Başka hiçbir dosyaya dokunmaz, hiçbir şeyi silmez |
| O daldan taban dalınıza bir pull request açar | Onu birleştirmez, onaylamaz ya da kapatmaz |
| Doğru yolu ve mevcut dosyayı bulmak için depoyu okur | Erişim vermediğiniz depoları okumaz |
| Bir işi yeniden yaptığında kendi taslak dalını taban dalınıza geri sıfırlar | Force-push yapmaz, geçmişi yeniden yazmaz, eoma/draft/… dışındaki hiçbir dalı değiştirmez |
EOMA bu çizgilerin içinde bir şeyi yapamıyorsa durur ve size söyler. İkinci bir yolu yoktur.
"Don't see your repo?" ("Deponuzu göremiyor musunuz?") Seçici yalnızca uygulamaya yetki verilenleri listeler. Listede olmayan bir depo bozuk değildir, GitHub'da yaptığınız seçimin dışında kalmıştır. Bağlantı sizi seçimi genişleteceğiniz sayfaya götürür. Önce bağlantıyı kesmeniz gerekmez.
Dal listesi gerçek dal listenizden kısa olabilir. EOMA en fazla 100 dal okur. Varsayılan dalınız her zaman en üsttedir ve her zaman seçilebilir, dolayısıyla yüzlerce dalı olan bir depo yine de çalışır; nadiren kullanılan bir dal görünmeyebilir. Eksik olan birine ihtiyacınız varsa desteğe söyleyin.
Dosyanın indiği yer. EOMA yolu işin türünden seçer: bir blog yazısı
content/blog/<ad>.md dosyasına, bir sayfa content/pages/<ad>.md dosyasına, llms.txt
dosyanız deponun köküne gider. Yapılandırılmış veri parçaları content/schema/ altına gider.
Deponuz farklı düzenlenmişse ilk yayından önce söyleyin, yollar marka bazında ayarlanabilir,
yanlış klasördeki bir pull request'i kapatmak kolaydır ama hiç açmamak daha kolaydır.
"Reponda pull request açılır, merge size kalır". Onayladığınızda göreceğiniz satır. Ardından gelen onay aynı üç gerçeği açıkça yazar: EOMA pull request'i açar ve doğrudan hiçbir şey yazmaz, değişikliği satır satır görürsünüz, siz birleştirene kadar hiçbir şey yayına girmez.
Bağlantıyı kesmek kurulumu kaldırır. Bağlantıyı Kes düğmesine basmak, EOMA'nın uygulamasını EOMA içindeki bağlantıyla birlikte GitHub hesabınızdan da kaldırır. Zaten açılmış dallar ve pull request'ler oldukları yerde kalır, onlar sizindir. Kendi hızınızda silebilir ya da birleştirebilirsiniz.
Bir şeyler ters giderse
| Gördüğünüz | Nedeni | Ne yapmalı |
|---|---|---|
| Bağlayın düğmesi yerine "Yalnızca sahip" | EOMA'da bu markanın sahibi siz değilsiniz. | Marka sahibinden bağlamasını isteyin. |
| Bağlandıktan sonra "No repositories found." ("Depo bulunamadı") | Uygulama kuruldu ama hiçbir depo seçilmedi ya da sitenizin sahibi olan hesaptan farklı bir hesaba kuruldu. | Manage repository access on GitHub seçeneğini kullanıp depoyu ekleyin. Hemen seçicide görünür. |
| Bir aksiyon yayın hedefinin yapılandırılmadığını söylüyor | GitHub bağlı ama hiç depo seçilmemiş. | Ayarlar → Entegrasyonlar → GitHub → Depo seç. |
| Pull request yanlış dala açılıyor | Bağlanma sırasında seçilen taban dal, sitenizin kurulduğu dal değil. | Depoyu değiştir, doğru dalı seçin ve kaydedin. Sonraki pull request onu kullanır. |
| Pull request doğru ama sitenizde hiçbir şey değişmiyor | Birleştirilmemiş. EOMA asla birleştirmez. | GitHub'da birleştirin. Normal dağıtımınız her zamanki gibi çalışır. |
| Birleştirdiniz ve aksiyon hâlâ devam ediyor görünüyor | EOMA'ya bir pull request'in birleştirildiği bildirilmiyor, bunu izleyen bir şey henüz yok. | Destekte söyleyin, aksiyon kapatılsın. Bu bizim tarafımızda bir kayıt tutma eksiğidir, değişikliğiniz yine de canlıdır. |
| Depo bir organizasyonda ve kurulum onay istiyor | GitHub yeni uygulamaları bir organizasyon sahibinin onaylamasını ister. | Bir sahip GitHub ayarlarından bir kez onaylar, sonra 2. adımdan devam edin. |
İlgili sayfalar
- Aksiyonlar · pull request'e dönüşecek işi onayladığınız yer
- Vercel · aynı depodan dağıtılan bir Vercel sitesi için
- WordPress · bunun yerine canlı yayınlayan hedef