В этом шаблоне используются TemplateStyles: |
Шаблон {{term}}
используется в структурированных шаблонами глоссариях для создания терминов, которые должны быть определены, которые должным образом структурированы, имеют семантическое значение и могут быть связаны с как бы независимыми разделами. Это оболочка для <dt>...</dt>
, элемента HTML термина списка описаний . Шаблон имеет мнемоническое перенаправление на .{{dt}}
Основное использование:
{{ глоссарий }} {{термин|1= термин }} {{ определение }} {{ конец глоссария }}
Встроенные шаблоны, ссылки на ссылки, стили вики-разметки и т. д. могут применяться к термину во втором параметре ( |content=
или |2=
), пока он остается без разметки в первом параметре ( |term=
или |1=
). Технически явные имена параметров необязательны, если термин или содержимое не содержит символ "=", но поскольку любой редактор может добавлять материал, включая шаблоны или URL-адреса с этим символом, всегда безопаснее явно называть или нумеровать параметры .
{{term|term=E=MC²}}
{{term|1=E=MC²}}
{{term|E=MC²}}
Более сложное использование обычно выглядит так:
{{term|term=term with no markup |content=term with markup}}
или
{{term|1=term with no markup |2=term with markup}}
или
{{term|1=term with no markup |content=term with markup}}
Если второй |content=
параметр или стилизован с помощью вики-разметки, связан или иным образом изменен внутри шаблона, термин также должен быть сохранен в нестилизованной форме как первый |term=
параметр или . Невыполнение этого требования приведет к сбою шаблона, поскольку он должен иметь «чистое» имя термина для использования в качестве id
элемента, для целей связывания и других целей. Порядок намеренно отражает порядок конвейерного вики-связывания ( ).[[title|styled]]
{{term|1=esprit de corps|2=''esprit de corps''}}
{{term|1=''esprit de corps''}}
Стиль также нельзя применять к шаблону, поскольку он является контейнером для контента (термина), а не самим контентом (и это приведет к созданию недопустимой разметки, которая будет иметь непредсказуемые результаты в зависимости от браузера):
''
{{term|1=esprit de corps}}
''
По тем же причинам, по которым ссылки на другие страницы не приветствуются в заголовках, не приветствуются ссылки в терминах глоссария :
{{term|1=esprit de corps|2=''[[esprit de corps]]''}}
{{term|1=esprit de corps|2=''esprit de corps''}}
{{ghat}}
{{defn}}
Опять же, как и в случае с первым параметром (термином), если =
в содержимом этого второго параметра используется символ « » (знак равенства), синтаксис требует , чтобы параметр был указан явно (и поскольку многие URL-адреса, например, в ссылках, могут содержать этот символ, всегда безопаснее нумеровать или называть параметры):
пронумеровано:
{{term|1=E=MC²|2=E=MC<sup>2</sup>}}
или по имени:
{{term|term=E=MC²|content=E=MC<sup>2</sup>}}
{{term}}
автоматически создает точку привязки ссылки (HTML id
) из преобразования исходного термина ( или ) или в строчные буквы . Около 90% ссылок на записи глоссария будут находиться в середине предложения и, таким образом, будут начинаться со строчной буквы, за исключением имен собственных. Шаблон (и его производные, такие как ) автоматически преобразует в строчные буквы любой ввод, который им дается в качестве цели ссылки для вас. Таким образом, единственная загвоздка в том, что если вы вручную создаете ссылку, например , и не преобразуете часть в строчные буквы . Таким образом, вам следует использовать .|term=
|1=
|id=
{{glossary link}}
{{cuegloss}}
[[Glossary of American political jargon#Democratic Party|Democratic Party]]
#Democratic Party
{{glossary link}}
Если в вашем глоссарии есть необычный случай, в котором одна запись и другая имеют одно и то же имя, за исключением регистра (таким образом, будет получен тот же HTML в нижнем регистре id
), то заглавной записи должно быть присвоено уникальное |id=
значение, и не должно быть конфликта с HTML в нижнем регистре id
. Это можно сделать, изменив его |id=
на вариант (например, с номером), а затем вручную внедрив второй HTMLидентификатор(с заглавными буквами) с использованием |content=
параметра и шаблона якоря:
{{термин|термин=foo}} {{defn|Определение строчной версии здесь ... {{term|term=Foo |id=Foo_2 |content={{vanchor|Foo}} }} {{defn|Определение версии имени собственного здесь ...
Затем вы можете ссылаться на них как #foo
на и #Foo
, соответственно. (Технически ко второму можно также обратиться как на #foo_2
, что будет преобразовано в нижний регистр кодом шаблона, но это будет не очень интуитивно понятно и является просто артефактом обходного пути.)
Шаблон также можно использовать в параметре aka , например, для указания множественного числа термина (наиболее распространенное использование), альтернативного написания, старого названия записи, на которую была ссылка, но которая с тех пор изменилась, или имени якоря ссылки быстрого доступа.{{anchor}}
|content=
|2=
Как и в случае со стилизованными терминами, первый параметр должен использоваться для предоставления "голого" термина, второй — для предоставления этой дополнительной разметки. Не обязательно добавлять сам термин в {{anchor}}
шаблон при использовании {{term}}
:
{{term|1=shortstop |content=shortstop{{anchor|shortstops|short-stop|short stop}}
}}
Напротив, при использовании терминов, разделенных точкой с запятой, в неструктурированных глоссариях термин необходимо явно добавлять в качестве якоря, если требуется привязка ссылки (что почти всегда так):
;shortstop
{{anchor|shortstop
|shortstops|short-stop|short stop}}
или использовать{{vanchor}}
;
{{vanchor|shortstop
|shortstops|short-stop|short stop}}
(Строго говоря, этот факт не имеет никакого отношения к данному шаблону, но может быть полезен редакторам, которые переходят из одного стиля глоссария в другой.)
Для синонимов с общим определением можно использовать два или более слова {{terms}}
, однако следует помнить, что люди, которые ищут один из них и не находят его там, где они ожидают, что он будет упорядочен по алфавиту, могут предположить, что он отсутствует, если вы не создадите запись перекрестной ссылки.Параметр |multi=y
используется для второго и последующих терминов, чтобы визуально сгруппировать термины близко друг к другу, чтобы было ясно, что они имеют общее определение:
|multi=y
устарело . При использовании TemplateStyles последовательные {{term}}
s будут автоматически визуально группироваться близко друг к другу. Это помогает шаблонам глоссария {{term}}
и {{defn}}
более точно придерживаться семантики HTML <dt>
и <dd>
тегов.
Следующий пример демонстрирует, что использование |multi=y
параметра больше не оказывает никакого влияния на визуализируемый вывод (поскольку теперь это поведение по умолчанию):
{{термин|1=аспирин}}{{defn|1=Мягкий анальгетик из семейства нестероидных противовоспалительных препаратов (НПВП)...}}{{term|1=героин}} { {term|1=диацетилморфин |multi=y}} {{term|1=диаморфин |multi=y}}{{defn|1=Синтетический наркотический препарат семейства опиатов...}}{{термин|1=ранитидин}}{{defn|1=Антацид из семейства ингибиторов протонной помпы...}}
Результат: | против нет|multi=y |
---|---|
|
|
Чтобы указать язык неанглоязычного термина, используйте шаблон и коды языков ISO 639, указанные в этом шаблоне:{{lang}}
{{term|1=esprit de corps |content={{lang|fr|esprit de corps}}}}
Для большинства языков визуальных изменений не наблюдается:
Для всех языков, отличных от английского, это обеспечивает множество функций метаданных, но это необходимо для тех языков, которые не используют латинский алфавит, чтобы контент правильно отображался в различных браузерах.
Если необходимо указать название языка, для большинства языков существуют отдельные шаблоны с названиями на основе кодов ISO , которые автоматически выделяют курсивом иностранный контент:
{{term|1=esprit de corps |content={{langx|fr|esprit de corps}}}}
что отображается как:
Как подробно описано выше, два или более терминов, как вариации или альтернативы, могут иметь общие определения. Наиболее распространенный вариант использования этого — представление термина в двух вариантах английского языка. Пример:
{{term|1=tyre|content= {{langx|en-GB|tyre}} }}{{term|1=tire|content= {{langx|en-US|tire}} }}{{defn|1=Эластичное покрытие колеса, обычно изготавливаемое из вулканизированной резины.}}
Результат:
В другом формате, более подходящем для алфавитных глоссариев:
{{term|1=tire|content= {{lang|en-US|tire}} {{small|([[Американский английский]])}} } }{{term|1=tyre|content= {{lang|en-GB|tyre}} {{small|([[британский английский]])}} } }{{defn|1=Эластичное покрытие колеса, обычно изготавливаемое из вулканизированной резины.}}
Результат:
В этом примере в качестве первого параметра используется шаблон с языковыми кодами, а не сами шаблоны.{{Lang}}
{{lang-xx}}
Шаблон {{Term}}
не имеетотдельный параметр (и не должен быть таковым – слишком много подводных камней).|lang=
Параметр |style=
передаст CSS-стиль элементу <dt>
, например |style=font-family:serif;
. То есть, это стилизует сам термин, а не его определения, другие записи терминов или глоссарий в целом. Эта функция нечасто, но иногда очень нужна в статьях (обычно для форматирования внешнего вида определенной записи по какой-то причине, например, определенные математические константы и тому подобное, которые всегда даются шрифтом с засечками). Она также может быть полезна вне статей, для таких вещей, как соответствие пользовательскому стилю projectpage или userpage.
Большинство ограничений на содержимое
id
были сняты, поэтомуid
значения больше не должны начинаться с[a-z][A-Z]
буквенного символа, избегать большинства знаков препинания или страдать от других подобных ограничений. Движок MediaWiki Википедии достаточно умен, чтобы автоматически экранировать любые проблемные символы на лету.
|id=
может использоваться для назначения термину имени идентификатора из одного слова с учетом регистра. Он должен быть уникальным на странице. Его можно использовать в качестве еще одной цели #link и использовать другие метаданные. По умолчанию параметр |term=
aka |1=
уже установлен в качестве идентификатора, и его редко следует переопределять, если только на одной странице нет двух одинаковых терминов, создающих конфликтующие идентификаторы. Обычно шаблон используется для добавления дополнительных целей ссылок к записи . Обратите внимание, что предоставление пустого значения (например, с помощью HTML ) приведет к отправке пустого параметра в тег, что является недопустимым HTML.{{anchor}}
id
<!--comments-->
id
Параметр |noid=
, если задан как true/ / , полностью подавит генерацию поля . Обычно это нежелательно, за исключением случая, когда якорь сгенерированного является другим, определенным в статье.yyesid
|text=
|term=
{{Term}}
Параметр |class=
передаст один или несколько разделенных пробелами классов CSS в <dt>
элемент. Редко когда есть причины делать это, особенно в mainspace.
Примечание: при использовании TemplateStyles во вложении {{glossary}}
(что генерирует HTML- <dl class="glossary">
тег) этот шаблон больше не включает glossary
класс по умолчанию.
Здесь показан как очень простой, так и довольно сложный пример:
Разметка |
|
---|---|
Отображается как | ЯВЛЯЮСЬ
|
Изображения, примечания и другой "дополнительный" контент, предназначенный для непосредственного следования за , {{term}}
должен использоваться в верхней части (внутри) первого {{defn}}
из {{term}}
. Их нельзя размещать между {{term}}
и {{defn}}
, иначе это нарушит разметку глоссария. Изображения, конечно, можно размещать в другом месте внутри {{defn}}
, а примечания снизу, такие как {{ more }}, можно размещать в конце, но внутри , a {{defn}}
. При использовании с термином с несколькими определениями определение, в котором {{ghat}}
появляется , должно быть пронумеровано вручную (обычно 1 ...
, как показано в примере ниже).
Разметка |
|
---|---|
Отображается как |
|
Что этот шаблон делает на техническом уровне, так это оборачивает термин в <dfn>...</dfn>
элемент HTML , чтобы семантически пометить термин как определяющий экземпляр на странице определенного термина, и помещает этот размеченный контент внутрь элемента <dt>...</dt>
термина<dl>...</dl>
списка описаний (он же список определений, список ассоциаций; список генерируется шаблонами и ), и дает CSS элементу . Этот класс пока ничего не делает, но может позже, например, немного увеличить размер шрифта.{{glossary}}
{{glossary end}}
class="glossary"
<dt>
Не указывайте нулевой идентификатор (например, id=<!-- no ID -->
). Пустые или нулевые параметры HTML- идентификатора приводят к недопустимому выводу HTML5.
{{glossary}}
также известный как или – Половина пары шаблонов; используется с классом для открытия списка определений структурированного глоссария, который закрывается.{{glossary start}}
{{glossary begin}}
<dl>
{{glossary end}}
{{glossary end}}
– Другая половина этой пары шаблонов; используется </dl>
для закрытия открывшегося списка определений {{glossary}}
.{{term}}
– Термин глоссария, к которому {{defn}}
применяется определение; настроенный <dt>
с классом и встроенным <dfn>
.{{defn}}
– Определение, которое применяется к {{term}}
; используется <dd>
с классом{{ghat}}
– шаблон сноски, правильно отформатированный для верхней части {{defn}}
определения{{glossary link}}
– меташаблон для создания шаблонов сочетаний клавиш для ссылок на определения в конкретных глоссариях