Module:bases

Ce module contient des fonctions simples mais très utiles utilisables dans les autres modules.

is_elidable( texte ): Renvoie "true" si le mot précédent peut être élidé (devant une voyelle, en français).
is_locution( texte ): Renvoie "true" si le terme donné est une locution (s'il contient une espace).
ucfirst( texte ): Renvoie le texte avec la première lettre mise en majuscule (selon la norme du français).
lcfirst( texte ): Renvoie le texte avec la première lettre mise en minuscule (selon la norme du français).
uc( texte ): Renvoie le texte en majuscule (selon la norme du français).
lc( texte ): Renvoie le texte en minuscule (selon la norme du français).
fait_categorie( texte, clef, [écrite] ): Renvoie le texte d'une catégorie nommée texte, avec éventuellement la clé de tri clef. Un troisième paramètre permet d'afficher la catégorie (avec :Catégorie), plutôt que de catégoriser Modèle:attention Pas d'accent !
fait_categorie_contenu( texte, clef, [écrite] ): Comme fait_categorie mais seulement dans une page de contenu : espace principal, annexe ou thésaurus
page_existe(titre): teste l’existence d’une page.
tableau_entete(titres): crée l'entête d'un tableau wiki triable (avec les titres en paramètre)
tableau_ligne(liste): écrit une ligne avec les éléments donnés
tableau_fin(): termine le tableau
exposant(): met en exposant
balise_langue(txt, code): balisage correctement un texte en langue étrangère
trim_parametres(args): enlève les espaces de part et d'autres d'un tableau de paramètres (args). Renvoie la liste modifiée.

Documentation du Module:bases : v · d · m · h.

local b = {}

-- Doit-on faire une élision devant ce mot ?
function b.is_elidable(mot)
    if (mw.ustring.match( mot, "^[aàâäeéèêëiîïoôöuùûü]" ) ~= nil) then
        return true
    else
        return false
    end
end

-- S'agit-il d'une locution ?
function b.is_locution(mot)
    if mot==nil then return nil end
    if (mw.ustring.find(mot, ". .") ~= nil) then
        return true
    else
        return false
    end
end

function b.page_existe(titre)
    if titre == nil then return nil end
    -- On crée un objet "mw.title" avec le titre de la page dont on cherche à vérifier l'existence
    local article = mw.title.new(titre)
    return article.exists
end

-- Renvoie le texte avec la première lettre en majuscule (si le texte est en français)
function b.ucfirst(texte)
    if (texte == nil) then return texte end
    locale = mw.language.new('fr')
    return locale:ucfirst(texte)
end
-- Renvoie le texte avec la première lettre en minuscule (si le texte est en français)
function b.lcfirst(texte)
    if (texte == nil) then return texte end
    locale = mw.language.new('fr')
    return locale:lcfirst(texte)
end
-- Renvoie le texte en majuscule (si le texte est en français)
function b.uc(texte)
    if (texte == nil) then return texte end
    locale = mw.language.new('fr')
    return locale:uc(texte)
end
-- Renvoie le texte en minuscule (si le texte est en français)
function b.lc(texte)
    if (texte == nil) then return texte end
    locale = mw.language.new('fr')
    return locale:lc(texte)
end

-- Renvoie vrai si on est dans une page de contenu (principal, annexe, thésaurus)
function b.page_de_contenu()
    local ns = mw.title.getCurrentTitle().namespace
    
    -- 0 = normal, 100 = Annexe, 106 = Thésaurus
    if ns == 0 or ns == 100 or ns == 106 then
        return true
    else
        return false
    end
end

-- Renvoie une catégorie bien formée
function b.fait_categorie(texte, clef, ecrite)
    local cat = ecrite and ':Catégorie:' or 'Catégorie:'
    
    if (texte ~= nil) then
        if (clef ~= nil and clef ~= '') then
            return '[[' .. cat .. texte .. '|' .. clef .. ']]'
        else
            return '[[' .. cat .. texte .. ']]'
        end
    else
        return ''
    end
end

-- Renvoie une catégorie bien formée, si elle est dans un espace principal: normal, annexe, thésaurus
function b.fait_categorie_contenu(texte, clef, ecrite)
    if b.page_de_contenu() then
        return b.fait_categorie(texte, clef, ecrite) or ''
    else
        return ''
    end
end

-- Crée l'entête d'un tableau wiki triable (avec les titres en paramètre)
function b.tableau_entete(titres)
    local entete = '{| class="wikitable sortable"\r\n'
    entete = entete .. '|-\r\n!' .. table.concat(titres, ' !! ')
    return entete
end

-- Crée une ligne du tableau wiki
function b.tableau_ligne(elements)
    local ligne = '|-\r\n|' .. table.concat(elements, ' || ')
    return ligne
end

-- Crée la fin d'un tableau
function b.tableau_fin()
    return "|}\r\n"
end

-- Texte en exposant
function b.exposant(txt)
    return '<sup style="font-size:83%;line-height:1">'..txt..'</sup>'
end

-- balise un texte écrit en langue étrangère
function b.balise_langue(txt, code)
	return '<span lang="' .. code .. '">' .. txt .. '</span>'
end

-- Enlève les espaces de part et d'autre de tous les paramètres fournis à arg
function b.trim_parametres(args)
    if args==nil then return nil end
    
    local trim_args = {}
    for k, v in pairs(args) do
        trim_args[k] = mw.text.trim(v)
    end
    return trim_args
end

return b