Açık kaynak proje / 2026
DeadLinkFinder
Yerel linkler, görseller, başlık çapaları ve harici URL’ler için sıfır bağımlılıklı bir Markdown bütünlük denetleyicisi.
Problem
Kırık göreli linkler ve eksik #çapalar, kimse her dokümandaki her linke tıklamadığı için incelemeden süzülüp geçiyor.
Yaklaşım
DeadLinkFinder; yerel linkleri, görsel varlıkları ve başlık çapalarını tamamen çevrimdışı doğruluyor — noktalama, Unicode, emoji ve yinelenen başlıkları kapsayan GitHub uyumlu bir çapa motoruyla.
Sistem mimarisi
Yalnızca Python standart kütüphanesi (re, pathlib, difflib, urllib); isteğe bağlı harici URL kontrolleri, satır parmak izli SARIF v2.1.0 raporları.
Kararlar ve sonuç
Her kırık hedef, difflib destekli bir 'bunu mu demek istediniz' önerisiyle geliyor — yalnızca tespit değil, teşhis. PyPI’da deadlinkfinder olarak kurulabiliyor. Markdown dosyalarındaki kırık yerel bağlantıları, eksik görselleri ve başlık çapalarını JSON veya SARIF olarak raporluyor. Dış URL kontrolleri isteğe bağlı ağ moduyla açılıyor.
Kullanım Alanları ve Komutlar
- README, wiki ve teknik dokümantasyonlardaki kırık göreli dosya linklerini, eksik görselleri ve bozuk #başlık çapalarını CI'da yakalamak.
- GitHub uyumlu Unicode/emoji başlık çapalarını tamamen çevrimdışı doğrulamak ve kırık linkler için difflib tabanlı düzeltme önerisi almak.
- GitHub Code Scanning için satır parmak izli SARIF v2.1.0 veya otomasyonlar için JSON raporu üretmek.
# Kurulum ve yerel Markdown link + çapa denetimi
pip install deadlinkfinder
deadlinkfinder check .
# CI için SARIF çıktısı ve isteğe bağlı dış URL kontrolü
deadlinkfinder check docs/ --format sarif --external