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

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

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

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

Данный шаблон расширяет возможности и .

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

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

• {{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>...</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