> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/tr/bilgi-bankasi/044-github-synchronization.md). # GitHub Eşitlemesi **GitHub Senkronizasyonu** bir [premium özellik](/latex/tr/bilgi-bankasi/120-overleaf-premium-features.md). Overleaf premium özellikleri şu katılımcılara sunulur [Overleaf Commons](https://www.overleaf.com/for/universities), grup üyelerine [abonelikler](https://www.overleaf.com/for/groups), ve bireysel [abonelikler](https://www.overleaf.com/user/subscription/plans). Özet GitHub Senkronizasyonu özelliği, Overleaf projelerinizi doğrudan Overleaf projeniz için uzak depo görevi gören bir GitHub deposuna bağlamanıza ve aralarında değişiklikleri gönderip almanıza olanak tanır. GitHub senkronizasyonu yalnızca [GitHub.com](https://www.github.com) ile kullanılabilir ve diğer GitHub kurumsal kurulumlarına bağlanmak için kullanılamaz. Bir Overleaf projesini bir GitHub deposuyla, ya mevcut bir GitHub deposundan yeni bir Overleaf projesi oluşturarak ya da mevcut bir Overleaf projesinden yeni bir GitHub deposu oluşturarak senkronize edebilirsiniz. Mevcut bir Overleaf projesini mevcut bir Github deposuyla senkronize etmek mümkün değildir. * GitHub Senkronizasyonu, GitHub hesabınızı Overleaf hesabınıza bağlayarak etkinleştirilir * Yeni projeler mevcut GitHub depolarından oluşturulabilir * Depolar, mevcut Overleaf projelerine dayanarak GitHub'da oluşturulabilir * Bağlı projeler ve depolar, şu yöntem kullanılarak eşitlenmiş halde tutulur **GitHub** projedeki **Menü** ### Overleaf hesabınızı GitHub hesabınıza bağlama GitHub Senkronizasyonu özelliğini kullanabilmek için Overleaf hesabınızı GitHub hesabınıza bağlamanız gerekir. Bunu Overleaf [Hesap Ayarları](https://www.overleaf.com/user/settings). Lütfen, hesabınızla ilişkili belirli depolara veya organizasyonlara bağlanabilme yeteneğinin, GitHub'da yapılandırılmış izin ayarlarına bağlı olabileceğini unutmayın. ### GitHub deposundan yeni bir Overleaf projesi oluşturma Yeni Proje menüsünden GitHub seçeneğini seçebilirsiniz. Bu, GitHub izin ayarlarınıza göre GitHub hesabınız aracılığıyla Overleaf'in görebildiği depoların bir listesini size sunar. ![Yeni GitHub oluştur.png](/files/3290be312e1c4b75be2c8a9869eddfe032923e99) Mevcut bir GitHub deposundan yeni bir Overleaf projesi oluştururken dikkat edilmesi gereken bazı noktalar. * Overleaf projelerine uygulanan boyut kısıtlamaları vardır; bunlar daha büyük GitHub depolarının bir proje oluşturmak için kullanılmasını engelleyebilir. Lütfen [bu sayfa](/latex/tr/bilgi-bankasi/119-overleaf-plan-limits.md) Overleaf projesindeki dosya boyutu ve dosya sayısı üzerindeki sınırlamalara genel bakış için * Overleaf projeleri Git alt modüllerini veya Git LFS'yi desteklemez. ### Overleaf projesinden yeni bir GitHub deposu oluşturma Overleaf Projesi menüsünden, Eşitleme seçeneklerinden biri olarak GitHub'ı seçebilirsiniz. Bu, Overleaf projenizle eşitlemek üzere yeni bir GitHub deposunun adını verebileceğiniz bir iletişim kutusu sunar. ![Proje menüsü github.png](/files/3236e05443e09fc85803691b10fcb398396f02b8) ### GitHub ile Senkronizasyon GitHub ile Overleaf arasındaki senkronizasyon otomatik olarak gerçekleşmez, senkronizasyon seçenekleri tıklanarak gösterilir **GitHub** projedeki **Menü**. O sırada GitHub penceresi, GitHub'dan alınacak yeni değişiklikler olup olmadığını bildirir. Size her zaman değişiklikleri GitHub'a gönderme seçeneği sunulur (not: bu seçenek, Overleaf ve GitHub güncel olsa bile gösterilecektir). ![GitHub iletişim kutusunun görüntüsü](/files/0a9dd65f79a8436f02a7c2f17bbecfc34b17014b) GitHub'a Overleaf değişikliklerini gönder düğmesine tıklandığında GitHub'a commit'ler oluşturulur. Bu sırada isteğe bağlı bir commit mesajı sağlanabilir. * GitHub'dan gelen Overleaf geçmişindeki değişiklikler, anonim tarafından yazılmış olarak gösterilir. * Overleaf'ten gelen GitHub geçmişindeki değişiklikler, bağlı GitHub hesabı sahibinin yazdığı olarak gösterilir. ### Birleştirme çakışmalarını çözme Hem Overleaf'te hem de GitHub'da değişiklikler yapıldığında Git'in bunları otomatik olarak nasıl birleştireceğini anlamaması mümkündür. Örneğin, işbirlikçiniz Overleaf'te bir satırı değiştirdiyse ve siz de GitHub deposundaki aynı satırı değiştirdiyseniz, Overleaf hangi sürümün tutulacağına karar veremeyebilir. Bu olduğunda, ana dalınıza birleştirmek yerine deponuza yeni bir dal göndeririz. Bu dal açıklayıcı bir ada sahip olacaktır (dalın oluşturulma tarih ve saatini içerir) ve belgenin Overleaf'teki sürümünü içerir. GitHub ile senkronize etmeye çalıştığınızda, çözülmesi gereken bir birleştirme çakışması olduğunu bildiren bir mesaj gösterilir. ![GitHub birleştirme çakışması iletişim kutusu](/files/8ca2d1fd7a541e1b72100b9cb3717d7221bc70ec) Yeniden senkronize olmak için Overleaf dalını ana (varsayılan) dalınızla birleştirmeniz gerekir. Bunu bilgisayarınızda her iki dalı çekip git ya da başka bir araçla birleştirerek yapabilir, ardından sonucu tekrar Github'a gönderebilirsiniz. Alternatif olarak, Overleaf dalından bir pull request oluşturarak ve onların çakışma çözme özelliğini kullanarak birleştirmeyi doğrudan Github üzerinde de yapabilirsiniz. Her iki yaklaşım da [Github belgelerinde](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts). ### GitHub organizasyonlarınızdaki depolara erişme Overleaf projelerini bağlı GitHub hesabınızla ilişkili depolarla senkronize edebilirsiniz ve üyesi olduğunuz GitHub organizasyonlarındaki projelerle de senkronize edebilirsiniz. İlişkili GitHub organizasyonlarınızdaki depolarla senkronize edebilmek için, bu organizasyonların Overleaf OAuth uygulaması tarafından erişilebilir olma izni vermesi gerekir. * Bir organizasyon üyesiyseniz, açıklanan adımları izleyebilirsiniz [burada](https://help.github.com/articles/requesting-organization-approval-for-oauth-apps/) Overleaf uygulamasının organizasyonunuza erişim isteğinde bulunmak için. * Organizasyon sahibiyseniz, açıklanan adımları izleyebilirsiniz [burada](https://help.github.com/articles/approving-oauth-apps-for-your-organization/) Overleaf uygulamasını organizasyon için onaylamak amacıyla. ### GitHub Senkronizasyonu dosya sınırları Overleaf projeleri, aşağıda belirtildiği gibi projedeki toplam dosya sayısına ilişkin sınırların yanı sıra tekil boyut sınırlamalarına tabidir [burada](/latex/tr/bilgi-bankasi/119-overleaf-plan-limits.md). Git kendi başına tek bir committe binlerce dosyanın değiştirilmesini işleyebilse de, Overleaf'in GitHub senkronizasyon özelliğinin kullandığı GitHub API de gönderilebilecek veya alınabilecek dosya sayısına sınırlamalar getirir. GitHub senkronizasyonu kullanılıyorsa, tek bir committeki dosya sayısını 100'ün altında, genel proje boyutunu ise 100 MB'den küçük tutmanız önerilir. Bu boyutların üzerindeki projeler çalışabilir, ancak olası senkronizasyon sorunlarını önlemek için bu sınırlar içinde kalmanızı öneririz. ### Bir projeyi bir depodan ayırma Tek bir mevcut GitHub deposundan birden fazla proje oluşturmak mümkün olsa da, **belirli bir projeyle ilişkili depoyu değiştirmek mümkün değildir**. Bir proje bir depoya bağlandıktan sonra bağlantısı kaldırılamaz ve yeni bir depo oluşturmak için kullanılamaz. Belirli bir projeden yeni bir depo oluşturmanız gerekiyorsa, projenin yeni bir kopyasını oluşturmalı ve ardından yeni depoyu bu kopyadan oluşturmalısınız. ### Bilinen Sınırlamalar **Dallar**: Overleaf Git sistemi dallanmayı desteklemez. **Sembolik bağlantılar**: Overleaf Git sistemi sembolik bağlantıları desteklemez. Bir sembolik bağlantı Overleaf projesine gönderilebilir, ancak normal bir dosyaya dönüştürülür ve proje bir sonraki çekildiğinde yerel sembolik bağlantının üzerine yazılır. **Dosya İzinleri**: Overleaf Git sistemi yürütme izinlerini korumaz. GitHub senkronizasyonuyla çalışırken, GitHub'daki yürütme biti olan herhangi bir dosya Overleaf'e senkronize edilirse, dosya izinlerini sıfırlamak için Overleaf tarafından otomatik bir commit tetiklenir. **Git LFS**: Overleaf projeleri Git LFS'yi desteklemez. **Git Alt Modülleri**: Overleaf projeleri diğer depolar içinde Git alt modülü olarak davranabilir, ancak başka Git alt modülleri içeremez. Diğer projelerden dosyalara başvurmak için, başka bir projeden ekle özelliğinin kullanılması önerilir. **Değişiklikleri İzleme ve Yorumlar**: Ne yazık ki, GitHub'dan Overleaf'e yapılan çekmeler izlenen değişikliklerin ve yorumların kaybolmasına veya yerlerinin değişmesine neden olabilir; bu nedenle, GitHub'da aktif çalışma ile izlenen değişiklikler ve/veya yorumların kullanımını birlikte yürütmenizi önermiyoruz. **GitHub Enterprise veya GitLab ile Doğrudan Senkronizasyon:** Overleaf'in kullandığı GitHub API yalnızca github.com üzerinde barındırılan depolara bağlanabilir. Kullanarak başka sağlayıcılarda barındırılan projelerle dolaylı olarak senkronize olabilirsiniz [Overleaf Git entegrasyonu](/latex/tr/bilgi-bankasi/040-git-integration.md) özelliğini kullanmak isteyebilirsiniz. **Mevcut bir projeyi mevcut bir depoya bağlama**: Mevcut bir Overleaf projesini mevcut bir Github deposuyla eşitlemek mümkün değildir. **GitHub'a yapılan gönderilerin yazarlığı**: Overleaf'in bildiği tek Github kullanıcısı, GitHub hesabı Overleaf hesabına bağlı olan ve o projenin sahibi olan kullanıcıdır. Tüm commit'ler, açıkça o kullanıcının kimliğiyle bu commit'leri yapan bir GitHub API'si kullanılarak yapılır. Bu nedenle tüm commit'ler GitHub Git geçmişinde bağlı kullanıcıdan geliyormuş gibi görünür. Overleaf'in geçmişinde değişiklikler "Anonymous (via GitHub)" olarak gösterilir. **Git geçmişi ve Overleaf geçmişi:** Overleaf tarafındaki değişiklikler, GitHub commit'leriyle bire bir eşleşmez. Overleaf tarafında birden çok kullanıcı değişiklik yapabilir, ancak senkronizasyon tetiklendiğinde bu değişiklikler GitHub'a bağlı kullanıcı altında tek bir commit halinde paketlenir. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/tr/bilgi-bankasi/044-github-synchronization.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.