راهنما: پیش نمایش

From mediawiki.org
This page is a translated version of the page Manual:Live preview and the translation is 75% complete.

پیش‌نمایش زنده یکی از قابلیت‌های مدیاویکی است که امکان ارائه یک پیش‌نمایش از یک مقاله یا بخش در یک فرم ویرایش را بدون بارگذاری مجدد مانده کد اچ‌تی‌ام‌ال فرم را فراهم می‌کند.

It has some bugs, see live preview tracking bug for an up to date list.

فعال‌سازی پیش‌نمایش زنده

فعال یا غیرفعال بودن پیش‌نمایش زنده به تنظیمات آن در تب "ویرایش" از صفحه ترجیحات کاربری شما وابسته است،‌ که به صورت پیش‌فرض غیرفعال می‌باشد.

مزایا

  • ترافیک ورودی کمتر: ویکی‌کد و تمامی منوها به صورت مجدد از سرور دریافت نخواهند شد
  • سرعت واکنش بالاتر
  • همان موقعیت مکانی در پنجره‌ی ویرایش
  • undo/redo history in the editing window is kept

معایب

تنها محدوده پیش‌نمایش به‌روز می‌شود،‌ این بدین معناست:

  • اگر از کد ماشینی wikipage.content بهره‌گیری نشود،‌ اسکریپت‌ها اجرا نخواهند شد
  • برخی بخش‌های واسط کاربری نظیر لینک بین زبانی، لیست فراگیری و غیره، ممکن است به صورت کامل به‌روزرسانی نشوند.
  • جهت‌یابی در تاریخچه مرورگر ـ با پیش‌نمایش ـ دیگر کار نخواهد کرد

جزئیات فنی

A live preview makes use of the Parse API and the difftotext-option of the Revisions API, to submit the new version of the text in order to receive parsed preview or diff changeset in the Edit page.

Since it is dynamic on the client side, it requires JavaScript to work. Should JavaScript be deactivated, the edit will preview traditionally (with page reload), even if this feature is activated. This is an instance of progressive enhancement.

جستارهای وابسته