Giriş
Geliştirmeye başlamadan önce aşağıdaki noktaları anlamanızı rica ediyoruz:- Overleaf resmi olarak bir dahili depoda geliştirilir ve topluluk sürümü overleaf/overleaf üzerinde yayımlanır. Dahili ve herkese açık depolar arasındaki kod senkronizasyonundan bir copybot sorumludur.
- Ayaka-notes/overleaf-pro, Overleaf topluluk sürümünün bir çatalıdır (fork). Bu projenin uzun ömürlü olmasını istiyoruz; bu nedenle katkıda bulunmadan önce lütfen kurallara uyun.
Commit Kuralları
- Lütfen mevcut Overleaf kodunda kapsamlı değişiklikler yapmayın. İşlevselliği mümkün olduğunca
services/web/modulesklasöründe toplayın. Bu, ileride kodu birleştirirken ve güncellerken iş yükümüzü en aza indirir. - Vibe coding gerçekten çok kolay bir yöntemdir, ancak projemizi kolayca dağınık hale getirip ileride bakımını imkânsız kılabilir; bu yüzden lütfen dikkatli kullanın.
- Lütfen geliştirme sırasında çeviriyle ilgili herhangi bir içerik eklemeyin; mümkün olduğunca mevcut çevirileri kullanın.
- Kesinlikle gerekli olmadıkça yeni ortam değişkenleri eklemekten kaçının. Gerekliyse, Overleaf toolkit’teki veya docs.overleaf.com adresindeki değişkenlerle mümkün olduğunca tutarlı olmalarını sağlayın.
Dal Kuralları
overleaf-pro geliştirmesi için aşağıdaki dalları kullanıyoruz:main: Bu dal yalnızca upstream kod senkronizasyonu için kullanılır, lütfen buraya harici değişiklikleri commit ETMEYİN. Bu daldace-v[X.x.x]gibi etiketler belirleriz; bu etiket, ilgili commit’in Overleaf Resmi Topluluk Sürümü’ndekiv[X.x.x]sürümüne karşılık geldiğini gösterir. Not: bu etiket değiştirilemez!server-pro: Bu dal, günlük geliştirme için varsayılan daldır.feature-X: Bu dal belirli bir özelliğin geliştirilmesi için kullanılır.release-vX.0.0: Sürüme özel daldır; yayımlamadan önce bazı acil düzeltmeler (hot-fix) yaparız.
Overleaf Pro için Dal Kuralları
GitHub Action
GitHub Action otomatik CI/CD’den sorumludur ve şunları içerir:- main dalının gecelik güncellenmesi
- Geliştirme için Docker imajı oluşturma
- Docker imajının yayımlanması
Soru&Cevap
Overleaf Community Edition X.0.0 için commit hash'ini nasıl bulurum?
Overleaf Community Edition X.0.0 için commit hash'ini nasıl bulurum?
Öncelikle Docker imajını çekmeniz ve bu imajdaki etiketleri incelemek için aşağıdaki komutu çalıştırmanız gerekir:Ardından commit’in (b0d05c0) upstream master dalında bulunup bulunmadığını kontrol edebilirsiniz.
bash
CE imajında 6.0.0 ile 6.0.1 arasında commit hash'i neden aynı?
CE imajında 6.0.0 ile 6.0.1 arasında commit hash'i neden aynı?
Bu beklenen bir davranıştır. 6.0.1 sürümü, 6.0.0 imajı üzerine inşa edilmiş küçük bir yama sürümüdür. Değişiklikler, imajı yeni bir commit’ten yeniden oluşturmak yerine mevcut 6.0.0 imajına yama uygulanarak yapılır. Bu nedenle imaj içindeki commit hash’i 6.0.0 ve 6.0.1 arasında aynıdır.Ayrıntılı bilgi için hotfix bölümüne bakın.