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

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

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

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

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

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

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

Терминология [ править ]

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

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

глоссарий

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

список

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

Вход

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

срок

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

определение

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

стиль

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

Стили форматирования глоссария [ править ]

Есть три стилей на выбор при создании словаря: шаблон структурированных , пуля стиле и подсубпозиции стиле .

Структурированный шаблон [ править ]

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

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

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

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

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

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

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

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

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

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

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

Форматирование [ править ]

Этот раздел был изменен с октября 2014 года: определения, <p>...</p>состоящие из нескольких абзацев, теперь требуют разметки из-за изменений в парсере MediaWiki.

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

== А – М ==Необязательный вводный текст.{{глоссарий}}{{термин | 1 = термин A}}{{defn | no = 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 с ...{{gbq | Отрывок, цитируемый блоком.}}Больше определения термина D.}}{{конец глоссария}}

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

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

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

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

{{глоссарий}}
{{tn | Главная | Сноски и другие шаблоны не могут находиться здесь, внутри списка глоссария, но перед терминами и определениями } {{term}} | 1 = термин A[[Файл: misplaced_image .png | thumb | right | 300px | Это изображение не может находиться между таким термином и определением. ]] {{defn}} | 1 = Определение термина A. {{term}} | 1 = term B {{defn}} | no = 1 | 1 = Первое определение термина B.<blockquote> Между определениями нет места для цитаты или чего-то еще. </blockquote> {{defn}} | no = 2 | 1 = Второе определение термина B.<p> Абзац (или что-то еще) не может находиться между целыми записями, если не {{glossary end}}закрыть глоссарий перед содержимым и новое, {{glossary}}чтобы снова открыть форматирование глоссария после интерполяции этого содержимого. </p> {{term}} | 1 = термин C 
{{defn}} | 1 = Определение термина C. {{конец глоссария}}

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

Bullet-style [ править ]

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

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

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

Сложные глоссарии лучше всего делать в формате с шаблонной структурой .

Блоки текста, правильно размеченные, могут использоваться для более длинных определений. Определения , состоящие из нескольких абзацев, требуют <p>...</p>разметки абзацев HTML без каких-либо пробелов вики-разметки между переходами и разрывом из-за ограничений MediaWiki ( технические подробности см. В Википедии: Руководство по стилям / глоссариям / тестовым примерам ошибок DD ) . <p>...</p>Разметки требуются как до , так и после перерыва или межстрочный интервал будет заметно непоследовательным. Пример с определениями терминов ниже:

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

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

* '' 'термин C' ''*: <p> Начало длинного определения. </p> <p> Продолжение длинного определения. </p> <p> Заключение длинного определения. </p>

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

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

Стиль подзаголовка [ править ]

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

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

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

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

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

Общие правила написания глоссариев [ править ]

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

По алфавиту [ править ]

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

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

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

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

Альтернативы [ править ]

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

Используйте естественные заглавные буквы [ править ]

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

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

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

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

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

Что включить [ править ]

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

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

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

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

Как работать с несколькими вариантами термина [ править ]

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

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

Результат:

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

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

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

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

; {{lang-en-US | шина | paren = y}}
; {{lang-en-GB | шина | paren = y}}: Эластичное покрытие колеса, обычно сделанное из вулканизированной резины.

Как работать с несколькими определениями [ править ]

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

Ссылка [ править ]

Исходящие ссылки [ править ]

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

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

Входящие ссылки [ править ]

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

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

Сноски, изображения и т. Д. [ Править ]

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

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

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

Избегайте использования вики-разметки с точкой с запятой и двоеточием для глоссариев [ править ]

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

Используйте только стандартные стили [ править ]

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

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

Автономные статьи глоссария [ править ]

Макет [ править ]

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

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

__ NOTOC __ {{ Compact ToC | center = yes | symnum = yes | refs = yes}}

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

__NOTOC __ {{Compact ToC | center = yes | refs = yes}}

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

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

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

{{Compact ToC | side = yes | center = yes | top = yes | symnum = yes | refs = yes | nobreak = yes}}

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

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

Соглашения об именах [ править ]

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

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

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

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

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

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

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

Увеличение и разделение статьи [ править ]

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

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

Есть два хороших решения для названия оригинального Глоссария терминов подводного плетения корзин :

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

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

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

Встроенные глоссарии [ править ]

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

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

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

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

Использование форматирования глоссария в списках, не относящихся к глоссарию [ править ]

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

Для статьи, которая не является списком глоссария, в котором используется форматирование глоссария, следуйте совету на WP: Автономные списки # Соглашения об именах . Для присвоения имен многостраничным разделенным спискам см. WP: Соглашения об именах (длинные списки) . Такие списки иногда требуют индивидуального наименования, если они не могут быть естественным образом выражены в виде буквенных или числовых диапазонов, например Список автомобилей: Chevrolet , Список автомобилей: Ford и т. Д. Обратите внимание, однако, на стандартизованное использование двоеточия, а не скобок, запятой. , тире, косой черты или другой разделитель.

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

Технические примечания [ править ]

1. В то время как большинство из нас уже понимает , что доступность и удобство имеет решающее значение, многие не знают , что код проверка , хорошо сформированность и семантическая корректность также важны. Очень тривиальные синтаксические ошибки HTML могут вызвать сбои визуализации даже в синтаксическом анализаторе надежного серверного движка MediaWiki Википедии , и их влияние на каждую из многочисленных браузерных платформ и автоматизированных инструментов на стороне пользователя непредсказуемо. Это не Всемирная паутина 1995 года; стандарты действительно имеют значение сегодня.
2. Обработка списков определений с точкой с запятой и двоеточием ( ;и :) в MediaWiki очень хрупкая , и ее нельзя использовать ни для каких глоссариев, кроме простейших, без проблем как для читателей, так и для редакторов. Вместо этого следует использовать настоящий HTML через простые шаблоны, описанные здесь (или чистый HTML в необычных случаях с особыми требованиями). Две большие проблемы с ;и :разметки в том , что даже одна пустая строка, для удобства чтения, между определениями приводит к искаженной разметки (не виден пользователю, но проблематичных для каждой точки # 1, выше), и определения нескольких абзацев может быть только правильно достигается таким образом, что их трудно редактировать. (См. Википедию: Руководство по стилю / Глоссарии / тестовые примеры ошибок DD.для множества технических деталей.) Обе эти проблемы устраняются за счет использования форматирования глоссария со структурой шаблона, представленного выше.
3. В списках определений wikimarkup пустая строка между полными записями (то есть между определением одной записи и термином следующей) для разделения записей дальше друг от друга - это нормально и не повлияет на семантику кода или вывода, но только если {{glossary}} и {{glossary end}}(или вставленные вручную <dl>...</dl>теги) окружают все записи (всего глоссария или раздела, если глоссарий разбит на разделы) как блок. Если они не указаны, MediaWiki будет рассматривать каждый термин как свой полный список определений и выводить беспорядочный код, который семантически бесполезен.

Фактический HTML-вывод шаблонных глоссариев [ править ]

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

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

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

{{глоссарий}}{{срок | термин A}}{{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. & # 160; & # 160; Начало первого определения. < p > Первое определение заключения. </ p > </дд > < дд > 2. & # 160; & # 160; Второе определение. </ dd > </ dl >

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

Визуализированный вывод:

срок А

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

срок B

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

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

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

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

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

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

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

Результат будет запущен вместе на выходе:

1. Первое определение начала. Первый вывод определения.

Такое поведение согласуется с тем, что MediWiki не может автоматически выделять абзацы внутри других встроенных блочных элементов, включая <blockquote>и <li>.

Заметки [ править ]

См. Также [ править ]

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

• Википедия: категории, списки и шаблоны навигации
• Википедия: Индексы
• Википедия: Контуры
• Википедия: статьи с индексным набором
• Википедия: Автономные списки
• Википедия: Хронология