Шаблон:Excerpt/doc

Ошибка Lua в Модуль:Lua_banner на строке 113: attempt to index field 'edit' (a nil value). Шаблон позволяет использовать части одних страниц на других страницах. Преимуществами такого действия являются:

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

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

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

Данный шаблон расширяет возможности Ошибка Lua в Модуль:Не_переведено на строке 243: attempt to call local 'prepositional' (a nil value). и Ошибка Lua в Модуль:Не_переведено на строке 243: attempt to call local 'prepositional' (a nil value)..

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

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

{{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 — Изменить изначальный текст Ошибка Lua в Модуль:Не_переведено на строке 243: attempt to call local 'prepositional' (a nil value).. Например, если включенное содержимое является галереей, вы можете набрать 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 уровня, то включенные подразделы будут отображаться с той же иерархией, что и включаемый раздел, что, скорее всего, является нежелательным, поэтому используйте с осторожностью.

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

Файл:How to excerpt.webm

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

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

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

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

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

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

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

Пожалуйста, учтите, что когда тег </noinclude> обёрнут на новую строку, следующий за ним символ будет интерпретирован как начало строки. Это может создать проблемы форматирования. Например, когда после </noinclude> в начале строки находится Ошибка Lua в Модуль:Не_переведено на строке 243: attempt to call local 'prepositional' (a nil value)., движок страницы воспримет это как начальный пробел, который отображает следующий параграф в блоке кода и моноширинный шрифт с сохранённым форматированием. По этой причине никакие пробелы не должны отделять тег </noinclude> от предшествующего ему текста.

См. также

Template data

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

Документация TemplateData для шаблона: Excerpt/doc

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

Параметры шаблона[Править данные шаблона]
Параметр		Описание	Тип	Статус
Статья	`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	Строковый (без форматирования)	необязательный