WikiDer > Справка: включение помеченных разделов - Википедия
Эта справочная страница является практическое руководство. В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не один из Политика или рекомендации Википедии, и может отражать разные уровни консенсус и проверка. |
Включение помеченного раздела (LST) предлагает два основных способа указать "раздел" страница за включение. В одном случае используется имя страницы и Заголовок (заголовок раздела, как видно на отображаемой странице). Другой способ позволяет включить произвольный «раздел», но сначала требуется разметка, чтобы добавить метка.
Три функции могут включать раздел из заданного имя страницы.
- {{#раздел:имя страницы|метка}} (помеченный раздел)
- {{#раздел-Икс:имя страницы|метка}} (все, кроме помеченного раздела)
- {{#раздел-час:имя страницы|Заголовок}} (нормальный раздел)
Обратите внимание, что для этих функций также есть эквивалентные имена, базовые имена #lst
, #lstx
, и #lsth
.
Чтобы подготовить произвольный «раздел» для включения помеченного раздела, отметьте его начинать и конец атрибуты внутри <section />
теги, содержащие ваши метка:
По сравнению с включением LST, частичное включение разметка не может быть маркированный, и, таким образом, исходная страница не может иметь один набор разделов, включенных на одну страницу, в то же время имея другой набор для другой страницы. Страница, размеченная только тегами частичного включения, всегда будет включать одно и то же. Но LST и частичное включение могут работать вместе на одной странице.
Эти функции LST принимают дополнительные параметры, как описано ниже. § Примеры страниц предоставляет ссылки для поиска статей, которые в настоящее время используют LST, чтобы вы могли увидеть, как они его используют.
Сводка функций
В этом разделе кратко описаны три функции синтаксического анализатора в расширении включения помеченных разделов.
Параметр | Анализирующий объект, который он идентифицирует | |
---|---|---|
1 | Fullpagename | Исходная страница. Единственный обязательный аргумент. Введите его или используйте такие переменные, как {{FULLPAGENAME}}, (но нет ссылка на подстраницу с ../). |
2 | Раздел | Этикетка («отмеченный раздел») или Заголовок (заголовок раздела), чтобы включить. Необязательный параметр. Если это метка, она должна быть сначала добавлена и сохранена. |
3 | Классифицировать | Заключительный раздел в непрерывную серию заголовков или меток, которые нужно включить. Необязательный.
|
3 | Изменять | Замена wikitext. Только #lstx может переписать помеченный раздел во время включения. Необязательный. |
Невозможно пройти параметры шаблона к включенному разделу или странице, но код страницы может использовать волшебные слова подобно {{PAGENAME}}
проверить, где это, и вести себя иначе.
Функция парсера | Псевдоним | Описание |
---|---|---|
#lst | #раздел | Включить метка найдено внутри <section /> теги. Теги включения отличия. По умолчанию вся страница. Если метка не найдена, ничего не включайте. |
#lstx | # section-x | Включить всю страницу, но исключать этикетка. Слепой к заголовкам. Теги включения отличия. По умолчанию вся страница. Если ярлык не найден, включить всю страницу. |
#lsth | # section-h | Включить Заголовок (название раздела). Слепой к этикеткам. Не соблюдать теги включения.† По умолчанию используется ведущий раздел. Если заголовок не найден, ничего не включайте. |
- † # section-h делает его цель такой же, как и ее источник. На источник страница
отображает его содержимое отображает его содержимое - <включать только> не отображать его содержание
- Так # section-h не должен оказывать
<includeonly>
содержание на цель страница.
LST <раздел />
поведение тегов:
- В конец тег не требуется. Когда только начинать тег найден, он идет в конец страницы.
- Одна и та же этикетка может обозначать несколько начало / конец разделы. Тогда ассортимент - это все, начиная с первого начинать длиться конец.
- Различные метки могут перекрываться. Они также могут гнездиться.
- Не может быть помещен путем включения, но вместо этого должен присутствовать на странице, как сохранено в базе данных. Видеть § Нет шаблона ниже.
Варианты включения LST:
- Может быть предварительный просмотр.
- Целевая страница может быть исходной страницей сам.
- Его можно заменить. Видеть § Замена ниже.
Применяется стандартный синтаксис:
- Допускаются большие пробелы: {{ #lst: пространство имен: имя страницы | раздел }}
- Без пробела: двоеточие следует за именем функции синтаксического анализатора.
- В тегах нет пробелов вокруг знака = метки (атрибута): begin =метка
- В тегах пробел перед / косой чертой необязателен: <конец раздела =метка />
Распространенные ошибки использования.
- Обнаружен цикл шаблона: превью с включением в сохраненную версию?
- Укажите ошибки. У вас должно быть полное определение именованная ссылка на любой странице, где требуется этот «ярлык с множеством цитируемых ссылок».
- Чтобы отобразить включающие сноски, вы должны отметьте, где они переходят на страницу.
Разметка
Разметка исходной страницы не требуется, если для указания включения используются только заголовки разделов. Так обстоит дело с # section-h.
Для разметки раздела для включения LST используйте следующую разметку.
Маркировка сечения
Разметьте границы раздела на исходной странице с помощью двух, единственного, <раздел />
теги; например, чтобы обозначить раздел "chapter1":
<section begin=chapter1 />
это глава<section end=chapter1 />
Обратите внимание, что это не обычный HTML-тег закрывающего и открывающего тегов. В HTML <section>...</section>
является недействительным. Этот тег парсера, <section />
, несовместима с элементом HTML, поскольку в разметке MediaWiki используется уникальный тег парсера, добавленный только для расширения «Переключение помеченных разделов».
Включение раздела
Используйте функцию парсера #раздел
чтобы включить раздел. Например, чтобы включить раздел с меткой глава 1 со страницы под названием articleX:
{{#section: ArticleX | chapter1}}
Включить страницу, но исключить раздел
Чтобы включить страницу, но исключить указанный раздел, используйте # section-x
функция парсера:
{{# section-x:fullpagename|метка}}
или же
{{# section-x:fullpagename|Заголовок}}
При желании вы можете добавить заменяющий текст в исключенный раздел.
{{# section-x:fullpagename|метка|текст замены}}
Пример:
{{# section-x: articleX | chapter1 | См. главу 1 в [[articleX]].}}
Текст замены появится в области, где раздел пропущен (исключен).
Работа с случайными пробелами
По умолчанию, #раздел
будет включать в себя все пробелы в разделе, что может привести к проблемам, если вы попытаетесь включить раздел в другую статью. Чтобы решить эту проблему, используйте тот факт, что {{#если}} функция парсера обрезает свои входные данные, например
{{#if: 1 | {{# section: ArticleX | chapter1}}}}
Это позволит избавиться от начальных и конечных пробелов, и статья будет отображаться так, как задумано. Поскольку вы размещаете шаблоны, он удвоит после развертывания включить размер отрывка, который может представлять проблему на более длинных страницах, поэтому вы можете отредактировать исходную страницу, чтобы обернуть контент, который вы хотите включить, без пробелов, в <onlyinclude>...</onlyinclude>
теги вместо этого. Вы также можете использовать {{подрезать}} шаблон вместо {{#если: 1}}, но поскольку это просто оболочка для {{#если: 1}}, это приводит к утроению размера включаемого после развертывания.
Прочие функции
Несмежные разделы
Возможно иметь несколько разделов с одним и тем же именем; в этом случае каждый раздел с таким именем будет включен / исключен. Это особенно полезно для обозначения различных обсуждений.
Диапазоны секций
Эти функции могут включать всю страницу, поэтому у них есть два необязательных аргумента для определения поведения: 1) раздел с тегами имени или заголовок-заголовок, 2) диапазон таких именованных тегов разделов или заголовков разделов и 3) замена контент для названного раздела.
{{#section: articleX | chapter1 | chapter3}}
включает в себя все от начала главы 1 до конца главы 3. Это позволяет использовать пустые пары маркеров для обозначения одного конца раздела, возможно, в шаблоне.{{# section-h: articleX | chapter1 | chapter3}}
включает содержание главы 1, заголовок и содержание главы 2.{{# section-x: articleX | chapter1 | chapter3}}
заменяет заголовок и содержание chapter1 словом «chapter3».
Замена
Вместо того, чтобы включать каждый раз, чтобы один раз "включить" (скопировать), используйте замена:
- {{subst: {{# раздел ...}}}}
Например, чтобы заархивировать старые разговаривать на своей странице обсуждения вы можете скопировать его на страницу архива, а затем удалить, используя LST:
- Положить
<section begin=archive />
в начале раздела, который вы хотите заархивировать и<section end=archive />
в конце. (Мы используем «архив» для ярлыка, но подойдет любой ярлык). Этот раздел может быть где угодно, и это может быть несколько разделов. - Сохраните эти изменения на своей странице обсуждения.
- Создайте новую страницу архива. Положить {{subst: #section: Обсуждение пользователя:имя страницы| архив}}.
- Сохраните эту страницу архива. К нему скопирован старый разговор. Включение исчезает, потому что оно было заменено.
- Снова отредактируйте страницу обсуждения. Заменить весь викитекст на всей странице на {{subst: # section-x: Обсуждение пользователя:имя пользователя| архив}}. В страница базы данных будут включены, за вычетом того же самого вики-текста в сохраненном архиве и за вычетом тегов разделов (которые мы обозначили как «архив»).
При использовании замены для включения содержимого в Википедии используйте сводку редактирования, чтобы применить права и обязанности повторных пользователей. Это относится к любому существенному контенту, а не только к содержанию статьи.
Нет шаблона
В настоящее время ни один шаблон не может облегчить эту разметку LST, потому что необходимо использовать тег #tag, чтобы "preSaveTransform" волшебные слова внутри тега любого вида. Для правильной попытки см. (Нефункционирующий) {{раздел}}.
Единственный способ оценивать аргументы шаблона внутри тега (из-за порядка разбора) #тег. LST потребуется (шаблон) оценка метки при создании тега раздела: {{#tag: section | {{{1}}}}}
.
Но # тег производит только XML-подобные (сбалансированные, открытые-закрытые, начало-конец, пары) теги, тогда как LST будет использовать единственный, явно самозакрывающийся тег. Таким образом, теги LST не могут быть созданы ни одним шаблоном. Сравните фактический (только действующий) вывод:
{{#tag: section |содержание| begin =метка}} → <начало раздела =метка> содержание </раздел>
с запрошенным выводом:
<начало раздела =метка /> содержание <конец раздела =метка />
Примеры страниц
Это поиски хранится в ссылке:
- insource: "section h" insource: / # "section-h" / (Статьи)
- insource: section insource: / { { # section / (Статьи)
- all: insource: "section x" insource: / # "section-x" / (вся вики)
- insource: lst insource: / # lst / (Статьи)
- insource: lsth insource: / { { # lsth / (Статьи)
- все: insource: lstx insource: / # lstx / (вся вики)