Module:Episode

Documentation module[créer]

local p = {}

-- Load the centralized Episode Index
local Index = require("Module:Episode/index")

------------------------------------------------------------
-- Internal helper: retrieve episode entry from key
------------------------------------------------------------
local function getEntry(frame)
    local key = frame.args[1]
    if not key then
        return nil
    end
    return Index.get(key)
end

------------------------------------------------------------
-- Internal helper: build a link using the episode namespace
-- If namespace is empty (movies), omit it.
------------------------------------------------------------
local function buildEpisodeLink(ep, label)
    local title = label or frame:preprocess(ep.title_fr) or ep.page_title

    if ep.namespace == "" or ep.namespace == nil then
        -- Movies and telefilms: no namespace
        return string.format("[[%s|%s]]", ep.page_title, title)
    else
        -- Regular episodes: use namespace
        return string.format("[[%s:%s|%s]]", ep.namespace, ep.page_title, title)
    end
end

------------------------------------------------------------
-- Function 1: Get full episode link (default namespace)
------------------------------------------------------------
function p.getEpisode(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end

    return buildEpisodeLink(ep)
end

------------------------------------------------------------
-- Function 2: Force namespace to "Crédits:"
------------------------------------------------------------
function p.getCreditsLink(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end
    return string.format("[[Crédits:%s|%s]]", ep.page_title, frame:preprocess(ep.title_fr))
end

------------------------------------------------------------
-- Function 3: Force namespace to "Retranscription:"
------------------------------------------------------------
function p.getTranscriptLink(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end
    return string.format("[[Retranscription:%s|%s]]", ep.page_title, frame:preprocess(ep.title_fr))
end

------------------------------------------------------------
-- Function 4: Force namespace to "Citations:"
------------------------------------------------------------
function p.getQuotesLink(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end
    return string.format("[[Citations:%s|%s]]", ep.page_title, frame:preprocess(ep.title_fr))
end

------------------------------------------------------------
-- Function 5: Force namespace to "Catégorie:Images de ..."
-- Leading colon prevents categorization when used in articles.
------------------------------------------------------------
function p.getImagesLink(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end
    return string.format("[[:Catégorie:Images de %s|%s]]", ep.page_title, frame:preprocess(ep.title_fr))
end

------------------------------------------------------------
-- Function 6: Retrieve only the page title (no namespace)
------------------------------------------------------------
function p.getEpisodeLink(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end
    return ep.page_title
end

------------------------------------------------------------
-- Function 7: Retrieve full link target (namespace + title)
-- Example: "Épisode:Enfants des dieux"
-- Movies return only "Enfants des dieux"
------------------------------------------------------------
function p.getEpisodeFullLink(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end

    if ep.namespace == "" or ep.namespace == nil then
        return ep.page_title
    else
        return string.format("%s:%s", ep.namespace, ep.page_title)
    end
end

------------------------------------------------------------
-- Function 8: Retrieve only the French title
------------------------------------------------------------
function p.getEpisodeTitle(frame)
    local ep = getEntry(frame)
    if not ep then
        return "Épisode ou film non référencé"
    end
    return frame:preprocess(ep.title_fr)
end

return p