Шаблон:Уничар

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон создает форматированное описание символа Юникода , которое будет использоваться внутри строки или иным образом вместе с обычным текстом.

The character {{unichar|a9|COPYRIGHT SIGN}} is about intellectual property.→
Символ U+00A9 © COPYRIGHT SIGN посвящен интеллектуальной собственности.

Применение

Шаблон {{unichar}} принимает в качестве входных данных значение шестнадцатеричного кода Юникода и, при необходимости, имя символа, например {{unichar|00A9|COPYRIGHT SIGN}}→ U+00A9 © ЗНАК АВТОРСКОГО ПРАВА .

Этот шаблон создает форматированное описание символа Юникода , которое будет использоваться вместе с обычным текстом. Он соответствует стандартному представлению символа в Юникоде, используя префикс «U+» для отображения шестнадцатеричной кодовой точки, за которым следует его глиф, а затем, при необходимости, имя символа, используя рекомендации по встроенному форматированию Юникод. В работающем тексте, таком как стандарт Unicode, Wikipedia или другие среды форматированного текста, имя символа предпочтительно отображается в СТИЛЬ МАЛЫМИ ЗАГЛАВНЫМИ БУКВАМИ . (Презентация, написанная заглавными буквами, в основном предназначена для среды с обычным текстом.)

Требуется шестнадцатеричное значение (например, A9), другой ввод не является обязательным. Фактический глиф отображается с использованием шрифта, содержащего этот символ. Для этого параметра можно установить что-то более конкретное, например шрифты, специфичные для языка или IPA . Чтобы отобразить глиф, символ шрифта можно заменить изображением. Можно создать вики-ссылку на статью о символе или наборе символов, а также ссылку на статью в Юникоде . Также можно добавить (в квадратных скобках) вычисленное десятичное значение, коды символов HTML и пользовательскую заметку.

Некоторым специальным кодам , например управляющим символам и пробелам, уделяется особое внимание. Они автоматически обнаруживаются подшаблоном unichar/gc.

Примеры

{{unichar|00A9}}→ U+00A9 ©
{{unichar|00A9|COPYRIGHT SIGN}}→ U+00A9 © ЗНАК АВТОРСКИХ ПРАВ
{{unichar|00A9|COPYRIGHT SIGN|nlink=Copyright symbol}}→ U+00A9 © ЗНАК АВТОРСКИХ ПРАВ
{{unichar|00A9|COPYRIGHT SIGN|nlink=Copyright symbol|note={{crossref|See also [[Copyleft]] symbol}}}}→ U+00A9 © ЗНАК АВТОРСКОГО ПРАВА ( см. также символ авторского лева )
{{unichar|00A9|COPYRIGHT SIGN|nlink=Copyright symbol|html=}}→ U+00A9 © ЗНАК АВТОРСКИХ ПРАВ ( ©, © )
{{unichar|00A9|nlink=Copyright symbol}}→ U+00A9 © – имя не добавлено для ссылки на
{{unichar|030D|COMBINING VERTICAL LINE ABOVE|cwith=◌}}→ U+030D ◌̍ ОБЪЕДИНЕНИЕ ВЕРТИКАЛЬНОЙ ЛИНИИ НАВЕРХУ – объединить с пунктирным кругом

Параметры

Пустой шаблон со всеми параметрами выглядит следующим образом:

{{уничар| <!-- шестнадцатеричное значение, кодовая точка (не добавляйте «U+») -->
| <!-- Имя в Юникоде -->
| улинк =
| изображение =
| cс =
| размер =
| использовать =
| использовать2 =
| нссылка =
| HTML =
| примечание =                     }}

Встроенная версия:

{{уничар| <!--шестнадцатеричное значение (не добавляйте "U+")--> | <!--Имя в Юникоде --> |ulink= |image= |cwith = |size= |use= |use2= |nlink= |html= |note= }}

Первый безымянный параметр или 1 = обязательный. Шестнадцатеричное значение кодовой точки, например 00A9.
Примечания : Параметр принимает входные данные в формате A9, a9а также 00A9в виде шестнадцатеричного значения. Десятичные значения не определяются как десятичные и дают неожиданные результаты (см. также § Возможные ошибки ниже) .
Второй безымянный параметр или 2 = необязательно. Имя символа в Юникоде. Оно указывается ЗАГЛАВНЫМИ БУКВАМИ, и шаблон повторно отображает его в ПРОПИСНЫХ БУКВАХ . Это имя может отличаться от названия соответствующей статьи в Википедии (см. ниже: nlink=).
nlink= Необязательная викиссылка. Название страницы Википедии, на которую будет сделана ссылка. Если используется, имя в Юникоде (второй параметр) содержит викиссылку на статью.

{{unichar|00A9|COPYRIGHT SIGN|nlink=Copyright symbol}}→ U+00A9 © ЗНАК АВТОРСКИХ ПРАВ

Примечания :

Имя страницы чувствительно к регистру, как и все страницы Википедии.
Опция " |nlink=<blank>" для ссылки на указанное имя устарела .
Здесь можно разместить страницу Викисловаря, используя синтаксис nlink=wikt:<target article>, который может подойти, если подходящей статьи в Википедии нет. Например:

{{unichar|204A|Tironian sign et|nlink=wikt:⁊}}→ U+204A ⁊ ЗНАК ТИРОНИАНА ET

ulink Необязательно. Создает викиссылку изУ+префикс. При использовании без имени (т. е |. пусто без значения) статья Unicode используется в качестве значения по умолчанию при выводе:[[Юникод|U+]]производство U+ . Это необходимо изменить только в том случае, если у вас есть причина ссылаться не на Unicode , например на статью о подмножестве символов Unicode.
html= Необязательно. Добавляет ссылку на символ HTML в текст, например в примечании в квадратных скобках. Если существует именованная ссылка на символ , например" ", это тоже добавлено. Вам не нужно добавлять значения вручную, просто добавьте |html=пробел.
использовать = Необязательно. Устанавливает шаблон подсказки шрифта для получения глифа, поскольку символ может отсутствовать в обычном шрифте браузера. По умолчанию — , другие варианты — и .{{unicode}}{{IPA}}{{lang}}{{script}}
use2= Необязательно. При настройке |use=langили следует использовать для установки языка (например , ) или сценария (например, |use=script) . Глиф по-прежнему может отображаться не так, как ожидалось, из-за эффектов браузера. Подробное описание см. в документации каждого шаблона.|use2=|use2=fr|use2=Cyrs
{{unichar|0485|COMBINING CYRILLIC DASIA PNEUMATA|cwith=|use=script|use2=Cyrs}}→ U+0485 ҅ СОЧЕТАНИЕ КИРИЛЛИКИ DASIA PNEUMATA
изображение = Необязательно. Позволяет использовать файл графического изображения для представления глифа; полностью переопределяет шрифт. Имя файла должно включать расширение (например,.svgили.png), но не префиксФайл:.
cwith= Необязательно. Полезно, когда символы Юникода объединяются . Использование |cwith=добавляет пробел перед символом, обеспечивая эффект объединения. Таким образом, при использовании с таким символом, как |cwith=a, этот символ будет сочетаться с буквой «а». В Юникоде общий глиф, используемый для размещения комбинированного символа, — это U+25CC ◌ ПУНКТИРНЫЙ КРУГ .
без |cwith=:
{{unichar|0485|COMBINING CYRILLIC DASIA PNEUMATA}}→ U+0485 ҅ СОЧЕТАНИЕ КИРИЛЛИКИ DASIA PNEUMATA
|cwith=без параметра:
{{unichar|0485|COMBINING CYRILLIC DASIA PNEUMATA|cwith=}}→ U+0485 ҅ СОЧЕТАНИЕ КИРИЛЛИКИ DASIA PNEUMATA
|cwith=с пунктирным кружком:
{{unichar|0485|COMBINING CYRILLIC DASIA PNEUMATA|cwith=◌}}→ U+0485 ◌҅ СОЧЕТАНИЕ КИРИЛЛИКИ DASIA PNEUMATA
- Обратите внимание, что это cwith=◌◌не дает желаемого результата, если намерением является отображение диакритического знака, состоящего из двух символов (например, в диапазоне от U+035C до U+0362): диакритический знак будет смещен. В таких случаях редакторам приходится вручную эмулировать вывод шаблона, поскольку правильная последовательность HTML — это «первый символ + сочетание диакритических знаков + второй символ». Так, например, чтобы показать объединение двойной тильды U+0360, напишите U+0360 ◌͠◌затем (через {{ small }}) COMBINING DOUBLE TILDE. В результате получается U+0360 ◌͠◌ ОБЪЕДИНЕНИЕ ДВОЙНОЙ ТИЛЬДЫ .
размер = Необязательно. Может использоваться для установки размера глифа . Значение по умолчанию:125%. Для шрифта принимаются все значения стиля размера шрифта CSS: 7px, 150%, 2em, larger.
{{unichar|0041|LATIN CAPITAL LETTER A|size=2em}}→ U+0041 A ЛАТИНСКАЯ ЗАГЛАВНАЯ БУКВА A
При использовании изображения (файла) вместо шрифта этот размер может принимать только размеры впикселейнравиться 12px. По умолчанию для изображений10 пикселей.

{{ уничар | А9 | ЗНАК АВТОРСКОГО ПРАВА | ulink = символы универсального набора символов | изображение =  | размер = 150% | nlink = Символ авторского права | примечание = Пример }}

Производит:

U+ 00A9 © ЗНАК АВТОРСКИХ ПРАВ (Пример)

Эффекты презентации

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

Отображение пробелов : Все пробелы (те, которые имеют общую категорию : Zs) отображаются на голубом фоне, чтобы показать их фактическое наличие и ширину: .U+00A0 NO-BREAK SPACE
Кстати, обычный пробел заменяется на &#00A0;(NBSP), чтобы вики-разметка не удаляла его как повторяющиеся пробелы.
Удаление символов форматирования : символы форматирования (те, которые относятся к общей категории : Cf, Zl и Zp) удаляются из вывода. По определению символы форматирования не имеют глифа. Удалив их, они не смогут оказать эффекта форматирования.
Исключение: показаны пять арабских символов Cf/форматирования U+0600..U+0603 и U+60DD. Хотя символы форматирования Cf обычно не имеют глифа, эти пять имеют его. Эти символы отображаются при внутреннем добавлении к категории «(видимый)».
Удаление пробелов : шаблон удаляет код форматирования и окружающие пробелы из входных данных. <Return> во вводе имени (возможно, непреднамеренное) нарушит ожидания встроенного поведения.
Отображение метки типа <control-0007> : Unicode указывает, что кодовая точка не имеет имени , если она является одним из следующих символов: управляющий символ, символ частного использования, суррогатный, неназначенная кодовая точка (зарезервированная) или неиспользуемый символ. -характер. Вместо этого на эти кодовые точки следует ссылаться с помощью «метки кодовой точки», например <private-use> или <private-use-E000>. В этой ситуации этот шаблон заменяет глиф этой меткой. Таким образом, правильное представление побеждает использование Unicode в соответствии с буквой закона.
Общая категория «Управление» = Cc: <control>или<control-0007>
Общая категория «Суррогат» = Cs: <surrogate>или<surrogate-D800>
«Частное использование»: общая категория=Co: <private-use>или<private-use-FFA0>
«Не символ» (за вычетом зарезервированных кодовых точек, см. ниже): General Category=Cn : <not-a-character>или<non-character><not-a-character-FFA0>

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

Примечание . Кодовую точку <зарезервировано> (неназначенную) еще невозможно обнаружить, поэтому она не отображается с этой меткой. Этим кодовым точкам также присвоена категория Cn.
(История <>-меток: имя вообще не может иметь <>-скобок. Эти правила предотвращают путаницу имени с фактическим управляющим символом. Поэтому не произойдет, чтобы при открытии страницы , содержащей Имя U+0007).

Возможные ошибки

Шаблон выдает сообщение об ошибке , когда |1=шестнадцатеричное значение (или первый безымянный параметр) отсутствует, пусто или недействительно.
{{unichar|00A9|RIGHT SINGLE QUOTATION MARK|nlink=}}→ U+00A9 © ПРАВАЯ ОДИНАРНАЯ КАВЫКА – цель вики-ссылки «ПРАВАЯ ОДИНАРНАЯ КАВЫКА» не является существующей статьей, хотя « Правая одинарная кавычка » существует.
Нешестнадцатеричный ввод, например 00G9, выдает ошибку (поскольку G или g не являются шестнадцатеричными).
Не добавляйте префикс U+ , как в U+00A9 . Это не будет признано.
Если шаблон показывает только номер кодовой точки, например2038 год, вы, вероятно, используете неправильный шаблон , вместо .{{unicode}}{{unichar}}
Глиф можно отменить и заменить на метку , например<control-0007>. Эти символы не имеют имени в Юникоде. Это |nlink=будет непосредственно к статье (вводится в форме типа |nlink=Bell signal). Пустое значение просто |не может работать для< этикетка - хххх >символы (вообще нет имени персонажа, которое можно было бы превратить в ссылку). Это вызывает ошибку.
Ввод десятичного значения, например, |1=98будет прочитан как шестнадцатеричное значение.0098. Шаблон не может определить, что вы намереваетесь войти . Предупреждение не выдается, и неправильный символ,98₁₀=62₁₆U+0098 ₁₆, будет показано ( не U + 0062).

Отслеживание

Категория:Страницы, использующие Unichar с неизвестными параметрами (29)

Технические примечания

Строка «unichar» используется только в англоязычной Википедии в качестве имени этого шаблона. Вне этого контекста оно не имеет никакого значения.

В шаблоне используются следующие подшаблоны:

{{ unichar/main }} Принимает все входные данные от {{unichar}}. Вызывает несколько подшаблонов для создания текстовых строк, а затем объединяет их вместе. Также проверяется ошибка нешестнадцатеричного ввода.
{{ unichar/ulink }} Создает конвейерную ссылку дляУ+префикс.
{{ unichar/gc }} Определяет общую категорию Юникода, если эта категория является специальной (например, для управляющих символов).
{{ unichar/glyph }} Для рендеринга глифа по шрифту. Accepts |image=, который переопределяет шрифт. Также обрабатывает |use=, |use2=, |size=, |cwith=.
{{ unichar/name }} Создает отформатированное имя символа, записанное строчными буквами . Принимает команду для создания вики-ссылки на статью. Если общая категория (gc) является специальной, имя изменится на|nlink=< этикетка - хххх >.
{{ unichar/notes }} Показывает примечания в круглых скобках (круглых скобках):HTML(от |html=именованного объекта, например если это существует, используя ); и свободный текст .{{numcr2namecr}}|note=
Использование основного шаблона в качестве функции простого ввода позволяет выполнить мало вычислений (на самом деле только два hex2dec) и позволяет добавлять значения по умолчанию не слишком глубоко в шаблоны.
Значение <#salted#>используется внутри для передачи через неопределенный входной параметр. Это значение является правильным, когда речь идет об имени в Юникоде, поскольку оно не может содержать символы <##>, поэтому подходящее слово — «соленый» (означающий «неограниченный»). Для удобства обслуживания кода он используется в различных местах кода.

Именованные объекты для U+22C1 ⋁ N-АРНОЕ ЛОГИЧЕСКОЕ ИЛИ : → ⋁, ⋁, ⋁ {{#invoke:LoadData|Numcr2namecr|0x22C1}}

Проблемы

Неназначенные кодовые точки, которые должны быть помечены как <зарезервированы>, не могут быть обнаружены.
При использовании |use-script=необходимо |use2=использовать строчные буквы (например, 0485, Cyrs или cyrs) ^{[ необходимы пояснения ]}
При использовании одного из знаков форматирования RTL его эффект может выйти за пределы шаблона (текст, следующий за шаблоном, также будет отображаться справа налево). Как и сейчас, для этого требуется дополнительный код.

Таблицы кодов

Данные шаблона

Это TemplateData для этого шаблона, используемого TemplateWizard, VisualEditor и другими инструментами. См. ежемесячный отчет об использовании параметров для Template:Unichar в статьях, основанных на его TemplateData.

Данные шаблона для Unichar

Смотрите также

В этом шаблоне используется: Module:Numcr2namecr -- « ссылка на именованный символ ». Возвращает именованный объект для преобразования десятичной дроби в мнемонику:

{{ Эмодзи }}

Внешние исследовательские ссылки

Полезные ссылки для изучения символов Юникода:

Диаграммы Unicode.org в формате PDF, показывающие шестнадцатеричные значения U+.
Поиск в Fileformat.info для поиска по имени (полному или частичному), по шестнадцатеричному или десятичному значению U+ или по символу шрифта (скопируйте и вставьте его). Дополнительная информация предоставляется для каждого персонажа. Только один персонаж.
branah.com — это многосимвольный конвертер Юникода.
Обзор свойств Юникода, например запятая U+002C: [2]

Вышеупомянутая документация включена из Template :Unichar/doc . ( изменить | история ) Редакторы могут экспериментировать на страницах песочницы ( edit | diff) и тестовых примеров ( edit )
этого шаблона . Добавьте категории на подстраницу /doc . Подстраницы этого шаблона .