Редактирование: Модуль:Sources/doc (раздел)

=== Внешние ===
Внешние функции принимают объекты типа [[mw:Extension:Scribunto/Lua reference manual#Frame%20object|фрейм]] и предназначены для вызова из других модулей или через функцию парсера {{Code|<nowiki>{{#invoke:}}</nowiki>}}.

''Прямое обращение к функциям модулей в статьях крайне нежелательно! Используйте для этих целей подходящие шаблоны.''

==== p.renderSource(''frame'') ====
Выдаёт вики-текст ссылки на заданный источник для подстановки внутрь сноски или списка литературы. См. шаблоны {{Tl|Source}} и {{Tl|ВД-Источник}}, использующие данную функцию''.'' Поддерживает следующие аргументы:

* {{Code|frame.args[1]}} — анонимный аргумент, задающий идентификатор объекта на викиданных, по которому нужно сгенерировать ссылку. Например, [[d:Q20750516|Q20750516]].
* {{Code|frame.args['ref']}} — задаёт метку ''ref'', которую в дальнейшем можно будет использовать в шаблонах типа {{Tl|Sfn}}.
* {{Code|frame.args['ref-year']}} — задаёт метку ''ref-year'', которая используется аналогично метке ''ref''.
* {{Code|frame.args['part']}} — дополнительный аргумент, позволяющий уточнить часть источника, на которую идёт ссылка (например, главу в книге).
* {{Code|frame.args['parturl']}} — ссылка, которую следует поставить на часть, описанную предыдущим аргументом.
* {{Code|frame.args['pages']}} — конкретные страницы в источнике, на которые ведётся ссылка.
* {{Code|frame.args['url']}} — позволяет явно указать, какую ссылку нужно будет проставить на источник.
* {{Code|frame.args['volume']}} — позволяет явно указать том источника, на который идёт ссылка.
* {{Code|frame.args['issue']}} — позволяет явно указать выпуск источника, на который идёт ссылка.

Пробрасывание большей части аргументов происходит в ''[[Модуль:Sources/utils|utils.copyArgsToSnaks]]''. Сам переданный фрейм сохраняется в ''p.currentFrame'' для дальнейшего использования, а на основе переданных аргументов функцией ''artificialSnaks'' создаются искусственные [[d:Wikidata:Glossary|снеки]], которые ссылаются на источник, указанный в {{Code|frame.args[1]}}, через свойства [[d:Property:P248|P248]] (''stated in'') и [[d:Property:P805|P805]] (''statement is subject of''). Затем данные передаются в ''renderReferenceImpl'' для дальнейшей обработки.

==== p.renderReference(''frame, currentEntity, reference'') ====
Выдаёт вики-текст готовой сноски на заданный источник. Поддерживает те же аргументы, что и ''p.renderSource'', кроме ''ref'' и ''ref-year''. См. шаблоны {{Tl|Source-ref}} и {{Tl|ВД-Сноска}}, использующие данную функцию''.'' Также используется в [[Модуль:Wikidata]] для отображения ссылок, указанных возле утверждений на викиданных. Если ''currentEntity'' и ''reference'' отсутствуют, создаются искусственные снеки с помощью функции ''artificialSnaks,'' после чего они передаются в ''renderReferenceImpl''. Если вики-текст для сноски был успешно сгенерирован, он оборачивается в тэг {{Code|<nowiki><ref></nowiki>}} с помощью [[mw:Extension:Scribunto/Lua reference manual#frame:extensionTag|frame: extensionTag]], при этом имя для сноски генерируется путём хеширования её вики-текста через [[mw:Extension:Scribunto/Lua reference manual#mw.hash.hashValue|mw.hash.hashValue]]. Статьи, с такими сносками помещаются в [[:Категория:Википедия:Статьи с источниками из Викиданных]].