Module:exemples
Ce module définit une fonction format_example qui permet de formater un exemple.
format_example(texte, transcription, sens, source, en-tête, code langue)- Formate un exemple.
texte(contenu) : Le texte de l’exemple, sans l’entourer de''.transcription(contenu, optionnel) : La transcription du texte si celui-ci n’est pas écrit avec l’alphabet latin.sens(contenu, optionnel) : La traduction du texte si celui-ci n’est pas en français.source(contenu, optionnel) : La source du texte, sans le modèle {{source}}.lien(contenu, optionnel) : Le lien vers la source. Nécessite le paramètresource.tête(chaine, optionnel) : La puce à ajouter au début de la traduction (par défaut#*). Utile dans le cas où le modèle est appelé dans une sous-définition (il pourra alors prendre la valeur##*, par exemple).code langue(chaine) : Le code langue du texte de l’exemple. Les codes supplémentaires du type de zh-Hans et zh-Hant sont aussi supportés.
La documentation de ce module est générée par le modèle {{Documentation module}}.
Elle est incluse depuis la page Module:exemples/Documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer).
Voir les statistiques d'appel depuis le wikicode sur l'outil wstat et les appels depuis d'autres modules.
local m_params = require("Module:paramètres")
local m_bases = require("Module:bases")
local m_langs = require("Module:langues")
local m_unicode = require("Module:données Unicode")
local p = {}
--- Formats an example.
--- @param text string The quoted text.
--- @param transcription string The text’s transcription if it uses another script than Latin or is uses an archaic orthography.
--- @param meaning string The translation in French.
--- @param source string The quote’s source (without {{source}} template).
--- @param link string The link to the source (requires source parameter).
--- @param heading string The characters to add before the translation (usually #*).
--- @param lang string The quote’s language code.
--- @param scriptLang string The language code for the script.
--- @param frame table The frame object for expanding templates.
--- @return string The wikicode.
local function _formatExample(text, transcription, meaning, source, link, heading, lang, scriptLang, disableTranslation, frame)
if not text then
return mw.ustring.format(
[=[<span class="example">''[[Aide:Exemples|Exemple d’utilisation]] manquant.'' <span class="plainlinks stubedit">([%s Ajouter])</span><!--
--><bdi lang="%s" style="display: none"><!-- Balise de marquage pour le gadget [[MediaWiki:Gadget-wikt.add-examples]], ne pas retirer ! --></bdi></span>]=],
mw.title.getCurrentTitle():fullUrl({ action = "edit" }), lang
) .. m_bases.fait_categorie_contenu(mw.ustring.format("Wiktionnaire:Exemples manquants en %s", m_langs.get_nom(lang)))
end
local italics = m_unicode.shouldItalicize(text) and "''" or ""
local quoteTagOpen = link and mw.ustring.format('<q cite="%s">', mw.ustring.gsub(link, '"', '%22')) or '<q>'
local wikicode = quoteTagOpen .. m_bases.balise_langue(italics .. m_unicode.setWritingDirection(text) .. italics, scriptLang) .. '</q>'
if source then
wikicode = wikicode .. " " .. frame:expandTemplate { title = "source", args = { source, lien = link } }
end
wikicode = mw.ustring.format('<span class="example">%s</span>', wikicode)
if transcription then
wikicode = wikicode .. "<br>" .. m_bases.balise_langue("''" .. transcription .. "''", scriptLang .. "-Latn")
end
if disableTranslation then
wikicode = wikicode .. m_bases.fait_categorie_contenu(
mw.ustring.format("Exemples en %s avec traduction désactivée", m_langs.get_nom(lang)))
else
local translation
if meaning then
translation = meaning
elseif lang ~= "fr" then
translation = "''La traduction en français de l’[[Aide:Exemples|exemple]] manque.'' "
translation = translation .. mw.ustring.format("<span class=\"plainlinks stubedit\">([%s%s Ajouter])</span>", mw.site.server, mw.title.getCurrentTitle():localUrl("action=edit"))
translation = translation .. mw.ustring.format("[[Catégorie:Exemples en %s à traduire]]", m_langs.get_nom(lang))
end
if translation then
wikicode = wikicode .. mw.ustring.format("\n%s: ", heading) .. translation
end
end
return wikicode .. m_bases.fait_categorie_contenu("Exemples en " .. m_langs.get_nom(lang))
end
--- Formats an example. Function to call from templates.
--- Throws an error if the language is missing or undefined.
--- Parameters:
--- parent frame.args[1] (string): The quoted text.
--- parent frame.args[2]/frame.args["sens"] (string): The translation in French.
--- parent frame.args[3]/frame.args["tr"] (string): The text’s transcription if it uses another script than Latin.
--- parent frame.args["source"] (string): The quote’s source (without {{source}} template).
--- parent frame.args["lien"] (string): The link to the source.
--- parent frame.args["tête"] (string): The characters to add before the translation (usually #*).
--- parent frame.args["lang"] (string): The quote’s language code.
--- @return string The wikicode.
function p.formatExample(frame)
local parentFrame = frame:getParent()
local args, success = m_params.process(parentFrame.args, {
[1] = {},
["sens"] = {},
[2] = { alias_of = "sens" },
["tr"] = {},
[3] = { alias_of = "tr" },
["source"] = {},
["lien"] = {},
["tête"] = { default = "#*" },
["lang"] = { required = true, checker = function(lang)
return m_langs.specialCodes[lang] ~= nil or m_langs.get_nom(lang) ~= nil
end },
["pas-trad"] = { type = m_params.BOOLEAN, default = false }
}, true)
if success then
local scriptLang = args["lang"]
local lang = m_langs.specialCodes[args["lang"]] or args["lang"]
return _formatExample(args[1], args["tr"], args["sens"], args["source"], args["lien"], args["tête"], lang, scriptLang, args["pas-trad"], parentFrame)
else
if (args[2] == m_params.MISSING_PARAM or args[2] == m_params.EMPTY_PARAM) and args[1] == "lang" then
return "<span style='color: red; font-weight: bold;'>Langue de l’exemple manquante !</span>[[Catégorie:Appels au modèle exemple sans langue précisée]]"
end
error(args[3])
end
end
return p