Extension:TextExtracts/ru

This extension comes with MediaWiki 1.34 and above. Таким образом, вам не нужно загружать его снова. Тем не менее, вы всё равно должны следовать другим инструкциям.
Category:Extensions bundled with MediaWiki 1.34/ru
This extension is under code stewardship review and not actively maintained (T256505). No new feature requests will be considered during this period.
Category:GPL licensed extensions/ru
Справка по расширениям MediaWiki
TextExtracts
Статус релиза: стабильноCategory:Stable extensions/ru
Реализация API Category:API extensions/ru
Описание Provides API with plain-text or limited HTML extracts of page content
Автор(ы) Max Semenik (MaxSemобсуждение)
Политика совместимости Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
Изменения в БД Нет
Лицензия GNU General Public License 2.0 или позднее
Скачать
Скачать расширение
Git [?]:
Category:Extensions in Wikimedia version control/ru
Параметры
  • $wgExtractsRemoveClasses
  • $wgExtractsExtendOpenSearchXml
  • $wgExtractsExtendRestSearch
Используемые хуки
Ежеквартальные загрузки 53 (Ranked 47th)
Использование общедоступными вики 2,046 (Ranked 189th)
Переведите расширение TextExtracts, если оно доступно на translatewiki.net
Проблемы Открытые задачи · Сообщить об ошибке
Category:All extensions/ru

Расширение "Text Extracts" предоставляет API, который позволяет извлекать из содержимого страницы обычный текст или ограниченный HTML (HTML с содержимым из некоторые классы CSS удалены).

Установка

  • Скачайте и распакуйте файл(ы) в папку с названием TextExtracts в вашей папке extensions/.
    Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TextExtracts
  • Добавьте следующий код в конце вашего файла LocalSettings.php : 
    wfLoadExtension( 'TextExtracts' );
  • Yes Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Настройки конфигурации

  • $wgExtractsRemoveClasses - это массив из <tag>, <tag>.class, .<class>, #<id> , который будет исключен из вывода.
    Например, $wgExtractsRemoveClasses[] = 'dl'; удаляет отрезкованный текст, часто используемый для необработанных примечаний, которые не желаются в резюме.
    extension.json определяет дефолты, из которых один из них - класс "noexcerpt" - это может быть добавлено в любой шаблон, чтобы исключить его.
  • $wgExtractsExtendOpenSearchXml определяет, следует ли TextExtracts предоставлять свои выдержки в модуль API Opensearch. По умолчанию неверно.

API

extracts
Возвращает обычный текст или ограниченные HTML-выдержки из заданных страниц
Этот модуль не может быть использован в качестве генератора.
Префикс ex
Необходимые права нет
Только POST? Нет
Генерируемая справка Текущее

prop=extracts (ex)

(main | query | extracts)

Returns plain-text or limited HTML extracts of the given pages.

Specific parameters:
Other general parameters are available.
exchars

How many characters to return. Actual text returned might be slightly longer.

Type: integer
The value must be between 1 and 1,200.
exsentences

How many sentences to return.

Type: integer
The value must be between 1 and 10.
exlimit

How many extracts to return. (Multiple extracts can only be returned if exintro is set to true.)

Type: integer or max
The value must be between 1 and 20.
Default: 20
exintro

Return only content before the first section.

Type: boolean (details)
explaintext

Return extracts as plain text instead of limited HTML.

Type: boolean (details)
exsectionformat

How to format sections in plaintext mode:

plain
No formatting.
wiki
Wikitext-style formatting (== like this ==).
raw
This module's internal representation (section titles prefixed with <ASCII 1><ASCII 2><section level><ASCII 2><ASCII 1>).
One of the following values: plain, raw, wiki
Default: wiki
excontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

Type: integer
Другой пример:
api.php?action=query&prop=extracts&exchars=100&explaintext&titles=Earth [попробуйте в ApiSandbox]
Результат
{
    "query": {
        "pages": {
            "9228": {
                "pageid": 9228,
                "ns": 0,
                "title": "Earth",
                "extract": "Earth, also called the world and, less frequently, Gaia, (or Terra in some works of science fiction)..."
            }
        }
    }
}

Предостережения

Существуют различные вещи, о которых следует знать при использовании API или программного обеспечения, использующего API, например, Расширение:Всплывающие окна.

  • Мы не рекомендуем использовать `exsentences`.(расширениями) Он не работает для HTML-выдержек и есть много крайних случаев, для которых он не существует. Например, "Генерал армии Инг. Джон Смит был солдатом". будет рассматриваться как 4 предложения. Мы не планируем это исправить.
  • Встроенные изображения извлекаются из ответа (даже в режиме HTML). Это означает, что если вы используете расширение Math и используете формулы в главном разделе, они могут не появиться в выводе резюме.
  • В режиме HTML мы не можем гарантировать хорошо сформированный HTML. Полученный HTML может быть недействительным или деформатированным (сломанным).
  • В режиме простого текста:
    • цитаты не могут быть удалены (см. phab:T197266)
    • Если абзац заканчивается тегом HTML, например, тегом реф, новые строки могут быть выброшены (см. phab:T201946)
    • новые строки могут быть выброшены после списков phab:T208132
    • Articles must begin with the lead paragraph for an extract to be generated. The use of any template, and/or unclosed or empty HTML element may result in no preview for the article. E.g. "<div></div>hello" will give an empty extract.

ЧЗВ

Как я могу удалить содержимое из предварительного просмотра/извлечения страницы?

TextExtracts удалит любой элемент, который отмечен классом .noexcerpt. Это обеспечивается конфигурационной переменной $wgExtractsRemoveClasses (которая также определяет некоторые другие исключенные элементы).

См. также

Category:Extensions used on Wikimedia/ru#TextExtracts/ru
Category:API extensions/ru Category:All extensions/ru Category:ApiOpenSearchSuggest extensions/ru Category:Extensions available as Debian packages/ru Category:Extensions bundled with MediaWiki 1.34/ru Category:Extensions in Wikimedia version control/ru Category:Extensions included in BlueSpice/ru Category:Extensions included in Canasta/ru Category:Extensions included in Fandom/ru Category:Extensions included in Miraheze/ru Category:Extensions included in MyWikis/ru Category:Extensions included in ProWiki/ru Category:Extensions included in WikiForge/ru Category:Extensions included in wiki.gg/ru Category:Extensions used on Wikimedia/ru Category:GPL licensed extensions/ru Category:SearchResultProvideDescription extensions/ru Category:Stable extensions/ru