Шаблон:Excerpt

Версия от 18:34, 21 июня 2023; Admin (обсуждение | вклад) (1 версия импортирована)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Документация

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

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

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

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

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

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

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

  • {{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 — Изменить изначальный текст заголовочной пометки[en]. Например, если включенное содержимое является галереей, вы можете набрать 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
Как заменить раздел на выдержку.

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

  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> в начале строки находится пробел[en], движок страницы воспримет это как начальный пробел, который отображает следующий параграф в блоке кода и моноширинный шрифт с сохранённым форматированием. По этой причине никакие пробелы не должны отделять тег </noinclude> от предшествующего ему текста.

См. также

Template data

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

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

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

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

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