TLDR Sayfaları
 | Bu maddede yeterince bilgilendirici olmayan ve bağlantı ölümüne karşı savunmasız olan yalın URL'ler kullanılmıştır. (Ekim 2023) (Bu şablonun nasıl ve ne zaman kaldırılması gerektiğini öğrenin) |
 | |
 | |
| Yazar | Romain Prieto |
|---|---|
| İlk yayınlanma | 8 Aralık 2013)[1] |
| Güncel sürüm | 2.3[2]  7 Mart 2025 |
| Kod deposu | github.com/tldr-pages/tldr |
| Programlama dili | Markdown |
| Platform | Çoklu platform |
| Diller | Çokdilli |
| Tür | Yazılım dokümantasyonu |
| Resmî sitesi | tldr.sh |
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.[3][4] 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.[5]
Ağustos 2024 itibarıyla projenin GitHub'daki deposunda 50.000 yıldız ve 4.100 çatal bulunmaktadır.[6]
Tarihçe
[değiştir | kaynağı 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ı.[7] 25 Aralık 2015'te proje küresel popülerlikte 3. sıraya yükseldi.[8] 27 Aralık 2015 itibarıyla, 700 küsur tanesi bir haftada gelmek üzere depo 2700+ yıldıza ulaştı.[9] Ertesi gün proje, Hacker News'in ön sayfasına yerleşti.[10] 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ı.[11][12]
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.[13]
Biçimlendirme
[değiştir | kaynağı 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.[14]
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 | kaynağı 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 | kaynağı değiştir]TLDR Sayfaları, CommonMark biçimlendirmesini destekleyen tüm metin düzenleyicilerde yazılabilir.[14]
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 | kaynağı 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 | kaynağı değiştir]- Unix komutlarının listesi
- Man sayfası
- info
- apropos
Kaynakça
[değiştir | kaynağı değiştir]- ^ a b commit 11264d9b19000734a2d35ecbdbdebc0b0b45aed9
- ^ "Release 2.3". 7 Mart 2025. Erişim tarihi: 31 Mart 2025.
- ^ "Arşivlenmiş kopya". 19 Ocak 2021 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021.
- ^ "Arşivlenmiş kopya". 30 Kasım 2020 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021.
- ^ "Arşivlenmiş kopya". 22 Ocak 2020 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021.
- ^ /web/20210301121724/https://github.com/tldr-pages/tldr 1 Mart 2021 tarihinde Wayback Machine sitesinde arşivlendi.
- ^ https://gitter.im/tldr-pages/tldr/archives/2015/12/25
- ^ "Arşivlenmiş kopya". 9 Ocak 2021 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021.
- ^ https://gitter.im/tldr-pages/tldr/archives/2015/12/27?at=56806f6b653b30761d7644c9
- ^ "Arşivlenmiş kopya". 10 Haziran 2017 tarihinde kaynağından arşivlendi. Erişim tarihi: 3 Mart 2021.
- ^ https://gitter.im/tldr-pages/tldr/archives/2015/12/28?at=5681c31f35e1a316162e7b62
- ^ 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". Erişim tarihi: 3 Mart 2021 – X vasıtasıyla.
- ^ https://web.archive.org/web/20210218080438/https://star-history.t9t.io/
- ^ 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 | kaynağı değiştir]- Resmî site
- Demo 22 Şubat 2021 tarihinde Wayback Machine sitesinde arşivlendi.
- Depo 31 Ocak 2021 tarihinde Wayback Machine sitesinde arşivlendi.
- PDF belgesi 8 Ocak 2021 tarihinde Wayback Machine sitesinde arşivlendi.
