Модуль:Sources/doc
Это страница документации Модуль:Sources.
 | Внимание! Это один из самых используемых модулей. |
 | Этот модуль относится к критическим. У него очень много включений или он используется с подстановкой. Из-за опасности вандализма или ошибочного редактирования он был защищён. |
 | Прежде чем вносить какие-либо изменения в этот модуль, просьба оттестировать их в /песочнице и проверить результат на странице с /контрольными примерами. |
Принцип работы модуля[править код]
Данный модуль генерирует текст, используемый в сносках, ссылающихся на элемент викиданных.
Тесты [ править ][править код]
6 тестов из 33 провалено.
| Тест | Ожидаемое значение | Фактическое значение | |
|---|---|---|---|
|
{{#invoke:Sources | testPersonNameToAuthorName | Ломоносов, Михаил Васильевич }} | Ломоносов М. В. | Ломоносов М. В. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Ломоносов, Михаил }} | Ломоносов М. | Ломоносов М. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Михаил Васильевич Ломоносов }} | Ломоносов М. В. | Ломоносов М. В. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Михаил Ломоносов }} | Ломоносов М. | Ломоносов М. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | М. В. Ломоносов }} | Ломоносов М. В. | Ломоносов М. В. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | М. Ломоносов }} | Ломоносов М. | Ломоносов М. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Ломоносов М. В. }} | Ломоносов М. В. | Ломоносов М. В. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Ломоносов М. }} | Ломоносов М. | Ломоносов М. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Топчибашев, Мустафа Агабек оглы }} | Топчибашев М. А. | Топчибашев М. А. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Гельмонт, Ян Баптиста ван }} | ван Гельмонт Я. Б. | ван Гельмонт Я. Б. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Гельмонт, Ян ван }} | ван Гельмонт Я. | ван Гельмонт Я. |
|
|
{{#invoke:Sources | testPersonNameToAuthorName | Jan Baptista van Helmont }} | van Helmont J. B. | van Helmont J. B. |
|
{{#invoke:Sources | testPersonNameToAuthorName | Jan van Helmont }} | van Helmont J. | Helmont J. v. |
| Тест | Ожидаемое значение | Фактическое значение | |
|---|---|---|---|
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Ломоносов, Михаил Васильевич }} | М. В. Ломоносов | М. В. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Ломоносов, Михаил }} | М. Ломоносов | М. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Михаил Васильевич Ломоносов }} | М. В. Ломоносов | М. В. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Михаил Ломоносов }} | М. Ломоносов | М. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | М. В. Ломоносов }} | М. В. Ломоносов | М. В. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | М. Ломоносов }} | М. Ломоносов | М. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Ломоносов М. В. }} | М. В. Ломоносов | М. В. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Ломоносов М. }} | М. Ломоносов | М. Ломоносов |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Топчибашев, Мустафа Агабек оглы }} | М. А. Топчибашев | М. А. Топчибашев |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Гельмонт, Ян Баптиста ван }} | Я. Б. ван Гельмонт | Я. Б. ван Гельмонт |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Гельмонт, Ян ван }} | Я. ван Гельмонт | Я. ван Гельмонт |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Jan Baptista van Helmont }} | J. B. van Helmont | J. B. van Helmont |
|
|
{{#invoke:Sources | testPersonNameToResponsibleName | Jan van Helmont }} | J. van Helmont | J. v. Helmont |
| Тест | Ожидаемое значение | Фактическое значение | |
|---|---|---|---|
|
|
{{source | Q21725116}} | Menezes A. J., Oorschot P. v., Vanstone S. A. Handbook of Applied Cryptography (англ.) — CRC Press, 1996. — 816 p. — (Discrete Mathematics and Its Applications) — ISBN 978-0-8493-8523-0 | Menezes A. J., Oorschot P. v., Vanstone S. A. Handbook of Applied Cryptography (англ.) — CRC Press, 1996. — 816 p. — (Discrete Mathematics and Its Applications) — ISBN 978-0-8493-8523-0 |
Служебные подмодули[править код]
Используемые параметры Викиданных[править код]
| Свойство | Комментарий |
|---|---|
| автор (P50) | |
| имя автора (строка) (P2093) | |
| язык произведения или названия (P407) | |
| язык оригинала фильма или телешоу (P364) | |
| раздел, стих или параграф (P958) | используется для указания названия статьи в энциклопедии |
| название (P1476) | если требуется переопределить название из метки элемента |
| подзаголовок (P1680) | |
| доступен по URL (P953) | |
| архивный URL (P1065) | |
| URL-ссылка на источник (P854) | |
| опубликовано в (P1433) | |
| номер издания (P393) | |
| издатель (P123) | |
| место публикации (P291) | |
| редактор (P98) | |
| страницы (P304) | |
| количество страниц (P1104) | |
| том (P478) | |
| выпуск (P433) | |
| дата основания / создания / возникновения (P571) | |
| дата публикации (P577) | |
| ISBN-13 (P212) | |
| ISBN-10 (P957) | |
| ISSN (P236) | |
| порядковый номер (P1545) | |
| код arXiv (P818) | |
| JSTOR (P888) |
Функции[править код]
Внешние[править код]
Внешние функции принимают объекты типа фрейм и предназначены для вызова из других модулей или через функцию парсера {{#invoke:}}.
Прямое обращение к функциям модулей в статьях крайне нежелательно! Используйте для этих целей подходящие шаблоны.
p.renderSource(frame)[править код]
Выдаёт вики-текст ссылки на заданный источник для подстановки внутрь сноски или списка литературы. См. шаблоны {{source}} и {{ВД-Источник}}, использующие данную функцию. Поддерживает следующие аргументы:
frame.args[1]— анонимный аргумент, задающий идентификатор объекта на викиданных, по которому нужно сгенерировать ссылку. Например, Q20750516.frame.args['ref']— задаёт метку ref, которую в дальнейшем можно будет использовать в шаблонах типа {{sfn}}.frame.args['ref-year']— задаёт метку ref-year, которая используется аналогично метке ref.frame.args['part']— дополнительный аргумент, позволяющий уточнить часть источника, на которую идёт ссылка (например, главу в книге).frame.args['parturl']— ссылка, которую следует поставить на часть, описанную предыдущим аргументом.frame.args['pages']— конкретные страницы в источнике, на которые ведётся ссылка.frame.args['url']— позволяет явно указать, какую ссылку нужно будет проставить на источник.frame.args['volume']— позволяет явно указать том источника, на который идёт ссылка.frame.args['issue']— позволяет явно указать выпуск источника, на который идёт ссылка.
Пробрасывание большей части аргументов происходит в utils.copyArgsToSnaks. Сам переданный фрейм сохраняется в p.currentFrame для дальнейшего использования, а на основе переданных аргументов функцией artificialSnaks создаются искусственные снеки, которые ссылаются на источник, указанный в frame.args[1], через свойства P248 (stated in) и P805 (statement is subject of). Затем данные передаются в renderReferenceImpl для дальнейшей обработки.
p.renderReference(frame, currentEntity, reference)[править код]
Выдаёт вики-текст готовой сноски на заданный источник. Поддерживает те же аргументы, что и p.renderSource, кроме ref и ref-year. См. шаблоны {{source-ref}} и {{ВД-Сноска}}, использующие данную функцию. Также используется в Модуль:Wikidata для отображения ссылок, указанных возле утверждений на викиданных. Если currentEntity и reference отсутствуют, создаются искусственные снеки с помощью функции artificialSnaks, после чего они передаются в renderReferenceImpl. Если вики-текст для сноски был успешно сгенерирован, он оборачивается в тэг <ref> с помощью frame: extensionTag, при этом имя для сноски генерируется путём хеширования её вики-текста через mw.hash.hashValue. Статьи, с такими сносками помещаются в Категория:Википедия:Статьи с источниками из Викиданных.
Внутренние[править код]
tokenizeName(fullName)[править код]
Преобразует полное имя в пару {фамилии через пробел, инициалы имён через пробел}. Реализована в виде разбора случаев, которые можно встретить на викиданных:
- Фамилия, Имя
- Фамилия, Имя Имя
- Фамилия Фамилия, Имя
- Имя Имя оглы Фамилия
- Имя Имя де Фамилия
- Имя … Имя Фамилия (хотя бы одно и не более четырёх единичных имён)
Здесь имя, в отличие от фамилии, может являться инициалом. Если ни один из форматов выше не выполнен, возвращает полное имя без изменений.
personNameToAuthorName(fullName)[править код]
Преобразует полное имя в формат Фамилия И. О. с помощью tokenizeName.
personNameToResponsibleName(fullName)[править код]
Преобразует полное имя в формат И. О. Фамилия с помощью tokenizeName.
getPeopleAsWikitext(context, value, options)[править код]
Преобразует список имён value в викитекст в соответствии со списком опций options. В опциях должны быть проставлены следующие поля:
- separator — разделитель в списке;
- conjunction — разделитель перед последним элементом списка;
- format — функция, преобразующая имена к некоторому нормализованному виду (например, personNameToAuthorName);
- nolinks — логическое значение, должно быть истинным если проставление ссылок нежелательно;
- preferids — логическое значение, должно быть истинным если нужно вернуть id с викиданных, а не имена.
Если в списке больше maxAuthors (на текущий момент 10) людей, заменяет остальных на и др. или его аналоги (если в контексте указан язык, то используется i18nEtAl[context.lang], иначе используется i18nEtAlDefault).
appendProperty(result, context, src, conjunctor, property, url)[править код]
Приписывает src[property] к result, разделяя их строкой, записанной в conjunctor. Если возможно, оформляет его ссылкой на src[url].
generateAuthorLinks(context, src)[править код]
Возвращает список авторов src.author, оформленный через getPeopleAsWikitext и обрамлённый в <i class="wef_low_priority_links"></i>.
appendTitle(result, context, src)[править код]
Дописывает к result строку src.part // src.title либо только src.title если src.part не указан. Если возможно, обрамляет src.part (или src.title если src.part не указан) в src.url.
appendLanguage(result, context, src)[править код]
Если context.lang отличается от i18nDefaultLanguage (в нашем разделе русский), то указание об этом приписывается к result с помощью Модуль:Languages в формате {{ref-lang}}.
appendSubtitle(result, context, src)[править код]
Дописывает к result строку : src.subtitle если src.subtitle определён.
appendOriginalTitle(result, context, src)[править код]
Дописывает к result строку = src.originaltitle если src.originaltitle определён.
appendPublication(result, context, src)[править код]
Дописывает к result строку // src.publication: src.publication.subtitle если определён src.publication.subtitle, либо // src.publication если определён только src.publication.
appendEditor(result, context, src)[править код]
Дописывает к result строку / prefix src.editor если определён src.editor, где prefix определяется по context.lang (по умолчанию, под ред.).
appendEdition(result, context, src)[править код]
Дописывает к result строку — src.edition если src.edition определён.
appendPublicationData(result, context, src)[править код]
Добавляет к result строку вида — src.place: src.publisher, src.year. если хотя бы один из указанных параметров определён. Неуказанная часть опускается вместе с соответствующей пунктуацией. В частности, двоеточие ставится только если указано src.place и хотя бы что-то из src.publisher и src.year, запятая ставится только если указаны и src.publisher, и src.year. Тире и точка ставятся если указан хотя бы один из параметров.
appendVolumeAndIssue(result, context, src)[править код]
Добавляет к result строку виду — letter_vol src.volume, letter_iss src.issue. если хотя бы один из указанных параметров определён. Запятая ставится если указаны оба параметра. letter_vol и letter_iss определяются по context.lang (например, Т. и вып. для русских текстов, Vol. и Iss. для английских).
appendPages(result, context, src)[править код]
Добавляет к result строку вида — letter src.pages. если src.pages определён, при этом в качестве разделителя в src.pages, если это диапозон страниц, используется символ «—», а letter определяется исходя из context.lang (например, P. для английского и С. для русского).
appendNumberOfPages(result, context, src)[править код]
Добавляет к result строку вида — src.numberOfPages letter если src.numberOfPages определён. При этом letter определяется из context.lang (p. для английского и с. для русского).
appendBookSeries(result, context, src)[править код]
Добавляет к result строку вида — (src.bookSeries; letter_vol src.bookSeriesVolume, letter_iss src.bookSeriesIssue) если src.bookSeries определено. Точка с запятой ставится только если определено src.bookSeriesVolume или src.bookSeriesIssue, запятая ставится если определены оба параметра. letter_vol и letter_iss определяются из context.lang, аналогично тому, как это делается в appendVolumeAndIssue.
appendBookSeries(result, context, src)[править код]
Добавляет к result информацию из src.tirage если тот определён. Формат определяется из context.lang, для английского это — ed. size: src.tirage, а для русского — src.tirage экз..
appendIdentifiers(result, context, src)[править код]
Добавляет к result идентификаторы ISBN, ISSN, DOI, PMID и arXiv если те определены. Идентификаторы приписываются через тире, более точный формат определён в таблицах options_commas, options_issn, options_doi, options_pmid и options_arxiv.
appendSourceId(result, context, src)[править код]
Оборачивает result в <span class="wikidata_cite citetype" data-entity-id="src.sourceId"></span>, где citetyle это src.type если это поле определено и citetype_unknown в противном случае.
appendAccessDate(result, context, src)[править код]
Добавляет к result строку виду <small>Проверено dd month yyyy.</small>, где dd, month и yyyy берутся из src.accessdate если данное поле определено.
populateUrl(context, src)[править код]
Если src.url не определено, но src.sourceId известен, пытается присвоить в src.url ссылку на викитеку.
populateYear(src)[править код]
Если src.year не определён, пытается заполнить его из src.dateOfPublication и src.dateOfCreation.
populateTitle(src)[править код]
Если src.title не определён, пытается присвоить ему src.url, если и это не получается, то присваивает ''(unspecified title)''.
renderSource(context, src)[править код]
Внутренняя функция, генерирующая текст, который будет отображаться в сноске. Действует следующим образом:
- Записывает src.lang в context.lang (или i18nDefaultLanguage если src.lang записать не получилось).
- Вызывает populateUrl, populateTitle и populateYear.
- Заводит переменную result, изначально равную generateAuthorLinks(context, src).
- .Последовательно применяет к result функции appendTitle—appendAccessDate, при этом блок appendEditor—appendAccessDate дополнительно обрамляется в
<span class="wef_low_priority_links"></span>