توضیحات
افزونه LLM Markdown یک نمایش تمیز مارک‌داون در نشانی قابل پیش‌بینی .md به محتوای عمومی پشتیبانی‌شده در وردپرس می‌دهد. عبارت .md را به انتهای نشانی یک نوشته، برگه یا نوع نوشته عمومیِ فعال اضافه کنید:
https://example.com/my-post.md
افزونه برگه استاندارد سمت کاربر را رندر می‌کند، بخشی از سند را که شامل محتوای اصلی است انتخاب می‌نماید، عناصر پیکربندی‌شده را حذف کرده و نتیجه را به مارک‌داون تبدیل می‌کند. بنابراین بلوک‌ها، شورت‌کدها و سایر محتوای رندرشده در سرور پس از پردازش توسط وردپرس و پوسته فعال نمایش داده می‌شوند. نوشته اصلی هرگز تغییر نمی‌کند و هیچ نوشته مارک‌داون تکراری ذخیره نمی‌شود.
خروجی مارک‌داون ساختاریافته
هر سند با یک YAML front matter شامل عنوان، شناسه نوشته، نوع محتوا، نامک، تاریخ انتشار و ویرایش، نشانی استاندارد (canonical)، نشانی مارک‌داون، چکیده و اصطلاحات مربوط به طبقه‌بندی‌های عمومی (در صورت وجود) آغاز می‌شود.
مبدل از عناوین، بندها، تأکیدها، پیوندها، فهرست‌های مرتب و نامرتب، نقل‌قول‌ها، کدهای درون‌خطی و بلوکی، خطوط افقی، متن‌های خط‌خورده، تصاویر (figures) و زیرنویس‌ها، و جدول‌های ساده پشتیبانی می‌کند. تصاویر می‌توانند به‌صورت یک گزینه همراه با پشتیبانی از ویژگی‌های رایج مبدأ بارگذاری تنبل گنجانده شوند.
انتخاب محتوا و کنترل دسترسی
انتخاب کنید کدام انواع نوشته عمومی مارک‌داون را ارائه دهند. انتخاب‌گرهای ساده CSS، ظرف محتوای اصلی و عناصری که باید قبل از تبدیل مستثنی شوند را تعیین می‌کنند. محتوای محافظت‌شده با رمز عبور و غیرعمومی رد می‌شوند و مقادیر noindex در سئوی یوست نیز می‌توانند رعایت شوند. توسعه‌دهندگان می‌توانند یک فیلتر کنترل دسترسی اضافی برای قوانین عضویت، حریم خصوصی یا انتشار سفارشی اعمال کنند.
شناسایی، تحویل و کش
برگه‌های HTML واجد شرایط، همتای مارک‌داون خود را با یک عنصر <link rel="alternate" type="text/markdown"> معرفی می‌کنند. اسناد تولیدشده برای درخواست‌های ناشناس برای بهبود عملکرد کش می‌شوند و پس از تغییرات مرتبط در تنظیمات، پوسته یا ناوبری به‌صورت خودکار باطل می‌گردند؛ ابزار کنترل دستی کش زیر بخش ابزارها در دسترس است.
یک گزینه پیشرفته مذاکره محتوا که به‌صورت پیش‌فرض غیرفعال است نیز می‌تواند در صورت درخواست صریح Accept: text/markdown توسط کلاینت، مارک‌داون را از نشانی استاندارد (canonical) معمولی بازگرداند. این حالت سرآیند Vary: Accept را ارسال می‌کند، اما فقط پس از تأیید اینکه تمام کش‌ها و CDNهای پیش روی سایت این سرآیند را به درستی رعایت می‌کنند باید فعال شود.
افزونه LLM Markdown هیچ وابستگی انحصاری به گوتنبرگ ندارد، محتوا را تکرار نمی‌کند و از انواع نوشته‌های سفارشی عمومی بدون الزام به ایجاد آن پشتیبانی می‌کند.
عکس‌های صفحه
نصب
- پوشه افزونه را در
/wp-content/plugins/بارگذاری کنید - افزونه را فعال کنید
- برای پیکربندی گزینه‌ها به مسیر تنظیمات خروجی مارک‌داون بروید
پس از فعال‌سازی، عبارت .md را به انتهای نشانی نوشته‌های پشتیبانی‌شده اضافه کنید.
سوالات متداول
-
آیا این قابلیت به نمایه‌سازی محتوای من توسط LLMها کمک می‌کند؟
-
این افزونه یک نمایش مارک‌داون ساختاریافته و قابل پیش‌بینی را در اختیار خزشگرها و سایر کلاینت‌ها قرار می‌دهد و آن نمایش را از طریق برگه‌های HTML واجد شرایط معرفی می‌کند. این افزونه نمی‌تواند تضمین کند که یک مدل، خزشگر یا موتور جستجوی خاص آن را شناسایی، نمایه یا استفاده خواهد کرد.
-
آیا این افزونه فایل‌های فیزیکی .md ایجاد می‌کند؟
-
خیر. نشانی‌های
.mdمسیرهای بازنویسی وردپرس هستند که در صورت نیاز تولید می‌شوند. اسناد کش‌شده به‌صورت موقت برای عملکرد بهتر ذخیره می‌شوند، اما افزونه یک ساختار درختی فایلیِ موازی ایجاد نمی‌کند و نیازی به همگام‌سازی فایل‌های برون‌بری‌شده توسط شما ندارد. -
آیا این افزونه محتوای من را تغییر می‌دهد؟
-
خیر. این افزونه برگه عمومی رندرشده را می‌خواند و پاسخی جداگانه تولید می‌کند. نوشته‌ها، بلوک‌ها، الگوها و محتوای پایگاه‌داده بازنویسی نمی‌شوند.
-
آیا از انواع نوشته سفارشی پشتیبانی می‌کند؟
-
بله. هر نوع نوشته عمومی را می‌توان زیر بخش «انواع محتوا» فعال کرد. پیوست‌ها مستثنی هستند. بدون تیک گذاشتن تمام انواع محتوا، خروجی مارک‌داون را به‌طور کامل غیرفعال می‌کند.
-
چگونه به یک برگه نخست ایستا دسترسی پیدا کنم؟
-
عبارت
.mdرا به پیوند یکتای معمولی آن اضافه کنید. نام مستعار/index.mdنیز در صورتی که وردپرس برای استفاده از برگه نخست ایستا پیکربندی شده باشد در دسترس است. -
آیا محتوای خصوصی را افشا می‌کند؟
-
افزونه فقط محتوای قابل مشاهده عمومی را از انواع نوشته عمومیِ فعال ارائه می‌دهد. محتوای دارای رمز عبور رد می‌شود. گزینه اختیاری «رعایت Noindex» همچنین نوشته‌هایی را که توسط سئوی یوست به عنوان noindex نشانه‌گذاری شده‌اند رد می‌کند، و یکپارچه‌سازی‌ها می‌توانند محدودیت‌های بیشتری را با فیلتر
llm_markdown_can_serve_postاعمال کنند. -
پوسته رندرشده چگونه بر مارک‌داون تأثیر می‌گذارد؟
-
مارک‌داون بر اساس برگه استاندارد رندرشده در سرور ساخته می‌شود، بنابراین بلوک‌ها، شورت‌کدها و خروجی الگوها می‌توانند گنجانده شوند. محتوای مختص مرورگر که بعداً توسط جاوااسکریپت درج می‌شود، در دسترس نیست. هنگامی که پوسته شامل ناوبری، بنرها، محتوای مرتبط یا سایر عناصر ناخواسته در اطراف نوشته است، از انتخاب‌گرهای محتوای اصلی و انتخاب‌گرهای محتوای مستثنی‌شده استفاده کنید.
-
کدام انتخاب‌گرهای CSS پشتیبانی می‌شوند؟
-
فیلدهای انتخاب‌گر عمداً از یک زیرمجموعه کاربردی پشتیبانی می‌کنند: نام عناصر، شناسه‌ها (IDs)، کلاس‌ها، فرم‌های ترکیبی مانند
article.entry-content، انتخاب‌گرهای نوادگان، و انتخاب‌گرهای فرزند مستقیم. گزینه‌ها را با کاما یا خطوط جدید جدا کنید. انتخاب‌گرهای ویژگی (attribute selectors)، شبه‌کلاس‌ها (pseudo-classes) و ترکیب‌کننده‌های هم‌نیایی (sibling combinators) پشتیبانی نمی‌شوند. -
آیا تصاویر می‌توانند گنجانده شوند؟
-
بله. گزینه «تصاویر در مارک‌داون» را در تب گزینه‌ها فعال کنید. تصاویر درون ناحیه محتوای انتخابی با استفاده از مبدأ، متن جایگزین و عنوان خود تبدیل می‌شوند؛ ویژگی‌های رایج بارگذاری تنبل نیز شناسایی می‌شوند. تصاویر به‌صورت پیش‌فرض مستثنی هستند.
-
آیا این افزونه برای سئو در نظر گرفته شده است؟
-
این افزونه یک نمایش جایگزین ارائه می‌دهد و یک پیوند شناسایی به برگه‌های HTML واجد شرایط اضافه می‌کند، اما هیچ تعهدی درباره رتبه‌بندی یا نمایه‌سازی نمی‌دهد. پاسخ مارک‌داون، نشانی HTML را به عنوان نشانی استاندارد (canonical) مشخص می‌کند. رفتار موتورهای جستجو و خزشگرهای هوش مصنوعی متغیر است.
-
چرا خروجی غیرمنتظره‌ای قبل از سند مارک‌داون ظاهر می‌شود؟
-
برخی از پوسته‌ها، افزونه‌ها یا لایه‌های میزبانی، قبل از پاسخ‌های
.mdیا مارک‌داونِ توافق‌شده، کد HTML، اعلان‌ها یا خروجی‌های دیگری را ارسال می‌کنند. گزینه پاک‌سازی پاسخ را در تب گزینه‌ها زیر مسیر تنظیمات خروجی مارک‌داون فعال کنید تا این خروجی‌های ناخواسته اولیه حذف شوند. این گزینه سازگاری به‌صورت پیش‌فرض غیرفعال است.اگر افزونه نتواند برگه رندرشده را بازیابی یا استخراج کند، به جای کش کردن یک سند خالی یا ناقص، پاسخ غیرقابل کش
503 مارک‌داون موقتاً در دسترس نیسترا بازمی‌گرداند. مسیرهای.mdپشتیبانی‌نشده، غیرفعال یا محافظت‌شده پاسخ404 یافت نشدبازمیگردانند. -
آیا کلاینت‌ها می‌توانند مارک‌داون را از نشانی معمولی نوشته درخواست کنند؟
-
بله. گزینه مارک‌داون مبتنی بر سرآیند را در تب پیشرفته زیر مسیر تنظیمات خروجی مارک‌داون فعال کنید. سپس نشانی‌های نوشته‌های عمومیِ پشتیبانی‌شده می‌توانند برای درخواست‌های
GETوHEADکه صریحاًtext/markdownرا ترجیح می‌دهند، مارک‌داون بازگردانند. هر دو پاسخ HTML و مارک‌داون شاملVary: Acceptهستند تا کش‌های سازگار بتوانند این دو نمایش را تفکیک‌شده نگه دارند.این یک ویژگی پیشرفته است که به‌صورت پیش‌فرض غیرفعال است. یک CDN، پروکسی، کش سرور یا افزونه کش برگه که
Vary: Acceptرا رعایت نکند ممکن است نمایش اشتباهی را ارائه دهد. مارک‌داون توافق‌شده همچنین از ابزارهای تحلیلی سمت مرورگر و جاوااسکریپت عبور می‌کند. پس از فعال‌سازی، تمام کش‌ها را پاک کرده و هر دو نمایش را آزمایش کنید.تطبیق محتاطانه به یک دامنه رسانه‌ای صریح
text/markdownنیاز دارد. گزینه مجزای سرآیندهای Accept عام (Wildcard) می‌تواند بهtext/*نیز اجازه دهد؛ مقدار*/*به‌تنهایی هرگز درخواست مارک‌داون نمی‌دهد.آزمایش HTML:
curl -i -H "Accept: text/html" https://example.com/my-post/آزمایش مارک‌داون:
curl -i -H "Accept: text/markdown" https://example.com/my-post/ -
چگونه پس از تغییر پوسته یا چیدمان سایت، مارک‌داون کش‌شده را بازنشانی کنم؟
-
پس از تغییر الگوها، ناوبری، ابزارک‌ها، شورت‌کدها یا سایر محتواهایی که بر برگه رندرشده تأثیر می‌گذارند، از پاک‌سازی کش مارک‌داون در تب ابزارها زیر مسیر تنظیمات خروجی مارک‌داون استفاده کنید. ذخیره تنظیمات افزونه، تعویض پوسته و به‌روزرسانی فهرست‌های ناوبری نیز به‌طور خودکار کش مارک‌داون را باطل می‌کنند.
توسعه‌دهندگان می‌توانند از فیلتر
llm_markdown_cache_ttlبرای تغییر مدت‌زمان پیش‌فرض ۱۲ ساعته حافظه موقت (کش) استفاده کنند یا با بازگرداندن0، کش کردن سند را غیرفعال نمایند. -
چه فیلترهایی برای توسعه‌دهندگان در دسترس است؟
-
از
llm_markdown_can_serve_postبرای قوانین دسترسی، ازllm_markdown_is_noindex_postبرای ارائه‌دهندگان بیشتر noindex، ازllm_markdown_include_taxonomyجهت کنترل فیلدهای طبقه‌بندی عمومی، ازllm_markdown_front_matterبرای اصلاح فراداده، ازllm_markdown_markdown_documentجهت فیلتر کردن سند تکمیل‌شده و ازllm_markdown_cache_ttlبرای کنترل حافظه موقت (کش) استفاده کنید. -
هنگام حذف افزونه چه بر سر داده‌های آن می‌آید؟
-
غیرفعال‌سازی افزونه تنظیمات را حفظ می‌کند. حذف نصب یا پاک کردن افزونه، تنظیمات، گزینه تولید کش و ترنزینت‌های (transients) تولیدشده مارک‌داون را حذف می‌کند. در حالت چندسایته، پاک‌سازی برای تمام سایت‌های شبکه اجرا می‌شود.
نقد و بررسی‌ها
توسعه دهندگان و همکاران
“LLM Markdown – ارائه محتوا به‌صورت .md” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.
مشارکت کنندگان
“LLM Markdown – ارائه محتوا به‌صورت .md” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.
ترجمه “LLM Markdown – ارائه محتوا به‌صورت .md” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.0.2
- افزودن مذاکره پیشرفته و اختیاریِ محتوای مارک‌داون برای نشانی‌های تکی معمولی با استفاده از
Accept: text/markdown. - افزودن تطبیق سرآیند Accept آگاه از کیفیت، پشتیبانی اختیاری از
text/*، محدودیت‌های GET/HEAD و ارسال سیگنالVary: Acceptبرای پاسخ‌های HTML و مارک‌داون واجد شرایط. - افزودن گزینه پاک‌سازی پاسخ (به‌صورت پیش‌فرض غیرفعال) برای خروجی‌های ناخواسته ارسال‌شده پیش از مارک‌داون و پاسخ‌های خطای مسیر مارک‌داون.
- بازسازمان‌دهی برگه تنظیمات به تب‌های گزینه‌ها، DOM و انتخاب‌گرها، پیشرفته و ابزارها همراه با برچسب‌ها، راهنماها و هشدارهای عملکردی واضح‌تر.
- افزودن باطل‌سازی دستی کش و تغییرات خودکار تولید پس از به‌روزرسانی تنظیمات، تغییر پوسته و به‌روزرسانی فهرست‌های ناوبری.
- افزودن فیلتر
llm_markdown_cache_ttlو گسترش کلیدهای کش با در نظر گرفتن نسخه تبدیل، گزینه‌های مرتبط، سایت، زبان محلی و زمان ویرایش محتوا. - تغییر رندرهای بازگشتی (loopback) ناموفق یا خالی جهت بازگرداندن پاسخ غیرقابل کش 503 به جای کش کردن خروجی ناقص.
- افزودن قلاب
llm_markdown_can_serve_postبرای یکپارچه‌سازی با سیستم‌های عضویت و کنترل دسترسی. - محدود کردن داده‌های طبقه‌بندی front-matter به طبقه‌بندی‌های عمومی و افزودن
llm_markdown_include_taxonomyبرای کنترل بیشتر. - امکان خالی گذاشتن عمدی انتخاب نوع محتوا جهت غیرفعال کردن تمام خروجی‌های مارک‌داون.
- اصلاح رمزگشایی موجودیت‌های HTML و جداکننده‌های کد مارک‌داون هنگامی که کد منبع حاوی بک‌تیک (backticks) است.
- افزودن تبدیل مارک‌داون برای خطوط افقی، متن‌های خط‌خورده، تصاویر (figures) و زیرنویس آن‌ها، و ایمن‌تر ساختن خروجی جدول ساده برای سطرهای ناهموار و نویسه‌های خط عمودی (pipe).
- گسترش فرآیند پاک‌سازی هنگام حذف نصب برای پاک کردن تمام گزینه‌های افزونه و ترنزینت‌های مارک‌داون تولیدشده در نصب‌های تک‌سایته و چندسایته.
1.0.1
- افزودن پشتیبانی از جدول‌ها.
- افزودن پشتیبانی اختیاری از تصاویر.
1.0.0
- انتشار اولیه.