Этот шаблон используется для повторного использования частей страниц на других страницах. Эта практика имеет различные преимущества и недостатки.
Этот шаблон расширяет возможности встроенного обычного включения и включения помеченных разделов .
{{Excerpt|Page title}}
— Включите ведущий раздел ( пример ){{Excerpt|Page title|Section title}}
— Включить конкретный раздел, исключая любые подразделы ( пример )Существует один обязательный параметр и множество дополнительных для настройки отрывка:
Идентификация источника
|1=
– Название статьи или страницы, которую нужно включить. Необходимый. Псевдонимы: |article=
или |page=
.|2=
– Имя раздела или тега для включения. Необязательный; если этот параметр опущен, включается главный раздел (содержимое над заголовком первого раздела). Псевдонимы: |section=
или |fragment=
.Конфигурация включения
Трансклюдентный контент определяется как один из нескольких типов элементов : file
, list
, paragraph
, reference
, subsection
, table
или template
. Параметры конфигурации указывают, какой тип элемента необходимо включить, а в некоторых случаях, сколько и какие элементы этого типа следует включить. Все параметры конфигурации являются необязательными; если этот параметр опущен, все элементы всех типов элементов исключаются из исходной страницы, идентифицируемой двумя безымянными параметрами. Некоторые типы элементов поддерживают условное исключение элементов путем указания диапазона номеров элементов (1–3) или серии запятых (1, 2, 5); к этим типам относятся: файлы, списки, абзацы и таблицы.
Существует десять дополнительных параметров конфигурации включения:
|only=
– Типы элементов для включения. Ценности: file(s)
, list(s)
, table(s)
, template(s)
, paragraph(s)
. По умолчанию: все типы элементов.|files=
– Файлы для включения. По умолчанию: все файлы. Тот же базовый синтаксис, что и |paragraphs=
, но см. § Подробности.|onlyfreefiles=no
– Включает включение несвободных файлов . По умолчанию: исключить платный контент.|links=no
– Отключите все вики-ссылки и визуализируйте их как обычный текст.|lists=
– Списки ( маркированные , нумерованные ) для включения. По умолчанию: все списки. Тот же синтаксис, что и для |paragraphs=
.|paragraphs=
– Абзацы, которые необходимо исключить. По умолчанию: все абзацы.|references=no
– Исключить все ссылки между <ref>...</ref>
тегами.|subsections=yes
– Включить подразделы включенного раздела. По умолчанию: только контент над заголовком первого подраздела.|tables=
– Таблицы для включения. По умолчанию: все таблицы. Тот же базовый синтаксис, что и |paragraphs=
, но см. § Подробности.|templates=
– Шаблоны для включения. По умолчанию включены все шаблоны, кроме тех, которые занесены в черный список Module:Excerpt/config . См. § Подробности о том, как указать конкретный шаблон или шаблоны для включения или исключения.Стиль и дополнительные возможности
Эти необязательные параметры изменяют способ отображения включенных элементов:
|bold=yes
– Сохранить жирный текст.|briefdates=yes
– Сокращение информации о рождении и смерти до формата (ГГГГ-ГГГГ).|displaytitle=
– Измените текст ссылки в шапке. Например, добавьте курсив , индексы и т. д.|hat=no
– Скрыть шапку «Этот раздел представляет собой отрывок из...»|inline=yes
– Удалите шляпную заметку и <div>
теги вокруг отрывка, чтобы использовать его внутри другого текста или добавлять после него ссылки или другой контент без разрыва абзаца между ними.|quote=yes
– Оберните отрывок <blockquote>
тегами.|this=
– Измените исходный текст шляпной заметки. Например, если включенный контент представляет собой галерею, вы можете настроить |this=This gallery is
так, чтобы в шапке было написано: «Эта галерея представляет собой отрывок из...».|1=
или |article=
или|page=
|files=0
установлено). Кроме того, шаблоны, перечисленные в Module:Excerpt/config, не будут включены (если это явно не запрошено с помощью |templates=
, см. ниже).|2=
или |section=
или|fragment=
<section>
который нужно включить ( example ). В случае тега раздела раздел должен быть помечен значком <section begin="Name of the fragment" />
и <section end="Name of the fragment" />
на странице, подлежащей включению. Обратите внимание, что этот шаблон предоставляет другие способы таргетинга на определенные фрагменты страницы без необходимости прибегать к тегам разделов.|only=
|only=
является исключающим параметром и исключает все другие типы элементов, кроме того, который вы называете, так что, например, при указании |only=paragraphs
исключаются все списки, таблицы, шаблоны и т. д. Значения параметров могут быть в единственном числе (например, |only=paragraph
) или множественном числе (например, |only=paragraphs
) и означать разные вещи: в единственном числе включается только первый элемент этого типа элемента; во множественном числе все предметы есть.|only=file
– Включить только первый файл (но не списки, абзацы, таблицы и т. д.)|only=files
– Транслировать все файлы (но ничего больше)|only=list
– Включите только первый список, исключите все остальные типы элементов.|only=lists
– Включить все списки (но ничего больше)|only=table
– Включите только первую таблицу, исключите все остальные типы элементов.|only=tables
– Транслировать все таблицы (но ничего больше) ( пример )|only=template
– Включите только первый шаблон (исключая шаблоны, занесенные в черный список Module:Excerpt/config , а также все остальные типы элементов)|only=templates
– Исключить все шаблоны (кроме шаблонов из черного списка) (но ничего больше)|only=paragraph
– Включите только первый абзац, исключите все остальные типы элементов.|only=paragraphs
– Исключите все абзацы (но ничего больше)|files=
|files=A.jpg
– Включите файл с именем «A.jpg».|files=A.jpg, B.png, C.gif
– Включите файлы с именами «A.jpg», «B.png» и «C.gif».|files=.+%.png
– Транслировать все файлы PNG|files=-A.jpg
– Транслировать все файлы, кроме файла с именем «A.jpg».|files=-A.jpg, B.png, C.gif
– Транслировать все файлы, кроме файлов с именами «A.jpg», «B.png» и «C.gif».|files=-.+%.png
– Транслировать все файлы, отличные от PNG.|paragraphs=
|paragraphs=0
– Не включать абзацы|paragraphs=1
- Исключить первый абзац|paragraphs=2
– Исключить второй абзац.|paragraphs=1,3
– Исключить первый и третий абзацы.|paragraphs=1-3
– Исключить первый, второй и третий абзацы.|paragraphs=1-3,5
– Исключить первый, второй, третий и пятый абзацы.|paragraphs=-1
– Исключить все абзацы, кроме первого.|paragraphs=-2
– Исключить все абзацы, кроме второго.|paragraphs=-1,3
– Исключить все абзацы, кроме первого и третьего.|paragraphs=-1-3
– Исключить все абзацы, кроме первого, второго и третьего.|paragraphs=-1-3,5
– Исключить все абзацы, кроме первого, второго, третьего и пятого.|subsections=yes
|tables=
|tables=Stats2020
– Включите таблицу с идентификатором «Stats2020».|tables=Stats2020, Stats2019, Stats2018
– Включите таблицы с идентификаторами «Stats2020», «Stats2019» и «Stats2018».|tables=-Stats2020
– Включите все таблицы, кроме таблицы с идентификатором «Stats2020».|tables=-Stats2020, Stats2019, Stats2018
– Включите все таблицы, кроме тех, которые имеют идентификаторы «Stats2020», «Stats2019» и «Stats2018».|templates=
|templates=-Ocean
– Добавьте шаблон «Океан» в черный список|templates=-Ocean, Nature
– Добавьте в черный список шаблоны «Океан» и «Природа».|templates=Infobox person
– Игнорировать черный список и включить шаблон «Информационный ящик»|templates=Infobox person, Ocean
– Игнорировать черный список и исключить шаблоны «Инфобокс человек» и «Океан».|templates=.*
– Игнорировать черный список и исключить все шаблоныДля простых случаев включения разделов статей используются {{ #section }}, {{ #section-x }} и {{ #section-h }} (сокращенно {{ #lst }}, {{ #lstx }} , и {{ #lsth }})) вместо этого шаблона можно использовать функции синтаксического анализатора. {{ #lsth : статья | имя_фрагмента }} включит раздел « статьи » с заголовком « имя_фрагмента », а {{ #lsth : статья }} включит главный раздел « статьи ». Выделить только определенные абзацы можно, разметив исходную статью тегами и используя {{ #lst : статья | имя_фрагмента }} для включения этих фрагментов, что эквивалентно использованию параметра с этим шаблоном. {{ #lsth : статья | имя_фрагмента }} также можно использовать для включения всего, кроме этих фрагментов.<section begin=fragmentname/>...<section end=fragmentname/>
|fragment=fragmentname
Текст не будет обрезан из-за лишних пробелов, не будет заголовка (эквивалентного |hat=no
, и все файлы, шаблоны, таблицы, ссылки и подразделы будут включены, если исходная статья не помечена , или тегами. Собственные ссылки будет выделено жирным шрифтом.<section begin=fragmentname/>...<section end=fragmentname/>
<noinclude>...</noinclude>
<onlyinclude>...</onlyinclude>
Может случиться так, что источник, из которого вы хотите извлечь выдержку, содержит сноски в стиле цитирования, отличном от стиля вашей статьи, и выдержка из источника может привести к несоответствию стиля цитирования, что противоречит руководящим принципам цитирования источников . Иногда отрывок все же можно использовать, избегая несоответствия в стиле, используя параметры |references=no
и |inline=yes
.
Если источник, который вы хотите извлечь, имеет несколько тегов ссылок, разбросанных по всему источнику, и они должны отображаться именно в этих местах, чтобы обеспечить полную проверяемость , то этот источник может быть неподходящим кандидатом для включения через {{excerpt} }, и лучшим выбором может быть копирование содержимого из источника в статью.
Однако, если исходная страница, которую вы хотите извлечь, имеет:
тогда ты сможешь это сделать. Чтобы реализовать это, используйте параметры, |references=no
чтобы удалить теги ссылок из включенного содержимого и |inline=yes
определить отрывок как встроенный элемент отображения , чтобы § подавить разрывы строк между абзацами, а затем вручную добавить копию всех ссылок в источнике. сразу после фигурных скобок, завершающих тег excert в целевой статье, без разрывов строк, пробелов или других символов между тегом и добавленными ссылками. Скопированные ссылки необходимо будет вручную преобразовать из стиля короткой сноски в стиль полного встроенного цитирования или наоборот, чтобы он соответствовал стилю цитирования цели.
Когда в очень общей статье используются выдержки из более конкретных статей, которые, в свою очередь, используют выдержки из еще более конкретных статей, возникает древовидная структура , называемая «деревом выдержек».
Здесь вы можете перемещаться по основным деревьям выдержек в английской Википедии. Это полезно для редакторов, заинтересованных в их расширении или улучшении. Чтобы перемещаться по деревьям, нажмите следующую кнопку (S) :
Иногда отрывок почти подходит для включения, но не совсем. В этих случаях вы можете отредактировать исходную страницу, добавив <noinclude>...</noinclude>
теги вокруг контента, который вам не нужен во фрагменте, и <includeonly>...</includeonly>
теги вокруг контента, который вам нужен только во фрагменте.
Например, страница дезинформации о COVID-19 начинается со слов « Пандемия COVID-19 привела к дезинформации …». Однако, когда эта выдержка приводит к разделу дезинформации о пандемии COVID-19 , нам не нужно уточнять, о какой пандемии мы говорим. Таким образом, код The <noinclude>[[COVID-19 pandemic]]</noinclude><includeonly>pandemic</includeonly> has resulted in [[misinformation]]
можно использовать на странице дезинформации, чтобы он отображался на странице пандемии как «Пандемия привела к дезинформации …».
Для страниц с большим количеством правок может быть хорошей идеей оставить скрытый комментарий, объясняющий, почему существуют теги, чтобы ни у кого не возникло искушения удалить их, например:The <noinclude>[[COVID-19 pandemic]]</noinclude><!--These tags are used to refine the excerpt at [[COVID-19 pandemic]]--><includeonly>pandemic</includeonly> has resulted in [[misinformation]]
Обратите внимание, что когда </noinclude>
тег переносится на новую строку, символ рядом с ним будет интерпретироваться как начало строки. Это может привести к некоторым проблемам с форматированием. Например, если </noinclude>
за началом строки следует пробел , движок страниц преобразует его в начальный пробел , который отображает последующий абзац в блоке кода и моноширинном шрифте с сохраненным форматированием. По этой причине пробелы не должны отделять </noinclude>
тег от текста, которому он предшествует.
Раздел часто представляет собой краткое изложение родительской статьи более подробной страницы о подтеме, расположенной на дочерней странице ; они обычно связаны с Template:Main в родительском элементе. Иногда удобно заменить содержимое такого сводного раздела на родительской странице отрывком из лида дочерней страницы (после объединения любого ценного содержимого раздела с дочерней страницей). В таких случаях эффективным способом действий является:
Если вы хотите объединить два отрывка из источника в один более длинный в своей статье, используйте два отрывка вместо одного и измените режим отображения на встроенный . Так, например, вместо этого:
{{excerpt|Ocean color|paragraphs=2-3|file=no}}
// (пример взят из Ocean#Color )вы можете закодировать:
{{excerpt|Ocean color|paragraphs=2|file=no|inline=yes}}
{{excerpt|Ocean color|paragraphs=3|file=no|inline=yes}}
и это удалит разрыв строки между двумя абзацами, поэтому они будут отображаться как один абзац.
По умолчанию {{excerpt}} генерирует HTML -тег div , который является элементом отображения на уровне блока , поэтому смежные фрагменты обычно представляют собой отдельные элементы блока с разрывами строк между ними. Это можно переопределить с помощью параметра param |inline=yes
, который подавляет тег div и вместо этого приводит к созданию встроенного элемента отображения . В этом случае, как и при размещении текста на соседних строках викикода , разрыв строки между ними не создается. Этот метод также можно адаптировать для § изменения стиля цитирования или использования других ссылок.
Использование {{Excerpt}} имеет следующие преимущества:
Он также имеет следующие недостатки:
Если обнаружена ошибка, в статье вместо ожидаемого включенного контента появится сообщение об ошибке:
Этот шаблон используется для включения части статьи в другую статью.