Jump to content

Руководство:Предварительный просмотр

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

Предварительный просмотр - это функция МедиаВики, которая позволяет отображает предварительный просмотр страницы или раздела в форме редактирования без перезагрузки остального HTML-кода формы.

В нём имеются некоторые ошибки, см. отслеживание ошибок предварительного просмотра для получения актуального списка.

Включение предварительного просмотра

Предварительный просмотр включён или выключен в зависимости от настройки во вкладке "Редактирование" страницы пользовательских настроек, по умолчанию отключён.

Преимущества

  • меньше входящего трафика: вики-код и все меню снова не принимаются с сервера
  • более быстрое время отклика
  • та же позиция курсора в окне редактирования
  • история отмены/повтора в окне редактирования сохраняется

Недостатки

Обновляется только область предварительного просмотра, что означает:

  • скрипты не выполняются, если они не используют хук wikipage.content.
  • некоторые части интерфейса, такие как межъязыковые ссылки, список включений и т. д., могут обновляться неправильно.
  • навигация по истории браузера – с предварительным просмотром – больше не работает

Технические детали

Предварительный просмотр использует Parse API и difftotext-опцию Revisions API для получения новой версии текста, чтобы получить проанализированный предварительный просмотр или разницу изменений на странице редактирования.

Поскольку она динамическая на стороне клиента, она требует JavaScript для работы. Если JavaScript отключен, предварительный просмотр правки будет происходить традиционно (с перезагрузкой страницы), даже если эта функция активирована. Это пример прогрессивного улучшения.

См. также