https://bard-wiki.net/index.php?action=history&feed=atom&title=%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%3AExcerpt%2FdocШаблон:Excerpt/doc - История изменений2026-11-09T09:41:38ZИстория изменений этой страницы в викиMediaWiki 1.43.11https://bard-wiki.net/index.php?title=%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD:Excerpt/doc&diff=6368&oldid=prevAdmin: 1 версия импортирована2023-06-21T15:36:17Z<p>1 версия импортирована</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<tr class="diff-title" lang="ru">
<td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">← Предыдущая версия</td>
<td colspan="1" style="background-color: #fff; color: #202122; text-align: center;">Версия от 18:36, 21 июня 2023</td>
</tr><tr><td colspan="2" class="diff-notice" lang="ru"><div class="mw-diff-empty">(нет различий)</div>
</td></tr></table>Adminhttps://bard-wiki.net/index.php?title=%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD:Excerpt/doc&diff=6367&oldid=prevru>RenatUK: /* Уточнение с использованием контроля включения */ исправление2023-05-02T14:43:21Z<p><span class="autocomment">Уточнение с использованием контроля включения: </span> исправление</p>
<p><b>Новая страница</b></p><div>{{Documentation subpage}}<br />
{{Lua|Module:Excerpt}}<br />
Шаблон позволяет использовать части одних страниц на других страницах. Преимуществами такого действия являются:<br />
<br />
* '''Снижение расходов на обслуживание''': предотвращается дублирование содержимого, которое необходимо обновлять несколько раз на разных страницах<br />
* '''Улучшение качества содержимого''': редакторы объединяют связанное содержимое вместо создания нескольких версий разной степени качества<br />
* '''Способствование сотрудничеству''': редакторы работают в одном месте, что позволяет избежать параллельной работы над одним содержимым в разных местах<br />
<br />
Такая практика также имеет недостатки:<br />
<br />
* Чтобы отредактировать содержимое подстатьи, показываемое шаблоном в основной статье, редактору нужно перейти с основной статьи на подстатью (но также можно включить кнопку [редактировать], по которой можно сразу перейти к редактированию подстатьи)<br />
* Часть одной статьи не всегда идеально вписывается в другую статью (но смотрите [[#Уточнение с использованием контроля включения]])<br />
* Изменения подстатьи не показываются в списке наблюдения, если в список наблюдения добавлена только основная статья (смотрите [[phab:T55525]])<br />
<br />
Данный шаблон расширяет возможности {{Не переведено 5|Википедия:Включение|4=Help:Transclusion}} и {{Не переведено 5|Википедия:Включение помеченного раздела|4=Help:Labeled section transclusion}}.<br />
<br />
==Использование==<br />
<br />
===Основная информация===<br />
<br />
* <code><nowiki>{{Excerpt|Название страницы}}</nowiki></code> — [[Трансклюзия|Включает]] преамбулу ([[:en:Africa#Water|пример]])<br />
* <code><nowiki>{{Excerpt|Название страницы|Название раздела}}</nowiki></code> — Включает указанный раздел, исключая подразделы ([[:en:Eating#Mammals|пример]])<br />
<br />
===Параметры===<br />
<br />
* <code>1</code> или <code>article</code> или <code>page</code> — '''Обязательный.''' Название статьи или страницы для включения. По умолчанию будет включена преамбула ([[:en:Africa#Water|пример]]). Если страница содержит карточку, изображение и надпись карточку будут включены (если не будет установлен <code>files=0</code>). Шаблоны, указанные в [[Модуль:Excerpt/config]] не будут включены (если не будут запрошены с помощью {{para|templates}}, смотрите ниже).<br />
* <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> на странице включения. Обратите внимание, что шаблон позволяет использовать другие средства для указания отдельных фрагментов без необходимости использования меток разделов.<br />
* <code>only</code> — Элементы для включения. По умолчанию все элементы будут включены (кроме шаблонов, исключенных в [[Модуль:Excerpt/config]])<br />
** <code>only=file</code> — Включить только первый файл<br />
** <code>only=files</code> — Включить только файлы<br />
** <code>only=list</code> — Включить только первый список<br />
** <code>only=lists</code> — Включить только списки<br />
** <code>only=table</code> — Включить только первую таблицу<br />
** <code>only=tables</code> — Включить только таблицы ([[:en:JKT48#Singles|пример]])<br />
** <code>only=template</code> — Включить только первый шаблон<br />
** <code>only=templates</code> — Включить только шаблоны<br />
** <code>only=paragraph</code> — Включить только первый параграф<br />
** <code>only=paragraphs</code> — Включить только параграфы<br />
* <code>paragraphs</code> — Параграфы для включения. По умолчанию все параграфы включены.<br />
** <code>paragraphs=0</code> — Не включать параграфы<br />
** <code>paragraphs=1</code> — Включить первый параграф<br />
** <code>paragraphs=2</code> — Включить второй параграф<br />
** <code>paragraphs=1,3</code> — Включить первый и третий параграфы<br />
** <code>paragraphs=1-3</code> — Включить первый, второй и третий параграфы<br />
** <code>paragraphs=1-3,5</code> — Включить первый, второй, третий и пятый параграфы<br />
** <code>paragraphs=-1</code> — Включить все параграфы, кроме первого<br />
** <code>paragraphs=-2</code> — Включить все параграфы, кроме второго<br />
** <code>paragraphs=-1,3</code> — Включить все параграфы, кроме первого и третьего<br />
** <code>paragraphs=-1-3</code> — Включить все параграфы, кроме первого, второго и третьего<br />
** <code>paragraphs=-1-3,5</code> — Включить все параграфы, кроме первого, второго, третьего и пятого<br />
* <code>lists</code> — Списки для включения. По умолчанию все списки включены. Синтакс такой же, как и при включении параграфов.<br />
* <code>files</code> — Файлы для включения. По умолчанию все файлы включены. Синтакс такой же, как и при включении параграфов, но также:<br />
** <code>files=A.jpg</code> — Включить файл под названием 'A.jpg'<br />
** <code>files=A.jpg, B.png, C.gif</code> — Включить файлы под названиями 'A.jpg', 'B.png' и 'C.gif'<br />
** <code>files=.+%.png</code> — Включить все PNG файлы<br />
** <code>files=-A.jpg</code> — Включить все файлы, кроме файла под названием 'A.jpg'<br />
** <code>files=-A.jpg, B.png, C.gif</code> — Включить все файлы, кроме файлов под названиями 'A.jpg', 'B.png' и 'C.gif'<br />
** <code>files=-.+%.png</code> — Включить все файлы, кроме файлов PNG<br />
* <code>tables</code> — Таблицы для включения. По умолчанию все таблицы включены. Синтакс такой же, как и при включении параграфов, но также:<br />
** <code>tables=Stats2020</code> — Включить таблицу с идентификатором 'Stats2020'<br />
** <code>tables=Stats2020, Stats2019, Stats2018</code> — Включить все таблицы с идентификаторами 'Stats2020', 'Stats2019' и 'Stats2018'<br />
** <code>tables=-Stats2020</code> — Включить все таблицы, кроме таблицы с идентификатором 'Stats2020'<br />
** <code>tables=-Stats2020, Stats2019, Stats2018</code> — Включить все таблицы, кроме таблиц с идентификаторами 'Stats2020', 'Stats2019' и 'Stats2018'<br />
* <code>templates</code> — Шаблоны для включения. По умолчанию все шаблоны будут включены, кроме добавленных в чёрный список на [[Модуль:Excerpt/config]]. Использование дефиса перед списком шаблонов, разделённых запятыми, добавляет эти шаблоны в чёрный список.<br />
** <code>templates=-Морские течения</code> — Добавить шаблон 'Морские течения' в чёрный список<br />
** <code>templates=-Морские течения, Nature</code> — Добавить шаблоны 'Морские течения' и 'Nature' в чёрный список<br />
** <code>templates=Персона</code> — Игнорировать чёрный список и включить шаблон 'Персона'<br />
** <code>templates=Персона, Морские течения</code> — Игнорировать чёрный список и включить шаблоны 'Персона' и 'Морские течения'<br />
** <code>templates=.*</code> — Игнорировать чёрный список и включить все шаблоны<br />
* <code>this</code> — Изменить изначальный текст {{Не переведено 5|Заголовочная пометка|заголовочной пометки|4=Hatnote}}. Например, если включенное содержимое является галереей, вы можете набрать <code>this=Эта галерея является</code>, после чего заголовочная пометка будет выглядеть так: "Эта галерея является выдержкой из..." ([[:en:Eastern Distributor#Toll prices|пример]]).<br />
* <code>displaytitle</code> — Изменить текст ссылки в заголовочной пометке. Например, [[:en:WP:ITHAT|добавление курсива]], индексов и т.д.<br />
* <code>hat=no</code> — Спрятать заголовочную пометку "Этот раздел является выдержкой из..."<br />
* <code>bold=yes</code> — Сохранить '''полужирный''' текст.<br />
* <code>links=no</code> — Убрать все викиссылки.<br />
* <code>quote=yes</code> — Обернуть выдержку с помощью меток <code><nowiki><blockquote></nowiki></code>.<br />
* <code>inline=yes</code> — Убрать заголовочную пометку и метки <code><nowiki><div></nowiki></code> вокруг выдержки для использования внутри другого текста.<br />
* <code>onlyfreefiles=no</code> — Позволяет включать несвободные файлы.<br />
* <code>briefdates=yes</code> — Перевести информацию о рождении и смерти в формат (YYYY-YYYY)<br />
* <code>references=no</code> — Убрать все сноски (источники).<br />
* <code>subsections=yes</code> — Включить подразделы включаемого раздела. Обратите внимание, что если включается раздел 3 уровня и подразделы также 3 уровня, то включенные подразделы будут отображаться с той же иерархией, что и включаемый раздел, что, скорее всего, является нежелательным, поэтому используйте с осторожностью.<br />
<br />
=== Замена Шаблон:Основная статья ===<br />
<br />
[[File:How to excerpt.webm|thumb|Как заменить раздел на выдержку.]]<br />
<br />
Разделы часто являются краткими изложениями более узкоспециализированных подстраниц (обычно на них ссылаются с помощью [[Шаблон:Основная статья]]). Иногда бывает удобно заменить содержимое таких разделов выдержками из подстраниц (после объединения ценного содержимого раздела с подстраницей). В таких случаях эффективным является:<br />
<br />
# Открыть раздел в одной вкладке и подстраницу в другой.<br />
# Начать править обе страницы (нажать кнопку Править).<br />
# Скопировать текст раздела и вставить его под преамбулой подстраницы.<br />
# Удалить повторяющееся содержимое и поправить текст, исходя из здравого смысла.<br />
# Сохранить изменения подстраницы, указав в описании правки что-то вроде: "Перенос содержимого из <nowiki>[[Страница]]</nowiki>".<br />
# Назад к разделу, удалить всё содержимое раздела и заменить его выдержкой из подстраницы.<br />
# Сохранить изменения раздела, указав в описании правки что-то вроде: "Перенос содержимого в <nowiki>[[Подстраница]]</nowiki>", и оставить выдержку.<br />
<br />
===Уточнение с использованием контроля включения===<br />
<br />
{{Further|Википедия:Механизм шаблонов#Теги noinclude, includeonly, onlyinclude}}<br />
<br />
Иногда текст не полностью подходит для включения. В этих случаях вы можете изменить страницу-источник, добавив теги <code><nowiki><noinclude>...</noinclude></nowiki></code> вокруг содержимого, которое вам не нужно в выдержке, и теги <code><nowiki><includeonly>...</includeonly></nowiki></code> вокруг содержимого, которое вы хотите видеть в выдержке.<br />
<br />
Например, страница [[Конспирологические теории о пандемии COVID-19]] начинается с {{Хорошо|Конспирологические теории о [[Пандемия COVID-19|пандемии COVID-19]] и дезинформация ...}} Однако, при включении преамбулы в раздел о конспирологических теориях страницы [[Пандемия COVID-19]], нам не нужно уточнять о какой пандемии идёт речь. Поэтому, код <code><nowiki>Конспирологические теории о <noinclude>[[Пандемия COVID-19|пандемии COVID-19]]</noinclude><includeonly>пандемии</includeonly> и дезинформация</nowiki></code> может быть использован на странице о конспирологических теориях, а на странице о пандемии он будет показан как {{Хорошо|Конспирологические теории о пандемии и дезинформация ...}}.<br />
<br />
Хорошая идея для страницы, которую часто правят ― оставить невидимый комментарий, объясняющий, почему были установлены теги, чтобы ни у кого не было [[:en:WP:FENCE|соблазна]] удалить их.<br />
<br />
Пожалуйста, учтите, что когда тег <code><nowiki></noinclude></nowiki></code> обёрнут на новую строку, следующий за ним символ будет интерпретирован как начало строки. Это может создать проблемы форматирования. Например, когда после <code><nowiki></noinclude></nowiki></code> в начале строки находится {{Не переведено 5|Пробел (программирование)|пробел|4=Whitespace character}}, движок страницы воспримет это как начальный пробел, который отображает следующий параграф в [[Блок (программирование)|блоке кода]] и [[моноширинный шрифт]] с сохранённым форматированием. По этой причине никакие пробелы не должны отделять тег <code><nowiki></noinclude></nowiki></code> от предшествующего ему текста.<br />
<br />
==См. также==<br />
<br />
* [[Модуль:Excerpt]]<br />
* [[Модуль:Excerpt/config]]<br />
* [[Модуль:Transcluder]]<br />
<br />
==Template data==<br />
<br />
{{TemplateData заголовок}}<br />
<templatedata><br />
{<br />
"params": {<br />
"1": {<br />
"aliases": [<br />
"article",<br />
"page"<br />
],<br />
"label": "Статья",<br />
"description": "Название статьи или страницы для включения",<br />
"example": "Наука",<br />
"type": "wiki-page-name",<br />
"required": true<br />
},<br />
"2": {<br />
"aliases": [<br />
"section",<br />
"fragment"<br />
],<br />
"label": "Раздел",<br />
"description": "Название раздела или тега <section> для включения",<br />
"example": "История",<br />
"type": "string"<br />
},<br />
"paragraphs": {<br />
"label": "Параграфы",<br />
"description": "Параграфы для включения",<br />
"example": "1-3,5",<br />
"type": "string",<br />
"aliases": [<br />
"paragraph"<br />
]<br />
},<br />
"files": {<br />
"label": "Файлы",<br />
"description": "Файлы для включения",<br />
"example": "1-3,5",<br />
"type": "string",<br />
"default": "1",<br />
"aliases": [<br />
"file"<br />
]<br />
},<br />
"subsections": {<br />
"label": "Подразделы",<br />
"description": "Включать ли подразделы включаемого раздела",<br />
"example": "да",<br />
"type": "boolean"<br />
},<br />
"tables": {<br />
"label": "Таблицы",<br />
"description": "Таблицы для включения",<br />
"example": "Stats2020",<br />
"type": "string",<br />
"aliases": [<br />
"table"<br />
]<br />
},<br />
"references": {<br />
"label": "Сноски",<br />
"description": "Включать ли сноски",<br />
"example": "нет",<br />
"type": "boolean"<br />
},<br />
"only": {<br />
"label": "Только",<br />
"description": "Включить только этот тип элемента",<br />
"example": "table",<br />
"type": "string"<br />
},<br />
"this": {<br />
"label": "Это",<br />
"description": "Изменить изначальный текст заголовочной пометки",<br />
"example": "Эта галерея является",<br />
"type": "string"<br />
},<br />
"displaytitle": {<br />
"label": "Показываемое название",<br />
"description": "Изменить текст ссылки в заголовочной пометке",<br />
"type": "string"<br />
},<br />
"class": {<br />
"label": "Класс",<br />
"description": "Дополнительный CSS класс",<br />
"example": "noprint",<br />
"type": "string"<br />
},<br />
"hat": {<br />
"label": "Заголовочная пометка",<br />
"description": "Включать ли заголовную пометку",<br />
"example": "нет",<br />
"type": "boolean",<br />
"default": "да"<br />
},<br />
"bold": {<br />
"label": "Полужирный",<br />
"description": "Сохранять ли полужирное форматирование текста",<br />
"example": "нет",<br />
"type": "boolean",<br />
"default": "да"<br />
},<br />
"links": {<br />
"label": "Викиссылки",<br />
"description": "Сохранять ли викиссылки",<br />
"example": "нет",<br />
"type": "boolean",<br />
"default": "да"<br />
},<br />
"quote": {<br />
"label": "Цитата",<br />
"description": "Оборачивает выдержку в теги <blockquote>",<br />
"example": "да",<br />
"type": "boolean",<br />
"default": "нет"<br />
},<br />
"inline": {<br />
"label": "Внутристрочное",<br />
"description": "Убрать заголовочную пометку и теги <div> вокруг выдержки для использования внутри другого текста",<br />
"example": "да",<br />
"type": "boolean",<br />
"default": "нет"<br />
},<br />
"lists": {<br />
"aliases": [<br />
"list"<br />
],<br />
"label": "Списки",<br />
"description": "Списки для включения",<br />
"example": "1",<br />
"type": "string"<br />
},<br />
"templates": {<br />
"aliases": [<br />
"template"<br />
],<br />
"label": "Шаблоны",<br />
"description": "Шаблоны для включения",<br />
"example": "Персона",<br />
"type": "string"<br />
},<br />
"onlyfreefiles": {<br />
"label": "Только свободные файлы",<br />
"description": "Включить несвободные файлы",<br />
"example": "да",<br />
"type": "boolean",<br />
"default": "нет"<br />
},<br />
"briefdates": {<br />
"label": "Короткие даты",<br />
"description": "Превращает информацию о рождении и смерти в формат (YYYY-YYYY)",<br />
"example": "да",<br />
"type": "boolean",<br />
"default": "нет"<br />
}<br />
},<br />
"description": "Данный шаблон используется для включения части одной страницы в другую страницу.",<br />
"paramOrder": [<br />
"1",<br />
"2",<br />
"only",<br />
"paragraphs",<br />
"files",<br />
"tables",<br />
"lists",<br />
"templates",<br />
"references",<br />
"subsections",<br />
"hat",<br />
"bold",<br />
"links",<br />
"quote",<br />
"this",<br />
"displaytitle",<br />
"inline",<br />
"onlyfreefiles",<br />
"briefdates",<br />
"class"<br />
]<br />
}<br />
</templatedata><br />
<br />
<includeonly><br />
<!-- Категории добавлять сюда, а интервики в Викиданные --><br />
[[Категория:Шаблоны:Разделы статьи]]<br />
</includeonly></div>ru>RenatUK