Расширение:Description2

Справка по расширениям MediaWiki

Description2 Статус релиза: стабильно
Реализация	Извлечение данных, Расширение парсера
Описание	Предоставляет тег мета-описания и добавляет данные в вывод парсера для использования другими расширениями.
Автор(ы)	Daniel Friesen (Dantmanобсуждение)
Последняя версия	0.4.1
Политика совместимости	Мастер поддерживает обратную совместимость.
MediaWiki	>= 1.38.0
Изменения в БД	Нет
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: репозиторий (GitHub) Обзор кода Gerrit журнал Git-коммитов Download source tarball
Параметры $wgDescriptionMaxChars $wgDescriptionRemoveElements $wgDescriptionAlgorithm $wgEnableMetaDescriptionFunctions
Используемые хуки OutputPageParserOutput ParserAfterTidy ParserFirstCallInit
Переведите расширение Description2, если оно доступно на translatewiki.net

Расширение Description2 добавляет метатег описания для статей автоматически на основе содержимого. Похоже, что эта функциональность была удалена из MediaWiki в какой-то момент. Бывают ситуации, когда извлечение описания ( из вики объектами менее сложными, чем Google, например, Facebook) извлекает из вики неправильную информацию об описании и использует что-то вроде sitenotice в качестве описания страницы вместо ее содержимого. Это расширение также добавляет описание в вывод парсера таким образом, что другие расширения могут использовать его (например, предоставлять описание в другом формате, как это делает Расширение:OpenGraphMeta , или, возможно, использовать его в списках статей в вики).

Установка

• Скачайте и распакуйте файл(ы) в папку с названием Description2 в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Description2
  

• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'Description2' );
  $wgEnableMetaDescriptionFunctions = true;
  

• Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Дополнительные опции

Если вы задали $wgEnableMetaDescriptionFunctions = true; в функции парсера LocalSettings.php, то функция парсера {{#description2:}} может быть использована для управления выводимым для страницы описанием и переопределения его на пользовательское. Вы можете использовать эти расширения парсера следующим образом:

{{#description2:This is a description}}

Вместо этого вы можете использовать функцию парсера description2, чтобы предоставить тег описания, которым можно управлять с помощью переменных шаблона.

Алгоритм

Описание извлекается из HTML-представления страницы:

1. Удалите все элементы ‎<table> (и их содержимое).
2. Найдите все элементы ‎<p>.
3. Пройдитесь по этим абзацам, удаляя все HTML-теги (см. strip_tags()) и обрезая пробелы вокруг них.
4. В качестве описания выбирается первый непустой абзац (после всех предыдущих преобразований).

Что нужно учитывать:

• При использовании шаблонов в верхней части статей, если вы используете для шаблона ‎<div> вместо таблиц, убедитесь, что он не выводит абзацы, которые в противном случае будут использоваться в качестве описания. Это может произойти, если внутри шаблона есть несколько ‎<div> с новыми строками.

См. также

• Extension:OpenGraphMeta – при установке использует информацию описания Description2.
• Extension:MetaDescriptionTag
• Extension:Semantic Meta Tags