Sık yapılan llms.txt hataları
Yayınlandı:
Çoğu llms.txt sorunu birkaç kalıptan birine girer. İşte doğrulayıcımızın en sık işaretlediği sorunlar — ve her biri için hızlı çözüm.
1. Birden fazla H1
Spesifikasyon tam olarak tek bir üst düzey # Title ister. Fazladan # başlıkları yapıyı karıştırır. Geri kalanları ## bölüm başlıklarına indirin.
2. Blockquote özetinin olmaması
Başlığın hemen altında yer alan bir ya da iki cümlelik blockquote, bir modelin ilk okuduğu bağlamdır. Bunu atlamak en yaygın eksiktir. Bir tane ekleyin:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Bağlantısız bölümler (ya da hiç bölüm olmaması)
Boş ## bölümleri hiçbir şey katmaz. Her bölüm, gerçek sayfalara giden bağlantılardan oluşan bir Markdown madde listesi içermelidir. Hiç bölümünüz yoksa, önemli sayfalarınızı ## Docs ve ## Guides gibi başlıklar altında gruplayın.
4. Bozuk bağlantılar
Bir dosya kusursuz biçimlendirilmiş olsa bile ölü sayfalara işaret edebilir — bu da bir tarayıcının bütçesini boşa harcar ve güveni zedeler. Her URL'nin çözümlenmesi gerekir. Bu, çoğu aracın atladığı kontroldür; biz her birini getiririz.
5. Göreceli veya http:// bağlantıları
Her yerde mutlak https:// URL'leri kullanın. Modeller /docs/start gibi göreceli yolları çözümleyemeyebilir ve düz http:// bağlantıları güvenilmez görünür ve yalnızca HTTPS kullanan taramalarda bozulabilir.
6. Yanlış içerik türü
Dosyayı text/plain; charset=utf-8 olarak sunun. Sunucunuz text/html döndürüyorsa (yaygın bir yanlış yapılandırma), bazı tüketiciler dosyayı llms.txt olarak değerlendirmez.
7. Şişkin, ayıklanmamış bir dosya
llms.txt, bir sitemap.xml dökümü değil, özenle seçilmiş bir dizindir. Açıklamasız yüzlerce bağlantı sinyali gömer. En iyi sayfaları tutun, her birinin ardına kısa bir : description ekleyin ve ikincil bağlantıları bir ## Optional bölümüne taşıyın.
Hepsini bir kerede yakalayın
Dosyanızı doğrulayıcıdan geçirin — yapıyı, bağlantı erişilebilirliğini ve en iyi uygulamaları puanlar ve yukarıdakilerden hangisini düzeltmeniz gerektiğini tam olarak söyler. Bu biçime yeni misiniz? llms.txt dosyası nasıl oluşturulur ile başlayın.