Применение
Шаблон используется в глоссариях с шаблонной структурой для создания терминов, подлежащих определению, которые должным образом структурированы, имеют семантическую ценность и могут быть связаны с независимыми разделами. Это обертка для , то список описаний термина HTML элемент . В шаблоне есть мнемоническое перенаправление на .{{term}}
{{dt}}
Основное использование:
{{ глоссарий }} {{термин | 1 = термин }} {{ defn }} {{ конец глоссария }}
Встроенные шаблоны, ссылки, стили вики-разметки и т. Д. Могут применяться к термину во втором параметре ( |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}}
Wiki-стилизация и связывание термина
Если для второго |content=
параметра или параметра используется стиль вики-разметки, он связан или иным образом изменен внутри шаблона, термин также должен быть сохранен в нестилизованной форме в качестве первого |term=
параметра или . Невыполнение этого требования приведет к сбою в работе шаблона, поскольку он должен иметь "чистое" имя термина для использования в id
качестве элемента, среди прочего, для целей связывания. Порядок намеренно отражает порядок передачи wikilinking ( ) по конвейеру .[[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]]''}}
- Предпочтительно :, и использование сноски в определении для ссылки на основную статью Esprit de corps .
{{term|1=esprit de corps|2=''esprit de corps''}}
{{ghat}}
{{defn}}
Опять же, как и в случае с первым параметром (термином), если =
в содержании этого второго параметра используется символ « » (знак равенства), синтаксис требует , чтобы параметр был явно указан (и поскольку многие URL-адреса, например, в ссылке цитаты, могут содержать этот символ, всегда безопаснее всего пронумеровать или назвать параметры):
пронумерованы:
{{term|1=E=MC²|2=E=MC2}}
или по имени:
{{term|term=E=MC²|content=E=MC2}}
Ссылка на термин
{{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=
параметра и шаблона привязки:
{{term | term = 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|sslink}}
}}
В противоположность этому , при использовании разделенных точкой с запятой терминов в неструктурированных глоссарии, термин делает потребность быть добавлен в явном виде в качестве якоря , если ссылка анкеровки желательно (что почти всегда бывает):
;shortstop
{{anchor|shortstop
|shortstops|short-stop|short stop|sslink}}
или используйте {{vanchor}}
;
{{vanchor|shortstop
|shortstops|short-stop|short stop|sslink}}
(Строго говоря, этот факт не имеет ничего общего с этим шаблоном, но может быть полезен редакторам, которые переходят от одного стиля глоссария к другому.)
Несколько терминов, разделяющих определение
Два или более {{terms}}
могут использоваться для синонимов с общим определением, хотя имейте в виду, что люди, которые ищут один и не находят его там, где они ожидают, что он будет расположен в алфавитном порядке, могут предположить, что он отсутствует, если вы не создадите запись с перекрестной ссылкой . Параметр |multi=y
используется во втором и последующих терминах, чтобы визуально сгруппировать термины близко друг к другу, чтобы было ясно, что они имеют общее определение:
Пример:
{{срок | 1 = аспирин}}{{defn | 1 = Мягкий анальгетик из семейства нестероидных противовоспалительных средств (НПВП) ...}}{{term | 1 = героин}} {{term | 1 = диацетилморфин | multi = y}} {{term | 1 = diamorpine | 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={{lang-fr|esprit de corps}}s}}
который отображается как:
- Когда два или более языковых варианта термина имеют одно и то же определение:
Как подробно описано выше, два или более терминов, как вариации или альтернативы, могут иметь общие определения. Наиболее распространенный вариант использования - представление термина в двух вариантах английского языка. Пример:
{{термин | 1 = шина | content = {{lang-en-GB | шина}} }}{{срок | 1 = шина | content = {{lang-en-US | шина}} | multi = y }}{{defn | 1 = Эластичное покрытие колеса, обычно изготавливаемое из вулканизированной резины.}}
Обратите внимание на использование |multi=y
во втором члене; это группирует два термина вместе.
Результат:
- Британский английский : шина
- Американский английский : шина
- Упругое покрытие колеса, обычно из вулканизированной резины.
В другом формате, более подходящем для алфавитных глоссариев:
{{срок | 1 = шина | content = {{lang | en-GB | tyre}} {{small | ([[британский английский]])}} }}{{термин | 1 = шина | content = {{lang | en-US | tyre}} {{small | ([[американский английский]])}} | multi = y}}{{defn | 1 = Эластичное покрытие колеса, обычно изготавливаемое из вулканизированной резины.}}
Результат:
- шина ( британский английский )
- шина ( американский английский )
- Упругое покрытие колеса, обычно из вулканизированной резины.
В этом примере в качестве первого параметра используется шаблон с кодами языков, а не шаблоны.{{Lang}}
{{lang-xx}}
В шаблоне нет{{Term}}
параметр сам по себе (и не должен - здесь слишком много подводных камней). |lang=
Применение стилей CSS к термину
|style=
Параметр будет проходить CSS стиль на к элементу, например
|style=font-family:serif;
. Т.е. это стилизует сам термин, а не его определения, другие термины или глоссарий в целом. Эта функция редко, но иногда важна в статьях (обычно для форматирования внешнего вида определенной записи по какой-либо причине, например, определенные математические константы и тому подобное, которые всегда указываются шрифтом с засечками). Это также может быть полезно вне статей, например, для сопоставления пользовательской страницы проекта или стиля страницы пользователя.
Прочие параметры
id
было снято, поэтому id
значения больше не должны начинаться с [a-z][A-Z]
буквенного символа, избегать большинства знаков препинания или иметь другие подобные ограничения. Механизм MediaWiki Википедии достаточно умен, чтобы на лету автоматически избегать любых проблемных символов. |id=
Параметр может быть использован для назначения одного слова, чувствительных к регистру имени идентификатора термину. Он должен быть уникальным на странице. Его можно использовать как другую цель #link, а также использовать другие метаданные. По умолчанию параметр |term=
aka |1=
уже установлен в качестве идентификатора, и его следует редко переопределять, если на одной странице нет двух одинаковых терминов, создающих конфликтующие идентификаторы. Обычно шаблон используется для добавления дополнительных целей ссылки к записи . {{anchor}}
|class=
Параметр будет проходить один или несколько разделенных пробелами классов CSS на к элементу, в дополнение к автоматически включены класса
glossary
. Для этого редко есть какие-либо причины, особенно в mainspace.
Примеры
Это показывает как очень простой, так и довольно сложный пример:
== A – M == |
|
Изображения, сноски и другой контент
Изображения, заголовки и другой дополнительный контент, предназначенный для непосредственного следования за тегом, {{term}}
необходимо использовать в верхней части (внутри) первого {{defn}}
из {{term}}
. Их нельзя помещать между знаками {{term}}
и, {{defn}}
иначе это нарушит разметку глоссария. Изображения, конечно, могут быть размещены в другом месте внутри {{defn}}
, а нижние примечания, такие как {{ more }}, могут быть размещены в конце, но внутри a {{defn}}
. При использовании с термином из нескольких определений определение, в котором {{ghat}}
появляется этот термин, должно быть пронумеровано вручную (обычно 1 ...
, как показано в примере ниже).
{{срок | 1 = цветной шар | content = цветной шар {{якорь | цветной шар | цветные шары | цвет | цвета | цветной шар}}}} |
|
Технические подробности
На техническом уровне этот шаблон оборачивает термин в ...
элемент HTML, чтобы семантически пометить термин как определяющий экземпляр на странице определенного термина, и помещает это размеченное содержимое внутри элемента
термина
списка описания (также известного как список определений, ассоциативный список, список порождается и шаблонами), и дает CSS к элементу. Этот класс пока ничего не делает, но может позже, например, небольшое увеличение размера шрифта....
{{glossary}}
{{glossary end}}
class="glossary"
{{glossary}}
ака - Половина пары шаблонов; используется с классом, чтобы открыть закрывающийся список определений структурированного глоссария .{{gloss}}
{{glossend}}
{{glossary end}}
ака - Другая половина этой пары шаблонов; используется для закрытия открывшегося списка определений .{{glossend}}
{{gloss}}
{{term}}
- термин из глоссария, к которому{{defn}}
применяется определение; настроенныйс классом и встроенным
.
{{defn}}
- определение, относящееся к{{term}}
; используетс классом
{{ghat}}
- шаблон сноски, правильно отформатированный для верхней части{{defn}}
определения{{gbq}}
aka - шаблон блочной цитаты, правильно отформатированный для включения в определение{{gquote}}
{{defn}}
{{glossary link}}
- мета-шаблон для создания шаблонов ярлыков для ссылки на определения в определенных глоссариях- Википедия: Руководство по стилю / Глоссарии