نسخه Markdown برای عاملها خراب است
صفحه یک نسخه Markdown به عاملها ارائه میکند، از طریق پاسخ به Accept: text/markdown یا یک <link rel="alternate" type="text/markdown">، اما آن نسخه خطا، بدنه خالی یا یک صفحه HTML برمیگرداند. عاملهایی که آن را درخواست میکنند چیز مفیدی نمیگیرند.
یعنی چه
صفحه به عاملها Markdown ارائه میکند (در پاسخ به Accept: text/markdown یا بهصورت نسخه پیوندشده)، اما آنچه برمیگردد خطا، بدنه خالی یا یک صفحه HTML است.
چرا برای جستجوی هوش مصنوعی مهم است
عاملی که پیوند Markdown را میبیند یا پاسخی با text/markdown میگیرد به آن اعتماد میکند و ممکن است به HTML برنگردد. نسخه خراب از نبودِ نسخه بدتر است: عامل یا شکست میخورد یا یک صفحه خطا را بهعنوان محتوای شما میخواند.
این معمولاً پس از جابهجایی یا بازسازی سایت پیش میآید: فایلهای .md مستقر نشدهاند، یک قانون rewrite به مسیر قدیمی اشاره میکند، یا یک middleware صفحه HTML را text/markdown برچسب میزند.
چطور آن را اصلاح کنید
- URL موجود در شواهد را باز کنید و وضعیت،
Content-Typeو بدنه را ببینید. - اگر نسخه از بین رفته، دوباره مستقرش کنید یا تگ
<link rel="alternate" type="text/markdown">و هدرLinkرا که به آن اشاره میکنند حذف کنید. - اگر پاسخ HTML یا خالی است، تبدیل را اصلاح کنید تا متن صفحه را بهصورت Markdown با
Content-Type: text/markdownبرگرداند. - در گزارش صفحه «بررسی دوباره» را اجرا کنید تا نتیجه را تأیید کنید.
نمونه
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 چطور از رفع مشکل مطمئن شویم
پس از اعمال تغییر، در گزارش «بررسی دوباره» را بزنید: فهرست میکند چه چیزی رفع شده و امتیاز چطور تغییر کرده است.