Просмотр кода страницы Шаблон:Excerpt/doc

{{Documentation subpage}}
{{Lua|Module:Excerpt}}
Шаблон позволяет использовать части одних страниц на других страницах. Преимуществами такого действия являются:

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

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

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

Данный шаблон расширяет возможности {{Не переведено 5|Википедия:Включение|4=Help:Transclusion}} и {{Не переведено 5|Википедия:Включение помеченного раздела|4=Help:Labeled section transclusion}}.

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

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

* <code><nowiki>{{Excerpt|Название страницы}}</nowiki></code> — [[Трансклюзия|Включает]] преамбулу ([[:en:Africa#Water|пример]])
* <code><nowiki>{{Excerpt|Название страницы|Название раздела}}</nowiki></code> — Включает указанный раздел, исключая подразделы ([[:en:Eating#Mammals|пример]])

===Параметры===

* <code>1</code> или <code>article</code> или <code>page</code> — '''Обязательный.''' Название статьи или страницы для включения. По умолчанию будет включена преамбула ([[:en:Africa#Water|пример]]). Если страница содержит карточку, изображение и надпись карточку будут включены (если не будет установлен <code>files=0</code>). Шаблоны, указанные в [[Модуль:Excerpt/config]] не будут включены (если не будут запрошены с помощью {{para|templates}}, смотрите ниже).
* <code>2</code> или <code>section</code> или <code>fragment</code> — Название раздела для включения ([[:en:Eating#Mammals|пример]]) или по метке <code><nowiki><section></nowiki></code> для включения ([[:en:Axiom Space#Ax-1|пример]]). Должен быть помечен с помощью <code><nowiki><section begin=Название фрагмента/></nowiki></code> и <code><nowiki><section end=Название фрагмента/></nowiki></code> на странице включения. Обратите внимание, что шаблон позволяет использовать другие средства для указания отдельных фрагментов без необходимости использования меток разделов.
* <code>only</code> — Элементы для включения. По умолчанию все элементы будут включены (кроме шаблонов, исключенных в [[Модуль:Excerpt/config]])
** <code>only=file</code> — Включить только первый файл
** <code>only=files</code> — Включить только файлы
** <code>only=list</code> — Включить только первый список
** <code>only=lists</code> — Включить только списки
** <code>only=table</code> — Включить только первую таблицу
** <code>only=tables</code> — Включить только таблицы ([[:en:JKT48#Singles|пример]])
** <code>only=template</code> — Включить только первый шаблон
** <code>only=templates</code> — Включить только шаблоны
** <code>only=paragraph</code> — Включить только первый параграф
** <code>only=paragraphs</code> — Включить только параграфы
* <code>paragraphs</code> — Параграфы для включения. По умолчанию все параграфы включены.
** <code>paragraphs=0</code> — Не включать параграфы
** <code>paragraphs=1</code> — Включить первый параграф
** <code>paragraphs=2</code> — Включить второй параграф
** <code>paragraphs=1,3</code> — Включить первый и третий параграфы
** <code>paragraphs=1-3</code> — Включить первый, второй и третий параграфы
** <code>paragraphs=1-3,5</code> — Включить первый, второй, третий и пятый параграфы
** <code>paragraphs=-1</code> — Включить все параграфы, кроме первого
** <code>paragraphs=-2</code> — Включить все параграфы, кроме второго
** <code>paragraphs=-1,3</code> — Включить все параграфы, кроме первого и третьего
** <code>paragraphs=-1-3</code> — Включить все параграфы, кроме первого, второго и третьего
** <code>paragraphs=-1-3,5</code> — Включить все параграфы, кроме первого, второго, третьего и пятого
* <code>lists</code> — Списки для включения. По умолчанию все списки включены. Синтакс такой же, как и при включении параграфов.
* <code>files</code> — Файлы для включения. По умолчанию все файлы включены. Синтакс такой же, как и при включении параграфов, но также:
** <code>files=A.jpg</code> — Включить файл под названием 'A.jpg'
** <code>files=A.jpg, B.png, C.gif</code> — Включить файлы под названиями 'A.jpg', 'B.png' и 'C.gif'
** <code>files=.+%.png</code> — Включить все PNG файлы
** <code>files=-A.jpg</code> — Включить все файлы, кроме файла под названием 'A.jpg'
** <code>files=-A.jpg, B.png, C.gif</code> — Включить все файлы, кроме файлов под названиями 'A.jpg', 'B.png' и 'C.gif'
** <code>files=-.+%.png</code> — Включить все файлы, кроме файлов PNG
* <code>tables</code> — Таблицы для включения. По умолчанию все таблицы включены. Синтакс такой же, как и при включении параграфов, но также:
** <code>tables=Stats2020</code> — Включить таблицу с идентификатором 'Stats2020'
** <code>tables=Stats2020, Stats2019, Stats2018</code> — Включить все таблицы с идентификаторами 'Stats2020', 'Stats2019' и 'Stats2018'
** <code>tables=-Stats2020</code> — Включить все таблицы, кроме таблицы с идентификатором 'Stats2020'
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — Включить все таблицы, кроме таблиц с идентификаторами 'Stats2020', 'Stats2019' и 'Stats2018'
* <code>templates</code> — Шаблоны для включения. По умолчанию все шаблоны будут включены, кроме добавленных в чёрный список на [[Модуль:Excerpt/config]]. Использование дефиса перед списком шаблонов, разделённых запятыми, добавляет эти шаблоны в чёрный список.
** <code>templates=-Морские течения</code> — Добавить шаблон 'Морские течения' в чёрный список
** <code>templates=-Морские течения, Nature</code> — Добавить шаблоны 'Морские течения' и 'Nature' в чёрный список
** <code>templates=Персона</code> — Игнорировать чёрный список и включить шаблон 'Персона'
** <code>templates=Персона, Морские течения</code> — Игнорировать чёрный список и включить шаблоны 'Персона' и 'Морские течения'
** <code>templates=.*</code> — Игнорировать чёрный список и включить все шаблоны
* <code>this</code> — Изменить изначальный текст {{Не переведено 5|Заголовочная пометка|заголовочной пометки|4=Hatnote}}. Например, если включенное содержимое является галереей, вы можете набрать <code>this=Эта галерея является</code>, после чего заголовочная пометка будет выглядеть так: "Эта галерея является выдержкой из..." ([[:en:Eastern Distributor#Toll prices|пример]]).
* <code>displaytitle</code> — Изменить текст ссылки в заголовочной пометке. Например, [[:en:WP:ITHAT|добавление курсива]], индексов и т.д.
* <code>hat=no</code> — Спрятать заголовочную пометку "Этот раздел является выдержкой из..."
* <code>bold=yes</code> — Сохранить '''полужирный''' текст.
* <code>links=no</code> — Убрать все викиссылки.
* <code>quote=yes</code> — Обернуть выдержку с помощью меток <code><nowiki><blockquote></nowiki></code>.
* <code>inline=yes</code> — Убрать заголовочную пометку и метки <code><nowiki><div></nowiki></code> вокруг выдержки для использования внутри другого текста.
* <code>onlyfreefiles=no</code> — Позволяет включать несвободные файлы.
* <code>briefdates=yes</code> — Перевести информацию о рождении и смерти в формат (YYYY-YYYY)
* <code>references=no</code> — Убрать все сноски (источники).
* <code>subsections=yes</code> — Включить подразделы включаемого раздела. Обратите внимание, что если включается раздел 3 уровня и подразделы также 3 уровня, то включенные подразделы будут отображаться с той же иерархией, что и включаемый раздел, что, скорее всего, является нежелательным, поэтому используйте с осторожностью.

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

[[File:How to excerpt.webm|thumb|Как заменить раздел на выдержку.]]

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

# Открыть раздел в одной вкладке и подстраницу в другой.
# Начать править обе страницы (нажать кнопку Править).
# Скопировать текст раздела и вставить его под преамбулой подстраницы.
# Удалить повторяющееся содержимое и поправить текст, исходя из здравого смысла.
# Сохранить изменения подстраницы, указав в описании правки что-то вроде: "Перенос содержимого из <nowiki>[[Страница]]</nowiki>".
# Назад к разделу, удалить всё содержимое раздела и заменить его выдержкой из подстраницы.
# Сохранить изменения раздела, указав в описании правки что-то вроде: "Перенос содержимого в <nowiki>[[Подстраница]]</nowiki>", и оставить выдержку.

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

{{Further|Википедия:Механизм шаблонов#Теги noinclude, includeonly, onlyinclude}}

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

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

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

Пожалуйста, учтите, что когда тег <code><nowiki></noinclude></nowiki></code> обёрнут на новую строку, следующий за ним символ будет интерпретирован как начало строки. Это может создать проблемы форматирования. Например, когда после <code><nowiki></noinclude></nowiki></code> в начале строки находится {{Не переведено 5|Пробел (программирование)|пробел|4=Whitespace character}}, движок страницы воспримет это как начальный пробел, который отображает следующий параграф в [[Блок (программирование)|блоке кода]] и [[моноширинный шрифт]] с сохранённым форматированием. По этой причине никакие пробелы не должны отделять тег <code><nowiki></noinclude></nowiki></code> от предшествующего ему текста.

==См. также==

* [[Модуль:Excerpt]]
* [[Модуль:Excerpt/config]]
* [[Модуль:Transcluder]]

==Template data==

{{TemplateData заголовок}}
<templatedata>
{
	"params": {
		"1": {
			"aliases": [
				"article",
				"page"
			],
			"label": "Статья",
			"description": "Название статьи или страницы для включения",
			"example": "Наука",
			"type": "wiki-page-name",
			"required": true
		},
		"2": {
			"aliases": [
				"section",
				"fragment"
			],
			"label": "Раздел",
			"description": "Название раздела или тега <section> для включения",
			"example": "История",
			"type": "string"
		},
		"paragraphs": {
			"label": "Параграфы",
			"description": "Параграфы для включения",
			"example": "1-3,5",
			"type": "string",
			"aliases": [
				"paragraph"
			]
		},
		"files": {
			"label": "Файлы",
			"description": "Файлы для включения",
			"example": "1-3,5",
			"type": "string",
			"default": "1",
			"aliases": [
				"file"
			]
		},
		"subsections": {
			"label": "Подразделы",
			"description": "Включать ли подразделы включаемого раздела",
			"example": "да",
			"type": "boolean"
		},
		"tables": {
			"label": "Таблицы",
			"description": "Таблицы для включения",
			"example": "Stats2020",
			"type": "string",
			"aliases": [
				"table"
			]
		},
		"references": {
			"label": "Сноски",
			"description": "Включать ли сноски",
			"example": "нет",
			"type": "boolean"
		},
		"only": {
			"label": "Только",
			"description": "Включить только этот тип элемента",
			"example": "table",
			"type": "string"
		},
		"this": {
			"label": "Это",
			"description": "Изменить изначальный текст заголовочной пометки",
			"example": "Эта галерея является",
			"type": "string"
		},
		"displaytitle": {
			"label": "Показываемое название",
			"description": "Изменить текст ссылки в заголовочной пометке",
			"type": "string"
		},
		"class": {
			"label": "Класс",
			"description": "Дополнительный CSS класс",
			"example": "noprint",
			"type": "string"
		},
		"hat": {
			"label": "Заголовочная пометка",
			"description": "Включать ли заголовную пометку",
			"example": "нет",
			"type": "boolean",
			"default": "да"
		},
		"bold": {
			"label": "Полужирный",
			"description": "Сохранять ли полужирное форматирование текста",
			"example": "нет",
			"type": "boolean",
			"default": "да"
		},
		"links": {
			"label": "Викиссылки",
			"description": "Сохранять ли викиссылки",
			"example": "нет",
			"type": "boolean",
			"default": "да"
		},
		"quote": {
			"label": "Цитата",
			"description": "Оборачивает выдержку в теги <blockquote>",
			"example": "да",
			"type": "boolean",
			"default": "нет"
		},
		"inline": {
			"label": "Внутристрочное",
			"description": "Убрать заголовочную пометку и теги <div> вокруг выдержки для использования внутри другого текста",
			"example": "да",
			"type": "boolean",
			"default": "нет"
		},
		"lists": {
			"aliases": [
				"list"
			],
			"label": "Списки",
			"description": "Списки для включения",
			"example": "1",
			"type": "string"
		},
		"templates": {
			"aliases": [
				"template"
			],
			"label": "Шаблоны",
			"description": "Шаблоны для включения",
			"example": "Персона",
			"type": "string"
		},
		"onlyfreefiles": {
			"label": "Только свободные файлы",
			"description": "Включить несвободные файлы",
			"example": "да",
			"type": "boolean",
			"default": "нет"
		},
		"briefdates": {
			"label": "Короткие даты",
			"description": "Превращает информацию о рождении и смерти в формат (YYYY-YYYY)",
			"example": "да",
			"type": "boolean",
			"default": "нет"
		}
	},
	"description": "Данный шаблон используется для включения части одной страницы в другую страницу.",
	"paramOrder": [
		"1",
		"2",
		"only",
		"paragraphs",
		"files",
		"tables",
		"lists",
		"templates",
		"references",
		"subsections",
		"hat",
		"bold",
		"links",
		"quote",
		"this",
		"displaytitle",
		"inline",
		"onlyfreefiles",
		"briefdates",
		"class"
	]
}
</templatedata>

<includeonly>
<!-- Категории добавлять сюда, а интервики в Викиданные -->
[[Категория:Шаблоны:Разделы статьи]]
</includeonly>