Kişiler
Kişilerinizi yönetin
Kişilerinizi yönetin
Bu sayfada, nasıl Kişiler katkıcısı olabileceğinizi öğrenebilirsiniz. Bu uygulamayla ilgili genel bilgi almak istiyorsanız, lütfen GNOME İçin Uygulamalar sayfasına uğrayın.
Uygulamalardaki özgün metin genellikle Amerikan İngilizcesi ile yazılır. Diğer dillere çeviri, çevirmenlerce ayrıca eklenebilir. Çeviri genellikle uygulamaların kullanıcı arayüzünün yanı sıra Yazılımlar ya da apps.gnome.org gibi yerlerde gösterilen üst verileri de kapsar. Bu bağlamda kullanılan yaygın kısaltmalar l10n (yerelleştirme, İngilizce “localization”) ve i18n (uluslararasılaştırma, İngilizce “internationalization”) biçimindedir.
Bu uygulama, Damned Lies olarak adlandırılıan GNOME çeviri sistemi üzerinden çevirilmiştir.
Sorun bildirirken ya da özellik önerirken, bildirinin uygulamanın en son sürümüne dayandarılması yararlı olabilir. Bu doğrultuda, aşağıdaki kurulum yöntemlerini gözden geçirebilirsiniz.
Sorun bulduysanız ya da değişiklik önermek istiyorsanız, önce Kişiler uygulamasının en son sürümünü denediğinizden emin olmaya çalışın. Kullandığınız sürümü uygulamanın “Hakkında” bölümünden denetleyebilirsiniz.
Flathub’da en son 46.0 sürümü yayınlanmıştır.
Bu uygulama, güncel geliştirme durumunun bir sürümünü kurmaya izin verir. Bu tür kurulumlar geleneksel olarak her gece üretilir ve “gecelik inşa” olarak adlandırılırdı. Şimdilerde ise, genellikle ana geliştirme sürümü değiştiğinde yeniden üretilirler.
Uyarı: Uygulamaların gecelik inşaları yalnızca sınama amaçlı kullanılmalı, gerçek işler için kullanılmamalıdır. Sisteminizdeki uygulamanın gecelik inşalarını, uygulamanın simgesindeki ve başlık çubuğundaki çizgilerden ayırt edebilirsiniz. Genellikle, bu uygulamanın diğer kurulumlarından başka yapılandırma kullanırlar. Ancak, bu uygulamaların kurulumunun amaçlandığı gibi çalışacağının garantisi yoktur. Yedekleriniz olmadan asla uygulamaların gecelik inşalarıyla verileriniz üzerinde çalışmayın.
Gecelik sürüm, eğer gecelik depo önceden yapılandırılmışsa Konsol üzerinden de kurulabilir.
$ flatpak install gnome-nightly org.gnome.Contacts.Devel
$ flatpak run org.gnome.Contacts.Devel
Kararlı sürüme ulaşmadan önce sorunları ve gerilemeleri yakalamak bir proje için çok değerlidir. Yaklaşan sürümleri deneyerek bu konuda yardımcı olabilirsiniz.
Bu, özellikle hataları bulma ve çözmeye ayrılmış özellik dondurma sürecinde yararlıdır.
Bunu, uygulamanın gecelik inşasını deneyerek yapabilirsiniz.
Sanal makine olarak kurabileceğiniz GNOME OS Gecelik’te de Çekirdek uygulama olarak önceden kuruludur.
Birçok uygulama için sorun izleyici, uygulama geliştirmenin eş güdümü için ana yerdir. Yalnızca var olan tüm sorunları izlemek için değil, aynı zamanda yeni özellikleri ve diğer türlü görevleri planlamak için de kullanılır.
Uygulamayı kullanırken bulduğunuz sorunları bildirmek, uygulama bakımcıları için çok değerli olabilir. Ancak, sorun bildirilerini işlemek de önemli ölçüde zaman alabilir. Aşağıdaki adımları deneyerek işin bir bölümünü üstlenebilirsiniz:
Sorunun daha önce bildirilip bildirilmediğini öğrenmek için sorun izleyicide arama yapın.
Sorunun uygulamanın en son sürümünde de olup olmadığını denetleyin.
Yapılabiliyorsa, sorunun tam olarak hangi koşullar altında ortaya çıktığını bulmaya çalışın.
İlgili davranışı ortaya çıkaran uygulama sürümü gibi olası tüm ilgili bilgileri bildirin.
Sorunun tam nedenini bulmak, özellikle “Tanı Gerekli” ya da “Bilgi Gerekli” gibi etiketlerle imlenmiş sorunlar için çok önemli bir iş olabilir. Bildirilen sorunu kendiniz yeniden üretebiliyorsanız, yani tetikleyebiliyorsanız, daha derinlere inmeyi de deneyebilirsiniz. Bu, sorunun tam olarak hangi koşullar altında ortaya çıktığını bulmaktan, uygulamayı hata ayıklama çıktısı etkinleştirilerek çalıştırmaya, sorunu daraltan hata ayıklama çıktılarını koda eklemeye kadar gidebilir.
Çoğu uygulama, özellik isteklerini de sorun izleyici aracılığıyla ele alır. Özelliklerin uygulamaya konması ve gelecekte kod tabanının parçası olarak sürdürülmesinin önemli ölçüde ek çalışma gerektirebileceğini unutmayın. Dolayısıyla, yeni özelliğin bu uygulamanın parçası olacak kadar ilgili olup olmadığını göz önünde bulundurmalısınız.
Yeni özellik önerirken, uygulamanın sorunu nasıl çözmesi gerektiğine ya da bunun uyarlamasının tam olarak nasıl görüneceğine değil de, özelliğin hangi pratik sorunu çözmesi gerektiği konusuna odaklanmak daha yararlı olacaktır. Dilenirse, bu özelliğe gerek duyduğunuz pratik örnek de verebilirsiniz.
Sorun izleyici, üstesinden gelebileceğiniz açık görevler bulmanıza da yardımcı olabilir. Yeni özelliği uygulamaya koymadan önce, bu özellik için birleştirme isteklerinin onaylanıp onaylanmayacağını bakımcılarla görüşerek doğrulamak genellikle iyi bir fikir olacaktır.
Bu uygulamada “Yeni Gelenler” etiketiyle imlenmiş görevler de bulunmaktadır. Bu görevler genellikle daha az ön bilgi gerektirir ya da daha az karmaşıktır.
İster yazım hatasını düzeltmek, ister kullanıcı arayüzünü değiştirmek, isterseniz de uygulamanın kodu üzerinde çalışmak isteyin, aşağıdaki bilgiler başlamanıza yardımcı olacaktır. İlk adım, uygulamanın bilgisayarınızda inşa edilmesini sağlayarak kendi değişikliklerinizle oynamanızı sağlamak olacaktır. Daha sonra, ilgili görevlerin nasıl yapılacağına ilişkin verilen belgeleri inceleyebilirsiniz. Sonraki bölüm size değişikliklerinizi nasıl göndereceğinizi gösterecektir.
Uygulamada daha büyük çaplı değişiklik ya da ekleme yapmayı düşünüyorsanız, bu değişikliğin onaylanıp onaylanmayacağını öğrenmek için uygulamanın bakımcılarıyla görüşmek genellikle iyi bir fikir olacaktır. Bunun için öncelikle, ilk gerçekleştirme adımlarını atarak elinizdeki görevin üstesinden gelebileceğinize kendinizi inandırmalı ve ardından sorun izleyicisi aracılığıyla bakımcılarla görüşmelisiniz. Bu aynı zamanda projenin katkınızı onaylayabilecek etkin bir bakımcısı olup olmadığını denetlemek için de iyi bir yoldur. En iyi çabalarımıza karşın, tüm projelerin bakımı her zaman sürekli olarak yapılamamaktadır.
Birçok topluluk üyesi takıldığınızda size yardımcı olmaktan mutluluk duysa da, çoğu zaman bir katkıda bulunurken size kılavuzluk edebilecek kaynakları bulunmayabileceğini unutmayın.
Var olan GNOME uygulaması üstünde çalışmaktan çekiniyorsanız, önce öğrenme amacıyla kendi uygulamanızı oluşturmaya da bakabilirsiniz.
Uygulamada değişiklik yaparken genellikle uygulamayı değişiklikleriyle birlikte bilgisayarınızda inşa etmek ve sınamak istersiniz. Bu işlem, çoğu uygulama için Builder uygulamasını kullanarak kolaylaştırılabilir.
Builder’ı başlattıktan sonra projeyi klonlamayı seçebilirsiniz. Bu, uygulamayı bilgisayarınıza indirecektir.
Depo konumunu girmeniz gerekir. Doğru URL’yi aşağıdan kopyalayabilirsiniz.
İnternet bağlantınıza ve projenin boyutuna bağlı olarak, projeyi klonlamak biraz uzun sürebilir. Builder, bu adımı tamamladıktan sonra proje penceresi açılmalıdır. Bazı gerekli bağımlılıkların kurulumunu onaylamanız gerekebilir. Uygulamayı başarıyla inşa edip başlatıp başlatamayacağınızı denemek için şimdi “Projeyi Çalıştır” düğmesine basabilirsiniz.
Her şey yolunda giderse, uygulama sorunsuzca inşa edilmelidir. İnşa tamamlandıktan sonra, inşa edilen uygulama kendiliğinden başlamalıdır.
Bu uygulama Vala programlama diliyle yazılmıştır.
Vala diline başlamak için, Vala Eğitimini ya da Vala’yı da kapsayan Yeni Başlayanlar Eğitimini öneririz. Diğer önemli kaynakları aşağıda bulabilirsiniz.
Projede değişiklikler yaptıktan sonra bunları incelenmesi için gönderebilirsiniz. Amacımız birleştirme isteği ya da gönderim isteği denilen şeyi oluşturmaktır. Bu, bir projenin kodunda ve verilerinde değişiklik önermek anlamına gelir.
Projenin barındırıldığı GNOME GitLab üzerinde bazı hazırlıklarla başlıyoruz. Bu işlem, ilk kez yapıyorsanız oldukça karmaşıkmış gibi görünebilir ancak zamanla alışırsınız.
İlk adım, henüz yoksa yeni GNOME GitLab hesabı açmanızdır. Yalnızca bağlantıdaki formu doldurmanız yeterli.
Ardından, bilgisayarınızdaki git’in GNOME GitLab hesabınızı da kullanabilmesini istiyoruz. Bunun için SSH anahtarı gerekli. Henüz SSH anahtarınız yoksa Konsol uygulamasını kullanarak yenisini oluşturabilirsiniz. Ayrıca, Parolalar ve Anahtarlar uygulamasını kullanarak da anahtar oluşturabilirsiniz.
Şimdi, genel SSH anahtarınızı GNOME GitLab üzerindeki “SSH Anahtarları” ayarına eklemeniz gerekir. Genel SSH anahtarları ev dizininizdeki .ssh klasöründe sonu .pub ile biten dosyalar olarak saklanır. Tüm genel SSH anahtarlarınızı cat ~/.ssh/*.pub komutu ile yazdırabilirsiniz. Ayrıca Parolalar ve Anahtarlar uygulamasını kullanarak da genel SSH anahtarlarını görüntüleyebilirsiniz.
Projeye değişiklikler önermek için, ilk önce GNOME GitLab üzerinde kendi kopyanızı oluşturmanız gerekir. Bu kopyanın oluşturulması çatallama olarak da geçer. Değişikliklerinizi yüklemek için kendi kopyanıza - ya da çatalınıza - gereksineceksiniz.
Kişiler, GNOME GitLab sayfasından çatallanabilir. Bunu, üstünde çalıştığınız her proje için yalnızca bir kez yapmalısınız.
Şimdi, bu URL aracılığıyla yerel projenizdeki git’e GNOME GitLab üstündeki kişisel kopyanızı bildirmemiz gerekiyor. Bunun için komut satırına geri dönmeliyiz. İlk olarak, üzerinde çalıştığınız dizine geçmeniz (cd) gerekiyor. Ardından şu komutu kullanabilirsiniz
$ git remote add my-copy <ssh-fork-url>
burada <ssh-fork-url> bir önceki adımda baktığınız SSH URL’si ile değiştirilmelidir.
Şimdi git ile çalışırken daha sıradan görevlere geliyoruz.
İlk önce, başka dal olarak adlandırdığımız yere geçmek istiyoruz. Dallar, örneğin gerçekte kullanılan koda girmeye uygun oluncaya dek bir özelliği geliştirebileceğiniz özgün kodun türevleridir. Bunu yapmak için şunu çağırabilirsiniz
$ git checkout -b my-changes
burada my-changes üzerinde çalıştığınız konunun boşluksuz kısa açıklamasıdır.
Ardından, git ile yaptığınız değişiklikleri kaydetmek istiyoruz. Bu genellikle işleme oluşturmak olarak adlandırılır. Bunu şu komutla yapabilirsiniz
$ git commit -am "Commit Message"
İşleme iletileri değişikliklerinizi açıklamalıdır. Uygun bir işleme iletisi seçme ile ilgili daha çok bilgi edinebilirsiniz.
Şimdi, kaydettiğiniz değişiklikleri GitLab’e iletmemiz gerekiyor. Önceki bölümde git remote add kullanarak tüm kurulumu zaten yapmıştık. Şimdi geriye kalan tek işlem şunu çağırmak
$ git push my-copy
İşte sonunda son adıma geldik. Önceki git push komutumuzdan sonra Konsol’daki çıktıyı incelerseniz, büyük olasılıkla gönderim ya da birleştirme isteği oluşturmanın yolunu gösteren web sitesi bağlantısı göreceksiniz. Üzerine tıklarken Ctrl tuşuna basarak açabilirsiniz. Geriye kalan tek işlem, değişikliklerinizi göndermeyi tamamlamak için web sitesini izlemektir.