Модуль:Карточка

ХӀокху модулах лаьцна хааман Модуль:Карточка/doc агӀо кхолла мега

--
-- Модуль для реализации шаблона {{Карточка}}
--

local p = {}

local HtmlBuilder = require('Module:HtmlBuilder')

local args = {}
local origArgs
local argsAliases = {}
local root

local function union(t1, t2)
    -- Возвращает объединение значений двух таблиц в виде последовательности.
    local vals = {}
    for k, v in pairs(t1) do
        vals[v] = true
    end
    for k, v in pairs(t2) do
        vals[v] = true
    end
    local ret = {}
    for k, v in pairs(vals) do
        table.insert(ret, k)
    end
    return ret
end

local function getArgNums(prefix)
    -- Возвращает таблицу индексов существующих полей с заданным префиксом,
    -- например, для префикса 'текст' и установленных 'текст1', 'текст2' и
    -- 'текст5' возвращает {1, 2, 5}.
    local nums = {}
    for k, v in pairs(args) do
        local num = tostring(k):match('^' .. prefix .. '([1-9]%d*)$')
        if num then table.insert(nums, tonumber(num)) end
    end
    table.sort(nums)
    return nums
end

local function addRow(rowArgs)
    -- Карточкин тӀетуху могӀа (корта йа билгало/йоза).
    if rowArgs.header then
        root
            .tag('tr')
                .addClass(rowArgs.rowclass)
                .attr('id', rowArgs.rowid)
                .tag('th')
                    .attr('colspan', 2)
                    .attr('id', rowArgs.headerid)
                    .addClass(rowArgs.class)
                    .addClass(args['коьртанийн_тоба'])
                    .css('text-align', 'center')
                    .cssText(args['коьртанийн_хатӀ'])
                    .wikitext(rowArgs.header)
    elseif rowArgs.data then
        local row = root.tag('tr')
        row.addClass(rowArgs.rowclass)
        row.attr('id', rowArgs.rowid)
        if rowArgs.label then
            row
                .tag('th')
                    .attr('scope', 'row')
                    .attr('id', rowArgs.labelid)
                    .cssText(args['билгалонийн_хатӀ'])
                    .wikitext(rowArgs.label)
                    .done()
        end

        local dataCell = row.tag('td')
        if not rowArgs.label then 
            dataCell
                .attr('colspan', 2)
                .css('text-align', 'center') 
        end
        dataCell
            .attr('id', rowArgs.dataid)
            .addClass(rowArgs.class)
            .cssText(rowArgs.datastyle)
            .newline()
            .wikitext(rowArgs.data)
    end
end

local function renderTitle()
    if not args['название'] then return end

    root
        .tag('caption')
            .addClass(args['цӀеран_тоба'])
            .cssText(args['цӀеран_хатӀ'])
            .wikitext(args['название'])
end

local function renderAboveRow()
    if not args['лакхахь'] then return end

    root
        .tag('tr')
            .tag('th')
                .attr('colspan', 2)
                .addClass(args['лакхахь_тоба'])
                .css('text-align', 'center')
                .css('font-size', '125%')
                .css('font-weight', 'bold')
                .cssText(args['лакхахь_хатӀ'])
                .wikitext(args['лакхахь'])
end

local function renderAbove2Row()
    if not args['лакхахь2'] then return end

    root
        .tag('tr')
            .tag('th')
                .attr('colspan', 2)
                .addClass(args['лакхахь_тоба2'])
                .css('text-align', 'center')
                .css('font-style', 'oblique')
                .cssText(args['лакхахь_хатӀ2'])
                .wikitext(args['лакхахь2'])
end

local function renderBelowRow()
    if not args['лахахь'] then return end

    root
        .tag('tr')
            .tag('td')
                .attr('colspan', 2)
                .addClass(args['лахахь_тоба'])
                .css('text-align', 'center')
                .cssText(args['лахахь_хатӀ'])
                .newline()
                .wikitext(args['лахахь'])
end

local function renderSubheaders()
    if args['корталг'] then
        args['корталг1'] = args['корталг']
    end
    if args['корталган_могӀан_тоба'] then
        args['корталган_могӀан_тоба1'] = args['корталган_могӀан_тоба']
    end
    local subheadernums = getArgNums('корталг')
    for k, num in ipairs(subheadernums) do
        addRow({
            data = args['корталг' .. tostring(num)],
            datastyle = args['корталган_хатӀ'] or args['корталган_хатӀ' .. tostring(num)],
            class = args['корталган_тоба'],
            rowclass = args['корталган_могӀан_тоба' .. tostring(num)]
        })
    end
end

local function renderImages()
    if args['сурт'] then
        args['сурт1'] = args['сурт']
    end
    if args['куьг'] then
        args['куьг1'] = args['куьг']
    end
    local imagenums = getArgNums('сурт')
    for k, num in ipairs(imagenums) do
        local caption = args['куьг' .. tostring(num)]
        local data = HtmlBuilder.create().wikitext(args['сурт' .. tostring(num)])
        if caption then
            data
                .tag('div')
                    .cssText(args['куьйган_хатӀ'])
                    .wikitext(caption)
        end
        addRow({
            data = tostring(data),
            datastyle = args['суьртан_хатӀ'],
            class = args['суьртан_тоба'],
            rowclass = args['суьртийн_могӀан_тоба' .. tostring(num)]
        })
    end
end

local function renderRows()
    -- Объединяет индексы заголовков и текстовых строк карточки
    -- и визуализирует их в правильном порядке через addRow.
    local rownums = union(getArgNums('корта'), getArgNums('йоза'))
    table.sort(rownums)
    for k, num in ipairs(rownums) do
        addRow({
            header = args['корта' .. tostring(num)],
            label = args['билгало' .. tostring(num)],
            data = args['йоза' .. tostring(num)],
            datastyle = args['йозанийн_хатӀ'],
            class = args['тоба' .. tostring(num)],
            rowclass = args['класс_ряда' .. tostring(num)],
            dataid = args['id_йозанан' .. tostring(num)],
            labelid = args['id_белгалонан' .. tostring(num)],
            headerid = args['id_коьртан' .. tostring(num)],
            rowid = args['id_могӀанан' .. tostring(num)]
        })
    end
end

local function renderNavBar()
    if not args['цӀе'] then return end

    root
        .tag('tr')
            .tag('td')
                .attr('colspan', 2)
                .css('text-align', 'right')
                .wikitext(mw.getCurrentFrame():expandTemplate({ 
                    title = 'Tnavbar', 
                    args = { args['цӀе'] }
                }))
end

local function isSet(x)
    -- Возвращает истину, если x задан и не пустой
    -- Внимание: отличается от enwiki! В enwiki проверяется на равенство 'yes'
    return x and x ~= ''
end

local function renderItalicTitle()
    -- Внимание: отличается от enwiki. В enwiki ожидается yes или force, здесь работает любое значение
    if isSet(args['корта_курсивца']) then
        root.wikitext(mw.getCurrentFrame():expandTemplate({title = 'корта курсивца'}))
    end
end

local function renderTrackingCategories()
    if not isSet(args.nocat) then
        if #(getArgNums('йоза')) == 0 and mw.title.getCurrentTitle().namespace == 0 then
            root.wikitext('[[Категори:Статьи с карточкой без заполненных данных]]')
        end
        if isSet(args['юкъадалор']) and args['цӀе'] then
            root.wikitext('[[Категори:Статьи со встроенной карточкой и параметром названия]]')
        end
    end
end

local function _infobox()
    -- Задание общей страктуры карточки с добавлением стилей 
    -- для карточек-потомков.
    if not isSet(args['юкъадалор']) then
        root = HtmlBuilder.create('table')

        root
            .addClass('infobox')
            .addClass(args['дегӀан_тоба'])

            if isSet(args['бухаракарточка']) then
                root
                    .css('padding', '0')
                    .css('border', 'none')
                    .css('margin', '-2px')
                    .css('width', 'auto')
                    .css('min-width', '100%')
                    .css('font-size', '100%')
                    .css('clear', 'none')
                    .css('float', 'none')
                    .css('background-color', 'transparent')
            end
        
        -- Микроразметка
        if isSet(args['дегӀан_микр']) then
        	root
        	  .attr('itemscope', 'itemscope')
        	  .attr('itemtype', args['дегӀан_микр'])
        end
        
        root
            .cssText(args['дегӀан_хатӀ'])

        renderTitle()
        renderAboveRow()
        renderAbove2Row()
    else
        root = HtmlBuilder.create()

        root
            .wikitext(args['цӀе'])
    end

    renderSubheaders()
    renderImages() 
    renderRows() 
    renderBelowRow()  
    renderNavBar()
    renderItalicTitle()
    renderTrackingCategories()

    return tostring(root)
end

local function preprocessSingleArg(argName)
    -- Добавляет аргумент в таблицу аргументов, если он определён и не пустой.
    -- Пустые аргументы не обрабатываются, как и в ParserFunctions.
    if origArgs[argName] and origArgs[argName] ~= '' then
        args[argName] = origArgs[argName]
    end
end

local function translateArg(aliasArgName,localArgName)
	-- Функция добавляет поддержку алиасов параметров (например, на другом языке)
	
	-- Добавляем алиас параметра в таблицу алиасов
	-- Для одного параметра может быть несколько алиасов
	-- Нумерованные параметры(текст1 и т.д.) заносятся без номера
	if not 	argsAliases[localArgName] then
		argsAliases[localArgName] = {}
	end
	table.insert(argsAliases[localArgName], aliasArgName)
	
	-- Пока для тестирования: значения алиасов добавляются в таблицу аргументов
	-- Нумерованные параметры работать не будут
    if origArgs[localArgName] and origArgs[localArgName] ~= '' then
    	-- параметр уже задан на локальном языке
    else
    	-- если алиас задан и не пустой
	    if origArgs[aliasArgName] and origArgs[aliasArgName] ~= '' then
	        origArgs[localArgName] = origArgs[aliasArgName]
	    end
    end
end

local function preprocessArgs(prefixTable, step)
    -- Сохраняет параметры с заданными префиксами в таблицу args, последовательно обходя
    -- аргументы в нужном порядке и с нужным шагом. Благодаря этому сноски и пр. появляются
    -- в правильном порядке. prefixTable — массив таблиц, каждая из которых может содержать
    -- два поля: поле-строку префикса (обязательно) и поле-таблицу зависимых параметров.
    -- Эта функция всегда обрабатывает параметры с префиксом, но зависимые параметры
    -- обрабатываются, только если параметр с префиксом задан и не пустой.
    if type(prefixTable) ~= 'table' then
        error("В качестве таблицы префиксов должна использоваться таблица", 2)
    end
    if type(step) ~= 'number' then
        error("Недопустимый тип параметра шага", 2)
    end

    -- Проверка правильности данных и обработка параметров без суффиксов.
    for i,v in ipairs(prefixTable) do
        if type(v) ~= 'table' or type(v.prefix) ~= "string" or (v.depend and type(v.depend) ~= 'table') then
            error('Недопустимая таблица префиксов preprocessArgs', 2)
        end
        preprocessSingleArg(v.prefix)
        -- Зависимые параметры обрабатываются, только если параметр с префиксом задан и не пустой.
        if args[v.prefix] and v.depend then
            for j, dependValue in ipairs(v.depend) do
                if type(dependValue) ~= 'string' then
                    error('Недопустимый тип зависимого параметра в таблице preprocessArgs')
                end
                preprocessSingleArg(dependValue)
            end
        end
    end

    -- Обход нумерованных аргументов.
    local a = 1 -- Переменная-счётчик.
    local moreArgumentsExist = true
    while moreArgumentsExist == true do
        moreArgumentsExist = false
        for i = a, a + step - 1 do
            for j,v in ipairs(prefixTable) do
                local prefixArgName = v.prefix .. tostring(i)
                if origArgs[prefixArgName] then
                    moreArgumentsExist = true -- Искать аргументы дальше, если был хотя бы один (в т. ч. пустой)
                    preprocessSingleArg(prefixArgName)
                end
                -- Обрабатываем зависимые аргументы, если определена таблица зависимостей,
                -- а также задан не пустой аргумент с префиксом, либо обрабатывается 
                -- "префикс1" и "префикс" задан (например, "сурт1" является синонимом для "сурт").
                if v.depend and (args[prefixArgName] or (i == 1 and args[v.prefix])) then
                    for j,dependValue in ipairs(v.depend) do
                        local dependArgName = dependValue .. tostring(i)
                        preprocessSingleArg(dependArgName)
                    end
                end
            end
        end
        a = a + step
    end
end

function p.infobox(frame)
    -- При запуске через #invoke аргументы передаются через стандартную систему.
    -- При тестировании также можно передавать таблицу аргументов через frame.
    if frame == mw.getCurrentFrame() then
        origArgs = frame:getParent().args
    else
        origArgs = frame
    end
    
    -- Поддержка параметров из англовики
    translateArg('child','юкъадалор')
    translateArg('bodyclass','дегӀан_тоба')
    translateArg('subbox','бухаракарточка')
    translateArg('bodystyle','дегӀан_хатӀ')
    translateArg('title','цӀе')
    translateArg('titleclass','цӀеран_тоба')
    translateArg('titlestyle','цӀеран_хатӀ')
    translateArg('above','лакхахь')
    translateArg('aboveclass','лакхахь_тоба')
    translateArg('abovestyle','лакхахь_хатӀ')
    
    translateArg('subheader','корталг')
    translateArg('subheaderstyle','корталган_хатӀ')
    translateArg('subheaderrowclass','корталган_тоба')

    translateArg('subheaderstyle','корталгийн_хатӀ')
    translateArg('subheaderclass','корталгийн_тоба')


    translateArg('image','сурт')
    translateArg('caption','куьг')
    translateArg('imagerowclass','суьртийн_могӀан_тоба')

    translateArg('captionstyle','куьйган_хатӀ')
    translateArg('imagestyle','суьртан_хатӀ')
    translateArg('imageclass','суьртан_тоба')
    

    translateArg('header','корта')
    translateArg('data','йоза')
    translateArg('label','билгало')
    translateArg('rowclass','могӀан_тоба')
    translateArg('class','тоба')
    translateArg('dataid','id_йозанан')
    translateArg('labelid','id_билгалонан')
    translateArg('headerid','id_корта')
    translateArg('rowid','id_могӀан')

    translateArg('headerclass','коьртанийн_тоба')
    translateArg('headerstyle','коьртанийн_хатӀ')
    translateArg('labelstyle','билгалонийн_хатӀ')
    translateArg('datastyle','йозанийн_хатӀ')
    translateArg('below','лахахь')
    translateArg('belowclass','лахахь_тоба')
    translateArg('belowstyle','лахахь_хатӀ')
    translateArg('name','цӀе')
    --translateArg('italic title','корта_курсивца')
    --translateArg('','')
    

    -- Параметры обрабатываются по направлению чтения карточки, чтобы
    -- сноски и др. отображались в нужных местах. Параметры, зависящие 
    -- от других параметров, обрабатываются только при наличии других параметров,
    -- чтобы в списке сносок не возникали нежелательные сноски.
    preprocessSingleArg('юкъадалор')
    preprocessSingleArg('дегӀан_тоба')
    preprocessSingleArg('бухаракарточка')
    preprocessSingleArg('дегӀан_хатӀ')
    preprocessSingleArg('цӀе')
    preprocessSingleArg('цӀеран_тоба')
    preprocessSingleArg('цӀеран_хатӀ')
    preprocessSingleArg('лакхахь')
    preprocessSingleArg('лакхахь_тоба')
    preprocessSingleArg('лакхахь_хатӀ')
    preprocessSingleArg('лакхахь2')
    preprocessSingleArg('лакхахь_тоба2')
    preprocessSingleArg('лакхахь_хатӀ2')
    preprocessArgs({
        {prefix = 'корталг', depend = {'коьртан_хатӀ', 'коьртан_тоба'}}
    }, 10)
    preprocessSingleArg('коьртанийн_хатӀ')
    preprocessSingleArg('коьртанийн_тоба')
    preprocessArgs({
        {prefix = 'сурт', depend = {'куьг', 'суьртийн_могӀан_тоба'}}
    }, 10)
    preprocessSingleArg('куьйган_хатӀ')
    preprocessSingleArg('суьртан_хатӀ')
    preprocessSingleArg('суьртан_тоба')
    preprocessArgs({
        {prefix = 'корта'},
        {prefix = 'йоза', depend = {'билгало'}},
        {prefix = 'могӀан_тоба'},
        {prefix = 'тоба'},
        {prefix = 'id_йозанан'},
        {prefix = 'id_билгалонан'},
        {prefix = 'id_корта'},
        {prefix = 'id_могӀан'}
    }, 50)
    preprocessSingleArg('коьртанийн_тоба')
    preprocessSingleArg('коьртанийн_хатӀ')
    preprocessSingleArg('билгалонийн_хатӀ')
    preprocessSingleArg('йозанийн_хатӀ')
    preprocessSingleArg('лахахь')
    preprocessSingleArg('лахахь_тоба')
    preprocessSingleArg('лахахь_хатӀ')
    preprocessSingleArg('цӀе')
    preprocessSingleArg('корта_курсивца')
    preprocessSingleArg('nocat')

    return _infobox()
end

return p