Модуль:Заготовка
Внешний вид
Модуль существует для шаблона {{קצרמר}}. Он позволяет управлять модулем без необходимости добавлять дублирующийся код каждый раз, когда нужен новый тип. Модуль возвращает три функции:
- Функция main возвращает шаблон «Заготовка» для определённого типа заготовки.
- Функция templatedata возвращает отсортированный список всех типов заготовок для templatedata.
- Функция 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
}