Discourse حالا محتوای انجمن رو به‌صورت Markdown به ایجنت‌های هوش مصنوعی می‌ده
هوش مصنوعیخلاصهٔ کامل‌تر
تیم Discourse تو این پست اعلام کرده که Markdown endpoints (یعنی آدرس‌هایی که به‌جای صفحهٔ HTML، همون محتوا رو به شکل Markdown برمی‌گردونن) حالا بخشی از هستهٔ Discourse شده. به گفتهٔ تیم، امروز فقط آدم‌ها با مرورگر سراغ انجمن‌ها نمیان؛ ایجنت‌های هوش مصنوعی، LLMها و موتورهای جستجو هم دارن محتوا رو می‌خونن و این قابلیت برای همین ساخته شده.
مشکل HTML اینه که پر از کد چیدمان، استایل و اسکریپته. ایجنت اول باید همهٔ اینا رو جدا کنه که هم پرهزینه‌ست و هم token هدر می‌ده. تازه اگه زیادی حذف کنه یا چیزی جا بمونه، دقت خروجی پایین میاد. Discourse از قبل یه خروجی .raw هم داشت که متن خام نویسنده رو می‌داد، ولی اون پر از shortcodeهای مخصوص Discourse برای آپلود، نقل‌قول و نظرسنجیه و عکس، لیست و جدول رو هم درست نشون نمی‌ده.
نسخهٔ Markdown وسط این دو تاست: از HTML سبک‌تره چون کد چیدمان نداره، از .raw بهتره چون Discourse اول سینتکس خاص خودش رو پردازش می‌کنه و عکس و لیست و جدول درست درمیان، و آدم‌ها هم راحت می‌تونن بخوننش. فعلاً برای دو نوع صفحه کار می‌کنه: صفحهٔ هر تاپیک با کل پست‌هاش، و لیست تاپیک‌ها مثل Latest، New، Categories و Tags. لیست‌های چندصفحه‌ای لینک «previous» و «next» دارن تا ایجنت بتونه کل لیست رو بگرده.
دو راه برای گرفتن Markdown هست. یکی اینکه ته آدرس تاپیک .md اضافه کنی. دومی اینکه برنامه هدر Accept: text/markdown بفرسته؛ این‌جوری آدرس عوض نمی‌شه و Discourse به‌جای HTML، Markdown برمی‌گردونه. تیم می‌گه بیشتر ایجنت‌ها و LLMها احتمالاً از قبل همین هدر رو می‌فرستن و تنظیم خاصی لازم ندارن.
این قابلیت از پلاگین Discourse to Markdown اومده که Ben Word ساخته بود. اون مشخصهٔ Accept Markdown رو هم نوشته که توضیح می‌ده سایت‌ها چطور باید به نرم‌افزاری که Markdown می‌خواد جواب بدن. اگه هنوز این پلاگین رو داری، باید غیرفعال و حذفش کنی، چون جای بعضی endpointهای هسته رو می‌گیره. اگه سایتت پشت Cloudflare هست هم حواست باشه: قابلیت تبدیل HTML به Markdown خود Cloudflare ممکنه درخواست‌ها رو قبل از رسیدن به Discourse بگیره و نسخهٔ خودش رو تحویل بده.
برای سایت‌های میزبانی‌شده این قابلیت از طریق Upcoming Changes خودبه‌خود روشن شده و اونایی که خودشون میزبانی می‌کنن فقط باید Discourse رو آپدیت کنن. برای خاموش کردنش هم تو پنل ادمین تنظیم enable_markdown_endpoints رو خاموش می‌کنی.
نکات کلیدی:
- با اضافه کردن .md به آدرس تاپیک، نسخهٔ Markdown اون رو می‌گیری.
- هدر Accept: text/markdown هم بدون عوض شدن آدرس، Markdown برمی‌گردونه.
- فعلاً فقط صفحهٔ تاپیک و لیست‌های Latest، New، Categories و Tags پشتیبانی می‌شن.
- پلاگین Discourse to Markdown باید حذف بشه چون جای endpointهای هسته رو می‌گیره.
- قابلیت تبدیل Markdown خود Cloudflare ممکنه خروجی Discourse رو جایگزین کنه.
- خاموش کردنش با تنظیم enable_markdown_endpoints تو پنل ادمینه.
