Википедия:Руководство по стилю/Глоссарии

Ниже приведена предлагаемая политика , руководство или процесс Википедии . Предложение может все еще находиться в стадии разработки, обсуждения или в процессе сбора консенсуса для принятия.

Ярлыки МОС:ГЛОСС WP:ГЛОССАРИ

Эта страница в двух словах: Отдельные статьи со списком глоссария, а также встроенные в статью глоссарии должны быть отформатированы в единообразной манере. Формат глоссария, структурированный шаблоном, обеспечивает множество преимуществ.

В Википедии глоссарий — это особый вид списка . Каждый глоссарий — это алфавитный список терминов предмета с определениями. За каждым термином следует одно или несколько пояснительных (в стиле энциклопедии) определений . (Например, см. Глоссарий архитектуры ).

Чтобы объяснить жаргон для широкой аудитории Википедии, каждый из ее глоссариев содержит рабочий словарь и определения важных понятий для данной предметной области. Глоссарий обычно включает технические термины, жаргон, идиомы и метафоры данной области.

Глоссарии могут быть отдельными статьями-списками или встроенными списками в разделах статей . Отдельные глоссарии обычно называются «Глоссарий предметных терминов». Глоссарий внутри статьи обычно начинается с заголовка «Глоссарий».

Каждая статья в Википедии с заголовком в форме «Словарь предметных терминов» или аналогичной является таким глоссарием, как и разделы глоссария внутри некоторых статей. Они отличаются от контуров , которые озаглавлены в форме «Контур предмета » и могут также включать определения, но организованы в виде иерархии и используют свой собственный стиль форматирования, не рассматриваемый в этом руководстве. Форматирование глоссария, однако, не ограничивается только глоссариями в традиционном смысле. Базовая разметка списка описаний HTML предназначена для групп «терминов и определений, тем и значений метаданных, вопросов и ответов или любых других групп данных «имя–значение». ^[1]

В настоящем руководстве последовательно используются следующие термины:

глоссарий

Список отдельных записей , каждая из которых состоит из одного слова или более длинного термина с одним или несколькими определениями . Глоссарии подчиняются всем тем же правилам (например, Wikipedia:Verifiability и Wikipedia:Neutral point of view ) , что и другой контент в Википедии.

список

Отдельная статья списка или список, встроенный в статью , состоящий из записей в алфавитном порядке и в одном из предписанных стилей . Различия, для целей написания глоссария, между отдельной и встроенной статьей рассматриваются ниже.

вход

Дискретное понятие, которое можно однозначно назвать термином и описать или иным образом рассмотреть с помощью определения .

срок

Имя или метка для записи , отличающаяся от других записей. Обычно есть только один термин, хотя варианты написания и тому подобное иногда могут приводить к нескольким терминам на запись. Как и все остальное в Википедии, существование термина должно быть проверяемым .

определение

Проза, которая рассматривает термин записи в энциклопедически описательной манере. Хотя некоторые определения могут быть похожи на словари (например, для простых понятий или записей, для которых пока не найдено достаточно надежных источников , чтобы предоставить более подробную информацию), полный глоссарий таких определений неуместен в Википедии и, скорее всего, будет перемещен в Викисловарь . Часто бывает два или более определений для одного термина. Определения длиннее короткого абзаца могут указывать на необходимость статьи (или раздела статьи) о теме термина и ссылки на нее из определения глоссария вместо подробного определения в самом глоссарии.

стиль

Три стиля форматирования глоссария на выбор: шаблонно-структурированный, маркированный и подзаголовочно-структурированный. Они являются взаимоисключающими. (Кстати, этот глоссарий, который вы сейчас читаете в разделе «Терминология», имеет шаблонно-структурированный.)

При создании глоссария можно выбрать один из трех стилей: шаблонный, маркированный, подзаголовочный и (устаревший) с точкой с запятой и двоеточием.

Для форматирования содержимого глоссария используется специальный набор шаблонов. Шаблоны следующие:

• {{ glossary }} – этот шаблон используется в начале блока записей глоссария.
• {{ term }} – этот шаблон задает размер и стиль шрифта (жирный) для каждого термина
• {{ defn }} – этот шаблон обеспечивает форматирование определения термина.
• {{ glossary end }} – этот шаблон завершает блок записей глоссария

Почти все автономные и большинство встроенных глоссариев являются хорошими кандидатами для формата, структурированного шаблонами. Вот как выглядит этот формат:

==А–М==Необязательный вводный текст.{{глоссарий}}{{термин |1=термин A}}{{defn |1=Определение термина A}}{{термин |1=термин B}}{{defn |no=1 |1=Первое определение термина B.}}{{defn |no=2 |1=Второе определение термина B.}}{{конец глоссария}}

Этот стиль форматирования создает более чистый и насыщенный вывод XHTML из программного движка MediaWiki Википедии и использует стандартные элементы HTML, специально предназначенные для разметки глоссариев. Он дает много преимуществ, а синтаксис не требует много времени для изучения. Глоссарии, использующие этот стиль:

• Более доступны для тех, кто использует программы чтения с экрана , что важно для Википедии.
• Иметь напрямую связанные записи и другие редакционные преимущества (с компромиссом в пользу простоты), такие как согласованность кода.
• Повысить функциональность и удобство использования Википедии , а также упростить анализ и повторное использование глоссариев различными способами в сторонних приложениях.
• Используйте семантический HTML , улучшающий возможность повторного использования контента Википедии как программным обеспечением, так и людьми.
• Будет проверяться как корректный XHTML и HTML, обеспечивая самую широкую совместимость с браузерами (см. #Технические примечания, чтобы узнать, почему это важно)
• Технически правильно сформированный XML , еще один фактор совместимости
• Может быть последовательно расширен, например, для включения метаданных или для специального оформления терминов и определений.
• Будет проще перенастроить, если Википедия решит изменить форматирование всего сайта, как это часто бывает .

Чтобы создать глоссарий, структурированный по шаблону, выполните следующие простые шаги:

1. Глоссарий в целом (или каждая его часть, если он разбит на разделы, например, «A–M») окружен шаблоном и соответствующим тегом.{{glossary}}{{glossary end}}
2. Термин указывается на отдельной строке с использованием шаблона и автоматически выделяется жирным шрифтом.{{term}}
3. Далее на отдельной строке с использованием шаблона дается определение , которое следует либо за термином, либо за предыдущим определением.{{defn}}

Не делайте отдельные термины в шаблонно-структурированном глоссарии заголовками. Это приведет к искажению вывода . Термины будут связываемы, не будучи заголовками.

Используйте шаблоны как набор и не смешивайте и не сопоставляйте шаблоны глоссариев с кодом списка описаний вики-разметки ( ;и :стилем) или другой разметкой.

Если глоссарий состоит всего из нескольких статей с длинными определениями, рассмотрите возможность форматирования статьи в виде глоссария в виде подзаголовков, состоящего из обычных абзацев.

Шаблонно-структурированные глоссарии используют семантическую , доступную разметку, которая соответствует веб-стандартам , по причинам, подробно описанным выше. Некоторые примеры кода, показывающие различные варианты форматирования, которые могут отображаться в отдельной статье глоссария, разделенной на разделы по буквам алфавита:

==А–М==Необязательный вводный текст.{{глоссарий}}{{термин |1=термин A}}{{defn |нет=1 |1=Начало определения термина А.<p>Еще больше об определении термина А.</p>}}{{термин |1=термин B}}{{defn |no=1 |1=Первое определение термина B.}}{{defn |no=2 |1=Второе определение термина B.}}{{термин |1=термин C}}{{defn |1=Простое определение термина C.}}{{термин |1=термин D}}{{defn |1=Определение термина D, с...{{quote|Отрывок, процитированный блоком.}}Еще одно определение термина D.}}{{конец глоссария}}

Как показано в примере, несколько определений используют несколько шаблонов. См. документацию шаблонов для расширенных функций , и .{{defn}}{{term}}{{defn}}{{glossary}}

При структурировании по шаблону (используя эти шаблоны или созданные вручную с помощью HTML) определение ведет себя внутри своих <dd>...</dd>границ так же, как обычная проза и разметка. Можно легко использовать несколько абзацев, а блочные цитаты, вложенные списки и другие структуры можно использовать свободно , в отличие от других стилей. Гибкость и мощь тегов HTML намного богаче, чем те, которые предоставляются функциями wikimarkup ;и :списков описаний или *неупорядоченных списков, которые не работают должным образом из-за ошибок и неисправностей MediaWiki.

Несколько абзацев можно создать, как и в обычной прозе, просто вставив пустую строку, как показано в примере, или можно явно заблокировать их с помощью <p>…</p>разметки.

Внутри , весь текст и другой контент должны быть внутри . Следующая разметка недействительна в нескольких местах, как указано в аннотации:{{glossary}}{{defn}}

{{glossary}} {{Main| Hatnotes и другие шаблоны не могут располагаться здесь, внутри списка глоссария, но перед терминами и определениями }} {{term|1=термин A}} {{defn|1=Определение термина A.}} {{term|1=термин B}} {{defn|no=1|1=Первое определение термина B.}} {{defn|no=2|1=Второе определение термина B.}} {{term|1=термин C}} {{defn|1=Определение термина C.}} {{glossary end}}[[File:misplaced_image.png|thumb|right|300px|This image cannot be between the term and definition like this.]]<blockquote>Between definitions is no place for a quotation or anything else.</blockquote><p>A paragraph (or whatever) can't be between entire entries, without {{glossary end}} to close the glossary before the content and a new {{glossary}} to open glossary formatting again after that content being interpolated.</p>

Такой дополнительный контент не помещается внутрь тега {{term}}, который предназначен только для термина и его разметки.

Это самый простой стиль, используемый для глоссариев. Это приложение маркированного списка . Пример, с определениями рядом с терминами:

==Глоссарий==Необязательный вводный текст.*  '''термин A'''  – определение. *  '''термин B'''  – 1. Первое определение . 2. Второе определение.

Этот простой стиль часто используется во встроенных глоссариях. Нумерованные списки (начинающиеся с #вместо *) не следует использовать, так как они подразумевают определенный (например, иерархический или хронологический) порядок.

Сложные глоссарии лучше всего составлять с использованием шаблонно-структурированного формата.

Блоки текста, правильно размеченные, могут использоваться для более длинных определений. Определения из нескольких абзацев<p>...</p> требуют разметки абзацев HTML без пробелов wikimarkup между любым из отрывков и разрывом из-за ограничений MediaWiki (см. Wikipedia:Manual of Style/Glossaries/DD bug test cases для технических подробностей) . <p>...</p>Разметка требуется как до, так и после разрыва, иначе межстрочный интервал будет заметно непоследовательным. Пример с определениями под терминами:

==Глоссарий==Необязательный вводный текст.*  '''термин A'''  {{ pb }} Определение. *  '''термин B'''  {{ pb }} 1. Первое определение. {{ pb }} 2. Второе определение. *  '''термин C'''  {{ pb }} Начало длинного определения. {{ pb }} Продолжение длинного определения. {{ pb }} Заключение длинного определения.

<p>...</p>Вместо шаблона можно также использовать явные элементы , например:{{pb}}

*  '''термин A'''  < p > Определение. </ p > *  '''термин B'''  < p > 1. Первое определение. </ p >< p > 2. Второе определение. </ p > *  '''термин C'''  < p > Начало длинного определения. </ p >< p > Продолжение длинного определения. </ p >< p > Заключение длинного определения. </ p >

Не забудьте использовать закрытие </p>.

Не смешивайте и не сопоставляйте эту разметку неупорядоченного списка с разметкой для упорядоченных списков или списков определений , так как вывод будет недействительной разметкой, а визуальное форматирование не будет согласованным (упорядоченные и неупорядоченные списки имеют больший отступ). Сравните:

* '''термин А''' : Определение * '''термин X''' : 1. Первое определение. : 2. Второе определение. * '''термин Y''' # Первое определение. # Второе определение. * '''термин Z''' ** Первое определение. ** Второе определение.

HTML-вывод этого — это крушение поезда, особенно для пользователей со слабым зрением, использующих программное обеспечение для чтения с экрана , которым последовательно сообщают, что: начался неупорядоченный список из одного элемента; этот список закончился; начался список описаний без термина, но с одним неназначенным определением; этот список закончился; начался еще один неупорядоченный список из одного элемента и закончился; начался еще один список описаний без термина, но с двумя определениями, не связанными с термином, и закончился; начался третий неупорядоченный список из одного элемента и закончился; начался и закончился пронумерованный список из двух элементов, не связанных с вышеуказанным материалом; начался четвертый неупорядоченный список из одного элемента, затем начался встроенный неупорядоченный список из двух элементов, затем оба закончились. Как правило, нет четкой связи между любыми терминами и определениями или даже ощущения, что это один список вещей, которые каким-либо образом связаны друг с другом.

Отдельные глоссарии с ограниченным количеством в основном длинных и подробных определений иногда лучше всего форматировать с записями в качестве подзаголовков. Одним из примеров такого глоссария является Glossary of Ancient Roman religion . Этот стиль не следует использовать для встроенных глоссариев , так как он перегрузит оглавление статьи записями глоссария. Он также создаст слишком длинное оглавление в отдельном глоссарии с большим количеством записей. При использовании этого стиля определения представляются как обычные прозаические абзацы:

==А–М==Необязательный вводный текст.===термин А===Определение.===термин B===1. Первое определение.2. Второе определение.

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

Несколько определений нумеруются вручную, как показано; не используйте упорядоченные списки. Этот тип глоссария особенно иногда использует нечисловые идентификаторы с несколькими определениями. Определения из нескольких абзацев такие же, как и любые другие абзацы прозы Википедии.

==А–М==Необязательный вводный текст.===термин А===Определение.===термин B==='' [[ Химия ]] '' : Первое определение.Больше похоже на первое определение.'' [[ Экономика ]] '' : Второе определение.'' [[ Подводное плетение корзин ]] '' : Третье определение.

Базовые элементы <dl>, <dt>и <dd>HTML (сгенерированные в структурированном шаблоном глоссарии) также являются тем, что выводится списками викикода, отформатированными с использованием начальных символов ;и :. (Подробнее см . в Wikipedia:Руководство по стилю/Списки § Описание (определение, ассоциация) списков .)

Этот стиль разметки очень «хрупкий» и не рекомендуется для глоссариев, за исключением самых коротких и простых, поскольку они, скорее всего, будут иметь нарушенную семантическую структуру. Даже что-то столь простое, как пустая строка, нарушит такой список. (См. § Избегайте вики-разметки с запятой и двоеточием для глоссариев ниже.)

==Глоссарий==Необязательный вводный текст.; термин 1 : Определение ; термин 2 : 1. Первое определение. : 2. Определение раздела.

Следующие рекомендации применимы ко всем глоссариям и должны соблюдаться независимо от того, какой стиль форматирования, представленный выше, используется. Контуры Википедии , содержащие записи с аннотациями в иерархическом (классифицированном) порядке, не охватываются этими рекомендациями.

В глоссарии расположите все термины в алфавитном порядке от A до Z. Записи не должны добавляться случайным образом или в произвольном порядке. Символ на основе латиницы с диакритическими знаками располагается в алфавитном порядке после простого символа, на котором он основан. Символы на основе нелатиницы располагаются в алфавитном порядке в порядке их появления в Unicode .

Если присутствуют числовые записи, они предшествуют словесным, а любые символические записи предшествуют обеим (например: "!" перед "1" перед "A"). Числовые записи, которые иногда появляются в контексте темы статьи как числительные или как произносимые устно, следует давать в форме "три (3)" в коротких глоссариях. В более длинных глоссариях более целесообразно создавать отдельные записи, помещать определение в одну и делать перекрестную ссылку на другую запись; в большинстве случаев помещать определение в словесную, а не числовую запись. Если есть определимая разница в использовании между числительными и глагольными терминами в контексте, используйте отдельные записи и различайте их с помощью перекрестных ссылок.

Если символических записей нет, а есть только одна или несколько цифровых записей, то допускается расположить цифровые записи в алфавитном порядке так, как если бы они были написаны устно, в форме «3 (три)», чтобы избежать создания очень короткого раздела цифровых записей.

Создайте отдельный раздел (или подраздел) в длинной автономной статье глоссария для каждой буквы, но сгруппируйте их в диапазоны, когда это уместно, например, «X–Z». Для более коротких автономных глоссариев вы можете разделить всю статью на диапазоны, например, «0–9», «A–M» и «N–Z», или вообще не использовать разделения для очень коротких случаев (которые могут быть кандидатами на объединение в основные статьи по теме). Не разделяйте встроенный список, так как это затрудняет редактирование и может значительно удлинить общее оглавление статьи; если встроенный список достаточно длинный, чтобы его можно было бы разбить на разделы, он является хорошим кандидатом для разделения на отдельную автономную статью глоссария. Не создавайте пустые разделы.

Форматирование глоссария можно использовать для списков, которые не являются строго глоссариями в обычном смысле, и многие из них будут иметь неалфавитное обоснование порядка (например, хронологическое или географическое).

В большинстве глоссариев начинайте каждый термин глоссария со строчной буквы, если только это не имя собственное или аббревиатура/инициализация. В то время как заглавная первая буква каждого термина даст более однородный, структурный результат (именно поэтому это стандарт для упорядоченных и неупорядоченных списков в Википедии), естественная капитализация создает меньше двусмысленностей в глоссарии.

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

• Ни один термин в глоссарии не является строчной формой слова, которое в других контекстах обычно пишется с заглавной буквы.
• Не существует разницы между заглавными и строчными буквами любого термина в глоссарии.
• Термины не содержат смеси имен собственных и нарицательных существительных.
• В противном случае написание всех записей заглавными буквами вряд ли приведет к какой-либо двусмысленности или путанице.
• Глоссарий вряд ли когда-либо расширится таким образом, что это нарушит один из вышеперечисленных случаев (т. е. он либо уже исчерпывающий, либо строго ограничен узкими критериями включения, либо содержит исключительно имена собственные).

Начинайте каждое определение с заглавной буквы, даже если это фрагмент предложения.

Вышеизложенное не относится к использованию списков описаний (с шаблонами глоссария или без них) для материалов, которые не образуют глоссарий, например, список персонажей или указатель различных моделей в серии продуктов.

Wikipedia — это не словарь ; соответственно, объясните термины глоссария описательно (так же, как это делает обычная статья энциклопедии, но более кратко). Только изредка и скупо добавляйте словарные определения в глоссарий в Wikipedia (обычно исключительно для полноты). Списки словарных определений принадлежат Wiktionary ; вы по-прежнему можете ссылаться на них из статей Wikipedia.

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

Все записи должны быть проверены надежными источниками , как и обычный контент статьи.

Проект приложения к глоссариям Викисловаря, скорее всего, перенесет вики копию любого глоссария, созданного в Википедии, и может значительно переработать его в более словарном направлении. Синхронизировать правки между двумя версиями не обязательно (и может быть вредно), хотя редко будет уместно существовать в какой-либо форме только в одной версии, но не в другой. Существование глоссария Викисловаря по теме, которая имеет хорошо разработанную основную статью, может быть хорошим признаком того, что энциклопедический глоссарий по этой теме может быть разработан либо с использованием глоссария словаря в качестве основы, либо с нуля. Если обе версии существуют, они должны ссылаться друг на друга в своих соответствующих разделах «См. также» с помощью шаблона родственного проекта, например (см. Wikipedia:Wikimedia sister projects для рекомендаций о лучшем выборе шаблона для различных ситуаций) .{{Wiktionary|name of page at Wiktionary}}

Одно определение может фактически иметь два или более терминов над собой в качестве вариаций или альтернатив с тем же определением. Наиболее распространенный вариант использования для этого — представление термина в двух языковых вариантах. Это делается с помощью {{ lang }} и соответствующих языковых кодов ISO, как описано в этом шаблоне. В структурированных шаблонами глоссариях голый термин без разметки должен быть первым параметром {{ term }} , а версия языковой разметки — параметром 2. Если требуется отображение названия языка/диалект, можно использовать вместо . Пример:{{langx|language-code}}{{lang}}

{{term|1=tire | content={{langx|en-US|tire}} }}{{term|1=шина | content={{langx|en-GB|шина}} }}{{defn|1=Эластичное покрытие колеса, обычно изготавливаемое из вулканизированной резины.}}

Результат:

Американский английский : tire

Британский английский : tire

Упругое покрытие колеса, обычно изготавливаемое из вулканизированной резины.

Версия wikimarkup более компактна, но имеет очень ограниченную функциональность и не может обрабатывать сложные входные данные:

; {{langx|en-US|шина}}
; {{langx|en-GB|шина}}:Эластичный чехол колеса, обычно изготавливаемый из вулканизированной резины.

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

Wikilinks на другие страницы или разделы, как правило, не следует использовать в термине в списке описаний, независимо от того, отформатирован ли он с помощью шаблонов глоссария или нет. Обоснования в WP:Manual of Style § Заголовки разделов применимы в равной степени к терминам списка описаний, поскольку они служат целям как подзаголовков, так и содержимого списка. В разметке, структурированной шаблонами, термины сами по себе являются целями ссылок; не все браузеры правильно обрабатывают содержимое, размеченное как цель ссылки и как якорь исходящей ссылки. Ссылки изнутри термина следует особенно избегать в реальных глоссариях, где запись термина должна стоять сама по себе в этом контексте. Если на другой странице есть более подробный материал для рассматриваемого термина, добавьте ссылку на термин в строке или используйте явную перекрестную ссылку на этот материал.

Ссылки внутри содержания определений создаются по мере необходимости, как и в любом другом энциклопедическом прозаическом контенте.

Якоря (точки, на которые может напрямую указывать ссылка, например [[Glossary of Foo terms#weaselsnorkel]]) можно создавать в маркированных, подзаголовочных и вики-разметочных глоссариях ( ;и :) с помощью шаблона.{{Anchor}}

Шаблонно-структурированные глоссарии автоматически (в определенных пределах) предоставляют связываемые термины (см. Шаблон:Термин § Wiki-стиль и связывание термина ) ), а также можно создавать якоря для конкретных определений с использованием параметров шаблона ( Шаблон:Определение § Создание независимо связываемых определений ) .

В глоссариях с маркированными списками и подзаголовками по желанию можно размещать заметки типа и , изображения и другие материалы.{{Main}}{{See also}}

Hatnotes вообще нельзя использовать с вики-разметкой ( ;и :) глоссариями, за исключением случаев перед началом глоссария и после его окончания. Это также относится ко всему контенту, размеченному как <div>или другой блочный элемент, например, шаблоны боковой панели, ссылающиеся на родственные проекты . Изображения можно добавлять в определение, но они должны быть встроены в него, без разрыва ссылки.

В структурированных шаблонами глоссариях, примечания, изображения и другой подобный контент должны быть размещены внутри определения, а не между термином и определением, или между последним определением и следующим термином. За исключением этого ограничения, весь такой контент может быть использован в обычном режиме внутри блока определения. Вы можете посчитать отступ шаблонов примечаний неуклюжим внутри определения; специфичный для глоссария шаблон примечания общего назначения удаляет этот отступ.{{ghat}}

Избегайте использования вики-разметки списков описаний (с ;и :) для глоссариев, так как она сильно ограничена и содержит ошибки. Хотя такие списки подходят для создания очень простых отступов, программное обеспечение MediaWiki не обрабатывает сложные определения изящно в этом формате или не допускает пустых строк между элементами, не разрушая семантическую разметку. Существующие примеры следует преобразовать в структурированные шаблонами глоссарии, так как большая часть работы уже сделана.

Используйте стиль глоссария, определенный выше, а не ваше собственное выдуманное форматирование, такое как псевдосписок, созданный с помощью ручного стиля, или неправильное использование нумерованного (упорядоченного) списка. У нас есть стандарты форматирования списков по нескольким причинам, и несоблюдение их может запутать читателей и редакторов, затруднить повторное использование контента Википедии , затруднить автоматическую обработку и привести к проблемам с удобством использования и доступностью.

В некоторых случаях таблицы лучше подходят для связывания контента, чем списки описаний, особенно когда для каждого элемента имеется несколько значений.

Статьи глоссария должны соответствовать тем же условиям, что и другие статьи; они будут включать хорошо разработанный вводный раздел и ссылки .

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

__ NOTOC __{{ Компактное оглавление |center=yes|symnum=yes|refs=yes}}

или, если есть только алфавитные записи от А до Я, просто:

__NOTOC__ {{ Компактное оглавление | центр = да | ссылки = да }}

Существует несколько вариантов; см. документацию по Template:Compact ToC .

Обратите внимание, что заголовки разделов, как обычно, необходимо создавать вручную и точно соответствовать выбранным {{Compact ToC}}параметрам.

Каждый раздел на длинной странице глоссария должен заканчиваться другим вызовом {{Compact ToC}}(или какой-либо другой формой краткой навигации по разделам). Компактное оглавление может использоваться с различными другими включенными параметрами, чтобы сохранить тонкость и линейность отображения и со ссылкой на верхнюю часть страницы, например:

{{ Компактный оглавление | сторона = да | центр = да | верх = да | симметрия = да | ссылки = да | без разрыва = да }}

В зависимости от {{Compact ToC}}набора параметров может быть раздел для записей, начинающихся с цифр, с символов или и того, и другого. Если он есть, этот раздел должен предшествовать "A" или какому бы ни был первый алфавитный раздел ("A–M" и т. д.) Записи, которые обычно, но не всегда, встречаются в числовой форме, должны быть приведены в этом разделе и иметь перекрестные ссылки на него из его написанного имени или наоборот, не давать дублирующих определений. Перекрестные ссылки выделены курсивом. Пример:

{{ term | 1 = 20 танков }} {{ defn | ''См . [[# Двадцать танков | Двадцать танков ]] .'' }}...{{ term | 1 = Twenty Tanks }} {{ defn | ''Также '''20 Tanks''' .'' Twenty Tanks была отмеченной наградами микропивоварней в Сан-Франциско, Калифорния, и дочерним предприятием пивоварни Triple Rock в Беркли. }}

Для статьи со списком глоссария, состоящей из простого лида и глоссария, предпочтительна форма Глоссарий предметных терминов с перенаправлениями на нее из Глоссарий предметных терминов , Предметные термины , Предметный глоссарий , Предметная терминология , Предметный жаргон , Предметный сленг и Список предметных терминов (последний соответствует более общему правилу именования списков шаблона «Список предметных s»).

Для статьи, которая в основном состоит из списка глоссария, но имеет хорошо разработанный прозаический материал по истории и использованию терминологии или другую подобную информацию (стоимостью в несколько абзацев), предпочтительна форма Тематические термины с перенаправлениями на нее из Глоссария тематических терминов , Тематического глоссария и других названий (помните, что читатель не может догадаться, была ли статья разработана таким образом). Ссылки из перенаправлений с названием «глоссарий» могут вести непосредственно в раздел глоссария, если исторический и другой материал длинный. Для статьи, которая в основном посвящена истории, развитию, распространению и т. д. терминологии как корпуса жаргона определенной предметной области (например, юридической, танцевальной и т. д. терминологии в целом) и может включать встроенный глоссарий ключевых терминов, предпочтите Тематическая терминология , снова со всеми перенаправлениями. Вполне вероятно, что такая статья в конечном итоге разделится на прозаическую статью и отдельную, более развитую, статью-глоссарий с течением времени.

Для глоссария терминов и персонажей, используемых в произведении или серии произведений художественной литературы (т. е. вымышленной вселенной ), предпочтительна форма Глоссарий терминологии названий произведений/серий/франшиз (опять же с перенаправлениями), поскольку термины образуют терминологическую систему , которая не существует как термины, используемые вне этого вымышленного контекста. Пример: Глоссарий терминологии Темных начал .

Общие рекомендации на странице WP:Отдельные списки#Соглашения об именовании (например, обращение с национальностями, вымышленными субъектами и т. д.) включают также глоссарии, насколько это применимо.

Подстатьи многостраничных разделенных глоссариев должны следовать рекомендациям WP:Соглашения об именовании (длинные списки) в той мере, в какой это применимо. Короче говоря, они должны быть названы как исходная (главная) страница глоссария, с буквой или диапазоном охватываемых букв алфавита (или цифр и т. д.) после двоеточия после этого названия, например, Глоссарий терминов подводного плетения корзин: A–M или Термины керлинга: N–Z. Согласно WP:Руководству по стилю#тире , для разделения диапазона используется короткое тире ( –), а не дефис (-), длинное тире (—), минус (−) или другой подобный символ; однако дефисная форма названия статьи (например, Термины керлинга: NZ) также должна существовать как перенаправление на настоящую страницу статьи (AnomieBOT сделает это автоматически). Введите короткое тире как –или щелкните по нему справа от вкладки «Вставить» под окном редактирования; или см. Как сделать тире .

Специализированные глоссарии могут потребовать другого типа названия (в том числе для подразделов многочастных глоссариев), например, Глоссарий компьютерных терминов: Unix и Linux, Глоссарий компьютерных терминов: Microsoft Windows и т. д.

См. разделы «Встроенные глоссарии» и «Использование форматирования глоссария в списках, не являющихся глоссариями» ниже для получения информации о связанных с именованием проблемах.

Глоссарий, который становится слишком длинным (более 400  КБ ) ^[a], следует разбить на несколько статей. Это более высокий рекомендуемый предел, чем для обычных статей, поскольку мы обычно не ожидаем, что читатели будут прорабатывать глоссарий от начала до конца, поэтому их длина не должна ограничиваться объемом внимания, а основная цель глоссария — ссылки на конкретные записи и, что особенно важно, внутристраничный поиск, который нарушается при разбиении. С другой стороны, очень большие статьи загружаются дольше, особенно при редактировании или предварительном просмотре.

При необходимости глоссарии обычно следует разбивать на примерно равные части, а не пытаться преобразовать их в стиль резюме или прореживать, сужая тему глоссария. Например, первое разделение Глоссария терминов подводного плетения корзин может быть на Глоссарий терминов подводного плетения корзин: A–M и Глоссарий терминов подводного плетения корзин: N–Z, но очень длинным глоссариям может потребоваться еще больше частей, и в некоторых глоссариях некоторые разделы из одной буквы будут намного длиннее других. Если есть термины, начинающиеся с цифр или символов, они должны идти перед A, в своих собственных разделах, если только их не достаточно, чтобы оправдать отдельную подстатью.

Для оригинального названия «Словаря терминов подводного плетения корзин» есть два хороших решения:

• Сделайте перенаправление на первый фрагмент и включите туда исходный лид.
• Создайте страницу с разъяснениями, с полным описанием и ссылками на все разделы.

В любом случае, другие фрагменты должны иметь резюме полного лида, так что несколько различных лидов не развиваются. Первый метод проще; второй предпочтительнее для глоссариев настолько длинных, что им нужно больше трех или четырех фрагментов, или для списков статей в формате глоссария, но не в базовом алфавитном порядке (велосипеды по производителю, войны по году и т. д.).

Необходимо быть внимательным при разделении глоссариев на подстатьи. Каждая подстатья должна ссылаться на предыдущую и последующую, а также на страницу устранения неоднозначности, если таковая имеется; {{ Compact ToC }} может помочь в этом. Каждая подстатья должна иметь свой собственный раздел ссылок, и их следует проверить, чтобы убедиться, что они все еще работают. В частности, первый экземпляр именованного тега <ref> в каждой подстатье будет нуждаться в собственном тексте и не может быть просто вторичным вызовом. Имя для одной и той же ссылки не должно меняться от подстатьи к подстатье.<ref name="ref-name" />refname=

Глоссарий, включенный в статью, может иногда быть полезен читателям, либо для лучшего понимания терминологии статьи, либо для того, чтобы узнать больше о терминологии, используемой в области, охватываемой статьей, или и то, и другое. Он также может предоставлять глоссарий, на который можно ссылаться из связанных статей, если и до тех пор, пока не будет оправдан отдельный глоссарий.

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

• Глоссарий должен быть отдельным разделом с заголовком, идентифицирующим его как глоссарий (это не только упорядоченно, но и позволяет напрямую ссылаться на глоссарий). Заголовок этого раздела должен соответствовать WP:Manual заголовков Style#Section — не повторяйте тему в заголовке. Он также не должен использовать излишнюю многословность («Глоссарий ключевых терминов в дисциплине» и т. д.) — сохраняйте простоту . ==Glossary==В большинстве случаев подойдет простой.
• Если в глоссарии будет 5 или менее терминов, вероятно, лучше дать краткое определение терминов в контексте текста статьи, а не использовать глоссарий.
• Если глоссарий будет содержать 25 терминов или более, вероятно, лучше создать отдельную статью-глоссарий.
• Если записи будут очень подробными, вероятно, лучше использовать отдельный глоссарий; встроенные записи должны быть краткими.
• Встроенные глоссарии не должны использовать подзаголовки внутри себя (например, для букв алфавита), и должны быть просто редактируемыми как один раздел. Если он достаточно большой, чтобы нуждаться в подразделении, то, вероятно, это должна быть отдельная статья .

Предпочтительным методом создания встроенного глоссария является использование шаблонно-структурированного стиля и размещение глоссария под одним, четко обозначенным заголовком (например, ==Glossary==). Это требует немного больше работы, чем маркированные списки, но обеспечивает большинство преимуществ автономного шаблонно-структурированного глоссария и позволяет очень легко в конечном итоге переместить глоссарий на отдельную страницу, когда глоссарий становится длиннее.

Форматирование в стиле глоссария не ограничивается использованием в глоссариях. Существуют и другие способы использования методов разметки, используемых в глоссариях. Их можно использовать для представления данных в других типах списков. Например, форматирование в стиле глоссария может хорошо подойти для представления списка серийных номеров самолетов вместе с их моделями и описаниями, используя ту же базовую компоновку, что и в глоссариях.

Для статьи, которая является списком, не являющимся глоссарием, но использующим форматирование глоссария, следуйте советам в WP:Stand-alone lists#Naming conventions . Для именования многостраничных, разделенных списков см. WP:Naming conventions (lists) . Иногда таким спискам требуется индивидуальное именование, если они не могут быть естественным образом выражены в виде алфавитных или числовых диапазонов, например, List of automobiles: Chevrolet, List of automobiles: Ford и т. д. Обратите внимание, однако, на стандартизированное использование двоеточия, а не скобок, запятой, тире, косой черты или другого разделителя. Однако, когда доступна описательная фраза на естественном английском языке , она обычно предпочтительнее; реальные статьи, соответствующие предыдущим примерам, находятся в List of Chevrolet vehicles и List of Ford vehicles .

Неглоссариям часто требуется иное разделение (числовое, тематическое), чем глоссарию, и, следовательно, могут потребоваться иные требования к оглавлению. Для многостраничных длинных списков каждая подстатья нуждается в межстраничной навигации определенного типа к другим статьям в серии. Некоторые решения включают специализированные компактные оглавления и пользовательские шаблоны навигации . Такие списки также могут иметь иные требования к порядку разделов , например, по дате в списке событий вместо алфавитного.

1. Хотя большинство из нас уже понимают, что доступность и удобство использования имеют решающее значение, многие не знают, что валидация кода , правильность построения и семантическая корректность также важны. Очень тривиальные ошибки синтаксиса HTML могут привести к сбоям рендеринга даже в парсере надежного серверного движка MediaWiki Википедии , и их влияние на каждую из многочисленных платформ браузеров и автоматизированных инструментов на стороне пользователя непредсказуемо. Это не Всемирная паутина 1995 года; стандарты действительно имеют значение сегодня.
2. Обработка списков определений (описаний, ассоциаций) в MediaWiki с помощью точек с запятой и двоеточий ( ;и :) вики-разметки крайне нестабильна и не может использоваться ни для каких, кроме самых простых глоссариев, не вызывая проблем как для читателей, так и для редакторов. Вместо этого необходимо использовать настоящий HTML с помощью простых шаблонов, описанных здесь (или чистый HTML в необычных случаях с особыми требованиями). Две самые большие проблемы с разметкой ;и :заключаются в том, что даже одна пустая строка для удобства чтения между определениями приводит к искаженной разметке (часто не видимой для пользователей графических браузеров, но проблематичной согласно пункту № 1 выше и очень заметной в других приложениях, таких как программы чтения с экрана для слабовидящих ). Многоабзацные и иные сложные определения могут быть правильно получены внутри такой разметки только таким образом, что их будет трудно редактировать и поддерживать. (См. Wikipedia:Manual of Style/Glossaries/DD bug test cases для множества технических подробностей.) Обе эти проблемы устраняются с помощью форматирования глоссария на основе шаблонов, представленного выше.
3. В списках определений вики-разметки пустая строка между целыми записями (т. е. между определением одной записи и термином следующей) для большего расстояния между записями допускается и не повлияет на семантику кода или вывода, но только если {{glossary}} и {{glossary end}}(или вручную вставленные <dl>...</dl>теги) окружают все записи (всего глоссария или раздела, если глоссарий разбит на разделы) как блок. Если они пропущены, MediaWiki будет рассматривать каждый термин как свой собственный полный список определений и выводить беспорядочный код, который семантически бесполезен. Однако даже если редактор их включит, более поздний редактор, скорее всего, удалит их, посчитав их избыточными.

Для технически подкованных людей ниже приводится объяснение фактической HTML-разметки, которая будет визуализирована из шаблонов браузером читателя (не считая различных классов и других деталей, которые автоматически предоставляются веб-приложением MediaWiki, и с небольшими пробелами, очищенными для удобства чтения человеком). Код проходит валидацию, структурно правильно сформирован и семантически корректен .

1. {{Glossary}}и {{Glossary end}}вместе вызывают структуру HTML- <dl>...</dl> списка описаний (называемую списком определений в HTML 4, а иногда также называемую списком ассоциаций ); к сожалению, в настоящее время сочетание клавиш «dl» недоступно
2. {{Term}}также вызывает элемент HTML термина списка описаний со встроенным определяющим экземпляром элемента термина{{dt}}<dt>...</dt> <dfn>...</dfn>
3. {{Defn}}также вызывает элемент определения списка описаний{{dd}}<dd>...</dd>

Пример викикода:

{{глоссарий}}{{термин |термин А}}{{defn |Определение 1.}}{{термин |термин B}}{{defn |no=1 |Начало первого определения.<p>Вывод из первого определения.</p>}}{{defn |no=2 |Второе определение.}}{{конец глоссария}}

Представленный HTML (без CSS):

< dl > < dt  id = "term_a" >< dfn > термин A </ dfn ></ dt > < dd > Определение 1. </ dd > < dt  id = "term_b" >< dfn > термин B </ dfn ></ dt > < dd > 1.    Начало первого определения. < p > Заключение первого определения. </ p > </ dd > < dd > 2.    Второе определение. </ dd > </ dl >

< dl  class = "glossary " > < dt  id = "term_a " > < dfn > термин A > < / dfn > < dd > Определение 1. </ dd > < dt id = "term_b " > >< dfn > термин B > </ dfn > < dd class = " glossary " > 1. & # 160 ; & # 160 ; Начало первого определения. < p > Заключение первого определения. </ p > </ dd > < dd > 2.    Второе определение. </ dd > </ dl >  

Полученный результат:

термин А

Определение 1.

термин Б

1. Первое определение начинается.

Первое определение, вывод.

2. Второе определение.

Результат будет таким же, если вы поместите все {{defn}}выражение term Bв одну строку, при условии, что <p>...</p>для введения разрыва абзаца в определении используется разметка:

{{защита|1. Начало первого определения.<p>Заключение первого определения.</p>}}

То есть следующая смесь разметки HTML и разметки MediaWiki, пытающаяся использовать простые пробелы для создания разрыва абзаца, больше не работает внутри <dd>...</dd>(и, следовательно {{defn|...}}, ) с 2023 года (и примерно с 2014 года):

{{defn|1. Первое определение начинается.Первое определение, вывод.}}

Результат будет объединен в выходных данных:

1. Первое определение начало. Первое определение заключение.

Такое поведение согласуется с тем, что MediWiki не может автоматически разбивать абзацы внутри других элементов inline-block, включая <blockquote>и <li>. (Элементы inline-block — это те блочные элементы, которые в рекомендациях WHATWG, т. е. практически в каждом современном браузере, по умолчанию имеют значение CSS display: inline-block;.)

В Википедии существуют и другие формы квазинавигационных страниц представления контента:

• Википедия:Категории, списки и шаблоны навигации
• Википедия:Индексы
• Википедия:Контуры
• Wikipedia:Статьи Set-index
• Википедия:Отдельные списки
• Википедия:Хронология