TLDR Sayfaları (İngilizce: TLDR Pages), man sayfalarına kıyasla daha basit ve erişilebilir olma amacı güden, özgür ve açık kaynak kodlu kollaboratif yazılım belgelendirme projesidir. Proje, gönüllüler tarafından yazılan, komut satırı araçları ve diğer bilgisayar programları ile ilgili yardım dosyalarından oluşur. Bir sayfa, tldr komutu ile çağırılabilir.[2][3] Projenin ismi, birçok kullanıcının çok uzun olduğunu söylediği man sayfalarına atıfta bulunan, "çok uzun; okunmadı" için bir kısaltma olan TL; DR kelimesinden gelir.[4]

tldr-pages
Orijinal yazar(lar)Romain Prieto
İlk yayınlanma8 Aralık 2013 (10 yıl önce) (2013-12-08)[1]
Programlama diliMarkdown
PlatformÇoklu platform
ErişilebilirlikÇokdilli
TürYazılım dokümantasyonu
Resmî sitesitldr.sh
Kod deposugithub.com/tldr-pages/tldr

Mart 2021 itibarıyla projenin GitHub'daki deposunda 30.000 yıldız ve 2.500 çatal bulunmaktadır.[5]

Tarihçe değiştir

Romain Prieto, kişisel bilgisayarının saat dilimine göre ilk commit'ini 8 Aralık 2013 tarihinde saat 19.56.16'da ünlü kod barındırma ve sürüm kontrol sitesi GitHub'a yolladı.[1]

İlk başlarda projeye sadece bir avuç insan katkıda bulunuyordu. 2015'in sonunda, ismi belirsiz bazı Çince yayınların proje hakkında makale yayımlamalarının üzerine, TLDR sayfalarının GitHub'daki deposunun popülerliğinde, Swift gibi ünlü yazılım ve yazılım dillerini dahi geride bırakan hızlı bir artış yaşandı.[6] 25 Aralık 2015'te proje küresel popülerlikte 3. sıraya yükseldi.[7] 27 Aralık 2015 itibarıyla, 700 küsur tanesi bir haftada gelmek üzere depo 2700+ yıldıza ulaştı.[8] Ertesi gün proje, Hacker News'in ön sayfasına yerleşti.[9] Gönderinin ardından, projenin aldığı yıldız sayısı 3700+'ya ulaştı ve projenin kendisi Github'ın günlük popülarite listesinde ilk sıraya ulaştı.[10][11]

Proje, 2017 yılının sonlarına doğru başka bir patlama daha gördü ve geçmişten bugüne kadar devam eden istikrarlı popülarite artışını korudu.[12]

Biçimlendirme değiştir

TLDR Sayfaları projesinin varsayılan biçimlendirme kullanımı, diğer birçok özgür yazılım ve dokümantasyon projesinde kullanılan popüler biçimlendirme dili Markdown'dır.[13]

Projenin kendi özel {{token_syntax}} uzantısı olsa da, CommonMark tariflerine uyar. Hatta projenin kodu, projenin yüklü olduğu cihazların CommonMark ile tamamen uyumlu olmasını gerektirir.

Komut kullanımı değiştir

- Bir komutun tipik kullanımını göster:

tldr command

- Linux için tar tldr sayfasını göster:

tldr -p linux tar

- Bir Git alt komutu için yardım al:

tldr git-checkout

- (Eğer alıcı önbellek oluşumunu destekliyorsa) Yerel paketleri güncelle:

tldr -u

Yazarlık değiştir

TLDR Sayfaları, CommonMark biçimlendirmesini destekleyen tüm metin düzenleyicilerde yazılabilir.[13]

Github'daki tldr-pages deposuna katkıda bulunmak için, Katılımcı Lisans Sözleşmesi'ni imzalaması ve kuraldan ziyade sayfaların basit yapısını korumak adına yardımcı bilgi niteliğinde olduğu söylenen proje yönergelerine uyulması gerekir.

Lisans değiştir

Sayfalar, Creative Commons Attribution 4.0 Uluslararası Lisansı ile lisanslanırken scripts/ dizininin içeriği MIT Lisansı ile lisanslanmıştır. Projeye yapılacak her türlü katkı, Katılımcı Lisans Sözleşmesi'ne tabidir.

Ayrıca bakınız değiştir

Kaynakça değiştir

  1. ^ a b commit 11264d9b19000734a2d35ecbdbdebc0b0b45aed9
  2. ^ "Arşivlenmiş kopya". 19 Ocak 2021 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021. 
  3. ^ "Arşivlenmiş kopya". 30 Kasım 2020 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021. 
  4. ^ "Arşivlenmiş kopya". 22 Ocak 2020 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021. 
  5. ^ /web/20210301121724/https://github.com/tldr-pages/tldr 1 Mart 2021 tarihinde Wayback Machine sitesinde arşivlendi.
  6. ^ https://gitter.im/tldr-pages/tldr/archives/2015/12/25
  7. ^ "Arşivlenmiş kopya". 9 Ocak 2021 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021. 
  8. ^ https://gitter.im/tldr-pages/tldr/archives/2015/12/27?at=56806f6b653b30761d7644c9
  9. ^ "Arşivlenmiş kopya". 10 Haziran 2017 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021. 
  10. ^ https://gitter.im/tldr-pages/tldr/archives/2015/12/28?at=5681c31f35e1a316162e7b62
  11. ^ Romain [@asyncadventures] (28 Aralık 2015). "Sometimes, a little side project is useful to other people and goes trending :) Thanks to all the TLDR contributors! t.co/Vp7GwBJEpI" (Tweet). Erişim tarihi: 3 Mart 2021Twitter vasıtasıyla. 
  12. ^ https://web.archive.org/web/20210218080438/https://star-history.t9t.io/
  13. ^ a b "Arşivlenmiş kopya". 31 Ocak 2021 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021. 

Dış bağlantılar değiştir