Ajanlar için Markdown sürümü bozuk

Kısa yanıt

Sayfa ajanlara, Accept: text/markdown isteğine verdiği yanıt ya da bir <link rel="alternate" type="text/markdown"> aracılığıyla Markdown sürümü sunuyor, ama bu sürüm bir hata, boş bir gövde ya da bir HTML sayfası döndürüyor. Onu isteyen ajanlar işe yarar hiçbir şey almıyor.

agent.markdown_broken · Öncelik: P2

Ne anlama gelir

Sayfa ajanlara Markdown sunuyor (Accept: text/markdown yanıtı olarak ya da bağlantılı bir kopya olarak), ama dönen şey bir hata, boş bir gövde ya da bir HTML sayfası.

Yapay zekâ araması için neden önemli

Markdown bağlantısını gören ya da text/markdown yanıtı alan bir ajan ona güvenir ve HTML'e geri dönmeyebilir. Bozuk bir kopya, hiç olmamasından kötüdür: ajan ya başarısız olur ya da bir hata sayfasını sizin içeriğiniz sanarak okur.

Bu genellikle bir taşıma ya da yeniden derleme sonrasında olur: .md dosyaları dağıtılmamıştır, bir rewrite kuralı eski bir yolu gösteriyordur ya da bir middleware HTML'i text/markdown olarak etiketliyordur.

Nasıl düzeltilir

  1. Kanıttaki URL'yi açın ve duruma, Content-Type değerine ve gövdeye bakın.
  2. Kopya yoksa onu yeniden dağıtın ya da ona işaret eden <link rel="alternate" type="text/markdown"> etiketini ve Link üst bilgisini kaldırın.
  3. Yanıt HTML ya da boşsa dönüştürmeyi, sayfa metnini Content-Type: text/markdown ile Markdown olarak döndürecek şekilde düzeltin.
  4. Sonucu doğrulamak için sayfa raporunda "Yeniden denetle"yi çalıştırın.

Örnek

curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, content-type: text/markdown; charset=utf-8, vary: Accept

Çözüm nasıl doğrulanır

Değişiklikten sonra raporda "Yeniden denetle" düğmesine basın: neyin düzeltildiğini ve puanın nasıl değiştiğini listeler.

Sayfamı denetle →

İlgili rehberler

Tüm bulgular ve puanın nasıl hesaplandığı