Шаблон:Excerpt/doc

Шаблон позволяет использовать части одних страниц на других страницах. Преимуществами такого действия являются:

• Снижение расходов на обслуживание: предотвращается дублирование содержимого, которое необходимо обновлять несколько раз на разных страницах
• Улучшение качества содержимого: редакторы объединяют связанное содержимое вместо создания нескольких версий разной степени качества
• Способствование сотрудничеству: редакторы работают в одном месте, что позволяет избежать параллельной работы над одним содержимым в разных местах

Такая практика также имеет недостатки:

• Чтобы отредактировать содержимое подстатьи, показываемое шаблоном в основной статье, редактору нужно перейти с основной статьи на подстатью (но также можно включить кнопку [редактировать], по которой можно сразу перейти к редактированию подстатьи)
• Часть одной статьи не всегда идеально вписывается в другую статью (но смотрите #Уточнение с использованием контроля включения)
• Изменения подстатьи не показываются в списке наблюдения, если в список наблюдения добавлена только основная статья (смотрите phab:T55525)

Данный шаблон расширяет возможности Википедия:Включение и Википедия:Включение помеченного раздела.

Использование

Основная информация

• {{Excerpt|Название страницы}} — Включает преамбулу (пример)
• {{Excerpt|Название страницы|Название раздела}} — Включает указанный раздел, исключая подразделы (пример)

Параметры

• 1 или article или page — Обязательный. Название статьи или страницы для включения. По умолчанию будет включена преамбула (пример). Если страница содержит карточку, изображение и надпись карточку будут включены (если не будет установлен files=0). Шаблоны, указанные в Модуль:Excerpt/config не будут включены (если не будут запрошены с помощью |templates =, смотрите ниже).
• 2 или section или fragment — Название раздела для включения (пример) или по метке <section> для включения (пример). Должен быть помечен с помощью <section begin=Название фрагмента/> и <section end=Название фрагмента/> на странице включения. Обратите внимание, что шаблон позволяет использовать другие средства для указания отдельных фрагментов без необходимости использования меток разделов.
• only — Элементы для включения. По умолчанию все элементы будут включены (кроме шаблонов, исключенных в Модуль:Excerpt/config)
  • only=file — Включить только первый файл
  • only=files — Включить только файлы
  • only=list — Включить только первый список
  • only=lists — Включить только списки
  • only=table — Включить только первую таблицу
  • only=tables — Включить только таблицы (пример)
  • only=template — Включить только первый шаблон
  • only=templates — Включить только шаблоны
  • only=paragraph — Включить только первый параграф
  • only=paragraphs — Включить только параграфы
• 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 — Включить все параграфы, кроме первого, второго, третьего и пятого
• lists — Списки для включения. По умолчанию все списки включены. Синтакс такой же, как и при включении параграфов.
• 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
• tables — Таблицы для включения. По умолчанию все таблицы включены. Синтакс такой же, как и при включении параграфов, но также:
  • tables=Stats2020 — Включить таблицу с идентификатором 'Stats2020'
  • tables=Stats2020, Stats2019, Stats2018 — Включить все таблицы с идентификаторами 'Stats2020', 'Stats2019' и 'Stats2018'
  • tables=-Stats2020 — Включить все таблицы, кроме таблицы с идентификатором 'Stats2020'
  • tables=-Stats2020, Stats2019, Stats2018 — Включить все таблицы, кроме таблиц с идентификаторами 'Stats2020', 'Stats2019' и 'Stats2018'
• templates — Шаблоны для включения. По умолчанию все шаблоны будут включены, кроме добавленных в чёрный список на Модуль:Excerpt/config. Использование дефиса перед списком шаблонов, разделённых запятыми, добавляет эти шаблоны в чёрный список.
  • templates=-Морские течения — Добавить шаблон 'Морские течения' в чёрный список
  • templates=-Морские течения, Nature — Добавить шаблоны 'Морские течения' и 'Nature' в чёрный список
  • templates=Персона — Игнорировать чёрный список и включить шаблон 'Персона'
  • templates=Персона, Морские течения — Игнорировать чёрный список и включить шаблоны 'Персона' и 'Морские течения'
  • templates=.* — Игнорировать чёрный список и включить все шаблоны
• this — Изменить изначальный текст заголовочной пометки. Например, если включенное содержимое является галереей, вы можете набрать this=Эта галерея является, после чего заголовочная пометка будет выглядеть так: «Эта галерея является выдержкой из…» (пример).
• displaytitle — Изменить текст ссылки в заголовочной пометке. Например, добавление курсива, индексов и т. д.
• hat=no — Спрятать заголовочную пометку «Этот раздел является выдержкой из…»
• bold=yes — Сохранить полужирный текст.
• links=no — Убрать все викиссылки.
• quote=yes — Обернуть выдержку с помощью меток <blockquote>.
• inline=yes — Убрать заголовочную пометку и метки <div> вокруг выдержки для использования внутри другого текста.
• onlyfreefiles=no — Позволяет включать несвободные файлы.
• briefdates=yes — Перевести информацию о рождении и смерти в формат (YYYY-YYYY)
• references=no — Убрать все сноски (источники).
• subsections=yes — Включить подразделы включаемого раздела. Обратите внимание, что если включается раздел 3 уровня и подразделы также 3 уровня, то включенные подразделы будут отображаться с той же иерархией, что и включаемый раздел, что, скорее всего, является нежелательным, поэтому используйте с осторожностью.

Замена Шаблон: Основная статья

Как заменить раздел на выдержку.

Разделы часто являются краткими изложениями более узкоспециализированных подстраниц (обычно на них ссылаются с помощью Шаблон:Основная статья). Иногда бывает удобно заменить содержимое таких разделов выдержками из подстраниц (после объединения ценного содержимого раздела с подстраницей). В таких случаях эффективным является:

1. Открыть раздел в одной вкладке и подстраницу в другой.
2. Начать править обе страницы (нажать кнопку Править).
3. Скопировать текст раздела и вставить его под преамбулой подстраницы.
4. Удалить повторяющееся содержимое и поправить текст, исходя из здравого смысла.
5. Сохранить изменения подстраницы, указав в описании правки что-то вроде: «Перенос содержимого из [[Страница]]».
6. Назад к разделу, удалить всё содержимое раздела и заменить его выдержкой из подстраницы.
7. Сохранить изменения раздела, указав в описании правки что-то вроде: «Перенос содержимого в [[Подстраница]]», и оставить выдержку.

Уточнение с использованием контроля включения

Подробное рассмотрение темы: Википедия:Механизм шаблонов § Теги noinclude, includeonly, onlyinclude

Иногда текст не полностью подходит для включения. В этих случаях вы можете изменить страницу-источник, добавив теги <noinclude>...</noinclude> вокруг содержимого, которое вам не нужно в выдержке, и теги <includeonly>...</includeonly> вокруг содержимого, которое вы хотите видеть в выдержке.

Например, страница Конспирологические теории о пандемии COVID-19 начинается с Конспирологические теории о пандемии COVID-19 и дезинформация ... Однако, при включении преамбулы в раздел о конспирологических теориях страницы Пандемия COVID-19, нам не нужно уточнять о какой пандемии идёт речь. Поэтому, код Конспирологические теории о <noinclude>[[Пандемия COVID-19|пандемии COVID-19]]</noinclude><includeonly>пандемии</includeonly> и дезинформация может быть использован на странице о конспирологических теориях, а на странице о пандемии он будет показан как Конспирологические теории о пандемии и дезинформация ....

Хорошая идея для страницы, которую часто правят ― оставить невидимый комментарий, объясняющий, почему были установлены теги, чтобы ни у кого не было соблазна удалить их.

Пожалуйста, учтите, что когда тег </noinclude> обёрнут на новую строку, следующий за ним символ будет интерпретирован как начало строки. Это может создать проблемы форматирования. Например, когда после </noinclude> в начале строки находится пробел, движок страницы воспримет это как начальный пробел, который отображает следующий параграф в блоке кода и моноширинный шрифт с сохранённым форматированием. По этой причине никакие пробелы не должны отделять тег </noinclude> от предшествующего ему текста.

См. также

• Модуль:Excerpt
• Модуль:Excerpt/config
• Модуль:Transcluder

Template data

Здесь приведена документация в формате TemplateData для данного шаблона, которая используется в TemplateWizard, визуальном редакторе и прочих инструментах. Смотрите ежемесячный отчет об использовании параметров этого шаблона в статьях.

Данный шаблон используется для включения части одной страницы в другую страницу.

Параметры шаблона

Параметр		Описание	Тип	Статус
Статья	1 article page	Название статьи или страницы для включения Пример Наука	Имя страницы	обязательный
Раздел	2 section fragment	Название раздела или тега <section> для включения Пример История	Строковый (без форматирования)	необязательный
Только	only	Включить только этот тип элемента Пример table	Строковый (без форматирования)	необязательный
Параграфы	paragraphs paragraph	Параграфы для включения Пример 1-3,5	Строковый (без форматирования)	необязательный
Файлы	files file	Файлы для включения По умолчанию 1 Пример 1-3,5	Строковый (без форматирования)	необязательный
Таблицы	tables table	Таблицы для включения Пример Stats2020	Строковый (без форматирования)	необязательный
Списки	lists list	Списки для включения Пример 1	Строковый (без форматирования)	необязательный
Шаблоны	templates template	Шаблоны для включения Пример Персона	Строковый (без форматирования)	необязательный
Сноски	references	Включать ли сноски Пример нет	Логическое значение	необязательный
Подразделы	subsections	Включать ли подразделы включаемого раздела Пример да	Логическое значение	необязательный
Заголовочная пометка	hat	Включать ли заголовную пометку По умолчанию да Пример нет	Логическое значение	необязательный
Полужирный	bold	Сохранять ли полужирное форматирование текста По умолчанию да Пример нет	Логическое значение	необязательный
Викиссылки	links	Сохранять ли викиссылки По умолчанию да Пример нет	Логическое значение	необязательный
Цитата	quote	Оборачивает выдержку в теги <blockquote> По умолчанию нет Пример да	Логическое значение	необязательный
Это	this	Изменить изначальный текст заголовочной пометки Пример Эта галерея является	Строковый (без форматирования)	необязательный
Показываемое название	displaytitle	Изменить текст ссылки в заголовочной пометке	Строковый (без форматирования)	необязательный
Внутристрочное	inline	Убрать заголовочную пометку и теги <div> вокруг выдержки для использования внутри другого текста По умолчанию нет Пример да	Логическое значение	необязательный
Только свободные файлы	onlyfreefiles	Включить несвободные файлы По умолчанию нет Пример да	Логическое значение	необязательный
Короткие даты	briefdates	Превращает информацию о рождении и смерти в формат (YYYY-YYYY) По умолчанию нет Пример да	Логическое значение	необязательный
Класс	class	Дополнительный CSS класс Пример noprint	Строковый (без форматирования)	необязательный