Перейти к содержанию

Модуль:Заготовка

Материал из Хабадпедии

Модуль существует для шаблона {{קצרמר}}. Он позволяет управлять модулем без необходимости добавлять дублирующийся код каждый раз, когда нужен новый тип. Модуль возвращает три функции:

  1. Функция main возвращает шаблон «Заготовка» для определённого типа заготовки.
  2. Функция templatedata возвращает отсортированный список всех типов заготовок для templatedata.
  3. Функция categories возвращает отсортированный список категорий статей всех типов для документации.

Модуль использует список типов на странице Модуль:Заготовка/list.json. Он написан на языке json. Структура записи следующая:

  • Для большинства типов ключ — название типа, а содержимое — имя файла иконки.
  • Для типов, у которых название типа отличается от названия категории, содержимое — массив из двух элементов. Первый — имя файла иконки, второй — название категории.

Например:

    "תל אביב-יפו": "Tel-aviv city hall.jpg",
    "תל אביב": [
        "Tel-aviv city hall.jpg",
        "תל אביב-יפו"
    ],

Указания по добавлению новых типов

  • Чтобы добавить заготовку «Tel-Aviv», нужно выполнить следующие действия
  • Добавить в файл Модуль:Заготовка/list.json строку ,"Tel-Aviv": "Tel-aviv city hall.jpg"
  • Если название типа отличается от названия категории, строка такова: ,"Tel-Aviv": ["Tel-aviv city hall.jpg", "Tel-Aviv-Yafo"]
  • Если нужно добавить рамку к изображению, следует обновить код следующим образом: "יפן": "Flag of Japan.svg{{!}}גבול",
  • Обратите внимание на запятую перед текстом. Она добавлена, потому что после каждой строки списка, кроме последней, должна стоять запятая.
  • Движок автоматически позаботится о формате после сохранения, так что запятая будет перенесена в конец предыдущей строки. То же и с надлежащим форматированием квадратных скобок.
  • Если в одном из названий есть знак двойных кавычек, перед ним нужно написать знак обратной косой черты, например "תנ\"ך"
  • Исходный список был отсортирован, но в этом нет необходимости, так как модуль сортирует его автоматически после чтения.
  • Список можно обновить в templatedata ниже, скопировав со страницы Шаблон:Заготовка/Список. При необходимости следует очистить кэш с помощью кнопки на этой странице. Если в названии типа есть двойные кавычки, нужно поставить перед ними обратную косую черту, например צה\"ל.
  • Список категорий на этой странице обновляется автоматически. При необходимости можно очистить кэш с помощью прилагаемой кнопки.

local jsonlist = mw.text.jsonDecode(mw.title.new('קצרמר/list.json','Module'):getContent())
local defcode = {"{{קצרמר/קוד|",
				 "|נושא נוסף=",
				 "|מידע נוסף=",
				 "|NoCategory={{#שווה:{{מרחב השם}}||",
				 "}}}}"}
local errcode = '<div style="border:1px solid #aaa; background:#FFF0F5;">[[קובץ:סמל חבדפדיה.png|25px|ימין|אזהרה]]ערך זה הוא ' ..
	'[[חב"דפדיה:קצרמר|קצרמר]], אך הוא סווג כקצרמר מסוג שאינו ב[[:קטגוריה:קצרמר|רשימת הקצרמרים]] ב[[חב"דפדיה]].' ..
	' נא לתקן ולבחור שם מהרשימה.</div>{{#תנאי:{{NAMESPACE}}||[[קטגוריה:קצרמר לא מסווג]]}}'
local catcode = {"'''<nowiki>{{</nowiki>[[:קטגוריה:קצרמר ",
                 "|קצרמר|",
                 "]]<nowiki>}}</nowiki>'''"}
local catstartcode = "{{כתב מחוק|'''<nowiki>{{</nowiki>[[:קטגוריה:קצרמר|קצרמר]]<nowiki>}}</nowiki>'''}} לא בשימוש:" ..
	" מותר רק קצרמר ספציפי: <nowiki>{{קצרמר|</nowiki>'''סוג הקצרמר'''<nowiki>}}</nowiki>{{הערה|קצרמר לא ספציפי" ..
	" יוצר [[:קטגוריה:שגיאות פרמטריות בתבנית קצרמר|שגיאה פרמטרית]]}}"

function main(frame)
	local parentargs = frame:getParent().args
	local entry = parentargs[1] or 'כללי'
	local param2 = parentargs[2] or ''
	local parammidanosaf = parentargs['מידע נוסף'] or ''
	local paramnocategory = parentargs['NoCategory'] or ''
	local paramnocategoryyes = parentargs['NoCategory'] or 'yes'
	local catanswer = mw.ustring.format('%s%s|%s%s', '{{קטגוריה בתבנית|:[[קטגוריה:קצרמר - כל הערכים]]|ללא קטגוריה={{#שווה:{{מרחב השם}}||',
		  paramnocategory, paramnocategoryyes, '}}}}')
	local ans = getparams(entry, jsonlist)
	if (not ans)
		then return frame:preprocess(errcode .. catanswer)
	end
	if (entry == 'כללי')
		then param2 = ''
		end
	if (entry == 'שונות')
		then param2 = ''
			 parammidanosaf = ''
		end
	return frame:preprocess(mw.ustring.format('%s%s%s%s%s%s|%s%s%s|%s%s', defcode[1], ans[2], defcode[2], param2, defcode[3],
	       parammidanosaf, ans[1], defcode[4], paramnocategory, paramnocategoryyes, defcode[5]) .. catanswer)
end

function getparams(entry, tab)
	local value = tab[entry]
	if (not value or type(value) == "table")
		then return value
		end
	return {value, entry}
end

function templatedata(frame)
	local ans = {}
	for k, v in pairs( jsonlist )
		do table.insert(ans, '"' .. k .. '"')
		end
	table.sort(ans)
	return table.concat(ans, ', ')
end

local function categories(frame)
	local ans = {}
	local param
	for k, v in pairs( jsonlist )
		do if (k ~= 'כללי')
		   then if (type(v) == "table")
				   then param = v[2]
				   else param = k
				   end
			    table.insert(ans, mw.ustring.format("%s%s%s%s%s", catcode[1], param, catcode[2], k, catcode[3]))
		   end
		end
	table.sort(ans)
	return frame:preprocess('<ol><li>' .. catstartcode .. '</li><li>' .. table.concat(ans, '</li><li>') .. '</li></ol>{{מטמון}}')
end

local function pageSize(frame)
	local pageKey, nsKey, formatKey, inCharsKey  = 'דף',  'מרחב שם', 'עיצוב', 'בתווים'
	local parent = frame:getParent()
	local args, pargs = frame.args, parent.args
    local pageName = args[pageKey] or pargs[pageKey] 
	local nsName = args[nsKey] or pargs[nsKey] or '' --namespace defaults to 0 (ראשי): nsName '' 
	local format = args[formatKey] or pargs[formatKey]
	local inChars = args[inCharsKey] or pargs[inCharsKey]
	
	if not pageName then -- no pagename param passed: ignore nsName param./default, use currentPage ns.
		local current = mw.title.getCurrentTitle()
		pageName, nsName = current['text'], current['nsText']
	end
	local content = mw.title.new(pageName, mw.text.trim(nsName)):getContent() or '';
	local len = inChars and mw.ustring.len(content) or #content -- length or page in chars (when inCharsKey param passed) or bytes otherwise 
	return format and mw.getContentLanguage():formatNum(len) or len
end

return {
	main = main, 
	templatedata = templatedata, 
	categories = categories,
	['גודל דף'] = pageSize
}

Сообщить об ошибке на этой странице