Extension:Description2/ru

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

Description2 Статус релиза: стабильный
Реализация	Извлечение данных, Расширение парсера
Описание	Provides a meta description tag and adds data to parser output for other extensions to use.
Автор(ы)	Daniel Friesen (Dantmanобсуждение)
Последняя версия	0.4.1
Политика совместимости	Master maintains backward compatibility.
MediaWiki	>= 1.31.0
Изменения БД	Нет
Лицензия	GNU General Public License 2.0 or later
Загрузка	Скачать расширение Git [?]: скачать текущую версию исходника репозиторий (GitHub) история изменений список разработчиков (GitHub) code review
Параметры $wgEnableMetaDescriptionFunctions
Использованные hook'и OutputPageParserOutput ParserAfterTidy ParserFirstCallInit
Переведите расширение Description2 если оно доступно на translatewiki.net
Проверьте использование и версию.

The Description2 extension adds a description meta tag for articles automatically based on the content. This functionality appears to have been removed from MediaWiki at some point. There are some situations where description extraction (by entities less sophisticated than Google, like Facebook) will extract the wrong description information from the wiki and use something like the sitenotice as the description for a page instead of its content. This extension also adds the description to the parser output in a way that other extensions can make use of (to say provide description in a different format like Extension:OpenGraphMeta does, or perhaps to use it in article lists on the wiki).

Installation

• Скачайте и распакуйте файл(ы) в папку с названием Description2 в вашей папке extensions/.
• Добавьте следующие строки в конец файла LocalSettings.php:

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

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

Для использующих MediaWiki 1.29 или более ранние версии:

В приведенных выше инструкциях описывается новый способ установки этого расширения с использованием wfLoadExtension(). Если вам нужно установить это расширение на более ранние версии (MediaWiki 1.29 и более ранние), вместо wfLoadExtension( 'Description2' );, вам необходимо использовать:

require_once "$IP/extensions/Description2/Description2.php";

Extra options

If you set $wgEnableMetaDescriptionFunctions = true; in your LocalSettings.php a {{#description2:}} parser function can be used to control the description outputted for the page and override it with a custom one. You can use these parser extensions like so:

{{#description2:This is a description}}

You can use the description2 parser function instead to provide a description tag you can control with a template's variables.

Algorithm

Description is extracted from the HTML representation of a page:

1. Remove all ‎<table> elements (and its contents).
2. Find all ‎<p> elements.
3. Iterate over those paragraphs, stripping out all HTML tags and trimming whitespace around it.
4. The first non-empty paragraph (after all previous transformation) is picked as the description.

Things to consider:

• When using templates at the top of the articles, if you use ‎<div> instead of tables for the template, be sure it doesn't render paragraphs, which otherwise will be used as the description. This may happen if you have several ‎<div> inside the template with newlines.

См. также

• Extension:OpenGraphMeta – uses Description2's description information when installed.
• Extension:MetaDescriptionTag
• Extension:Semantic Meta Tags