Module:File

local p = {} local h = {}

local Franchise = require("Module:Franchise") local Term = require("Module:Term") local utilsCargo = require("Module:UtilsCargo") local utilsLayout = require("Module:UtilsLayout") local utilsMarkup = require("Module:UtilsMarkup") local utilsPage = require("Module:UtilsPage") local utilsString = require("Module:UtilsString") local utilsTable = require("Module:UtilsTable")

local data = mw.loadData("Module:File/Data") local cargo = { tableName = "Files", fields = { summary = "String", type = "String", source = "Wikitext", game = "String", licensing = "String", subjects = "List of String", width = "Integer", height = "Integer", } }

-- Template:FileInfo function p.CargoDeclare(frame) return utilsCargo.declare(cargo.tableName, cargo.fields) end

function p.Main(frame) local args, err = utilsArg.parse(frame:getParent.args, p.Templates.FileInfo) utilsCargo.store(cargo.tableName, args) local result = p.printFileInfo(args) if err then return result .. utilsMarkup..categories(err.categories) else return result end end function p.printFileInfo(args) return h.printFileInfoTable(args) .. h.categories(args.type, args.game, args.subject) end function h.printFileInfoTable(args) local gameDisplay if args.game then local gameLogo = Franchise.logo(args.game) local gameImage = gameLogo and utilsPage.exists(gameLogo) and utilsMarkup.file(gameLogo, { size = "130px" }) local gameLink = Franchise.link(args.game) local gameText = gameLink and string.format("This is a file pertaining to %s.", gameLink) if gameImage and gameText then gameDisplay = gameImage .. " " .. gameText elseif gameText then gameDisplay = gameText else gameDisplay = "" end end local license = mw.getCurrentFrame:expandTemplate({		title = "FileInfo/" .. args.license,		args = args	})

local html = mw.html.create("table"):attr("id", "fileinfo") h.row(html, "Summary", args.summary) h.row(html, "Type", args.type) h.row(html, "Game", gameDisplay) h.row(html, "Licensing", license, {		rowspan = args.trademark and "2" or "1" 	}) h.row(html, "Trademark", mw.getCurrentFrame:expandTemplate({ title = "FileInfo/Trademark" })) return tostring(html) end function h.row(html, field, value, attributes) if value then return html :tag("tr") :tag("th") :content(field) :done :tag("td") :content(value) :done :done end end function h.categories(type, game, subjects) local game = game and Franchise.shortName(game) local typeCat = type and data.typesByKey[type].cat local categories = {} if typeCat and not typeCat.nogame and game then table.insert(categories, game .. " " .. typeCat) elseif typeCat then table.insert(categories, typeCat) elseif gameCat then table.insert(categories, game .. " Files") end if subjects then categories = utilsTable.concat(categories, h.subjectCategories(subjects)) end return utilsMarkup.categories(subjects) end function h.subjectCategories(subjects) local categories = utilsTable.flatMap(subjects, function(subject)		local term, err = Term.fetchTerm(subject, args.game)		if term then			term = string.gsub(term, "#", "") -- strip # from term because categories can't have them in their name			local category = "Images of "..term			if utilsPage.exists(category) then -- only add subject-based categories if they already exist, to avoid spamming Special:WantedCategories				return {}			else				return {category}			end		else			return err.categories -- add term-related maintenance categories, if any		end	end) return categories end

-- Various templates function p.Icon(frame) local args = frame.args return p.icon(args[1], args[2], {		size = args.size	}) end

-- Module:File/Data function p.Data(frame) local result = "" result = result .. utilsMarkup.heading(2, "Types") result = result .. utilsLayout.table({		sortable = true,		headers = {"Type", "Category"},		rows = utilsTable.map(data.types, function(type) local key = utilsMarkup.code(type.key) local cat = "Category:"..type.cat.."" return {key, cat} end)	}) result = result .. utilsMarkup.heading(2, "Licenses") result = result .. utilsLayout.table({		sortable = true,		headers = {"License", "Template", "Output"},		rows = utilsTable.map(data.licenses, function(license) local template = "FileInfo/"..license local templateLink = "Template:"..template.."" local templateOutput = mw.getCurrentFrame:expandTemplate({title = template}) return {utilsMarkup.code(license), templateLink, templateOutput} end)	})

return result end

-- Utilities function p.image(game, subject, type, options) local parts = utilsTable._filter(utilsString.notEmpty)({game, subject, type}) local filename = table.concat(parts, " ") .. ".png" if utilsPage.exists("File:" .. filename) then return utilsMarkup.file(filename, options) else local uploadUrl = mw.uri.fullUrl("Special:Upload") uploadUrl:extend({			wpDestFile = filename		}) local options = utilsTable.merge({}, options, {			link = tostring(uploadUrl)		}) -- Make sure thumbnail for 'no image' is no less than 100x100px local size for dimension in string.gmatch(options.size or "", "[0-9]+") do			if tonumber(dimension) < 100 then size = "100px" end end options.size = size or options.size or "100px" return utilsMarkup.file("File:No Image Upload.png", options) end end

function p.icon(game, subject, options) local type = "Icon" if Franchise.graphics(game) == "2D" then type = "Sprite" end return p.image(game, subject, type, options) end

p.Templates = { FileInfo = { purpose = "Displays, categorizes, and stores file information. See Guidelines:Files for further guidance.", format = "block", paramOrder = {"summary", "subject", "type", "source", "game", "licensing", "trademark"}, params = { summary = { --required = true, type = "content", desc = "A short description of the file.", trim = true, nilIfEmpty = true, },			type = { --required = true, type = "string", desc = "The type of file, which determines how it is categorized.", enum = data.typesEnum, trim = true, nilIfEmpty = true, },			source = { --required = true, type = "string", desc = "The original source of the file. It may be in the form of a URL or author recognition. Template:Source exists for this purpose.", trim = true, nilIfEmpty = true, },			subject = { --required = true, type = "string", desc = "Wiki article names of all the subjects depicted in the file. A comma-separated list.", split = true, trim = true, nilIfEmpty = true, },			game = { --required = true, type = "string", desc = "A game code.", enum = Franchise.enumGames, trim = true, nilIfEmpty = true, },			licensing = { required = "Category:Unlicensed Files", type = "string", desc = "The copyright licensing for the file. For the vast majority of files,  is the correct value here.", enum = data.licenses, trim = true, nilIfEmpty = true, },			trademark = { type = "boolean", desc = "Enter any text to add a trademark notice to the licensing. Use on all trademarks (usually denoted by an ® or ™ symbol).", trim = true, nilIfEmpty = true, }		},		examples = { vertical = true, {				summary = "LADX:", subject = "Animal Village, Rabbit", type = "map", source = "", game = "LADX", licensing = "Copyright", },			{				summary = "The Timeline", source = "", type = "print", game = "Series", licensing = "Copyright" },			{				summary = "Nintendo's current logo.", type = "logo", source = "", licensing = "PD-Simple", trademark = "yes", },		},	} }

local optionsSchema = { type = "record", properties = { {			name = "size", type = "string", desc = "Image size in pixels.", },		{			name = "link", type = "string", desc = "Name of a page on the wiki or an external URL for the image thumbnail to link to.", },		{			name = "caption", type = "string", desc = "Alt text for the image.", },	} }

p.Schemas = { image = { game = { type = "string", required = true, desc = "A game code." },		subject = { type = "string", required = true, },		type = { type = "string", required = true, enum = {"", "Artwork", "Icon", "Model", "Render", "Screenshot", "Sprite", "Texture"}, },		options = optionsSchema },	icon = { game = { type = "string", required = true, desc = "A game code." },		subject = { type = "string", required = true, },		options = optionsSchema, } }

p.Documentation = { image = { desc = "See also utilsMarkup.file.", params = {"game", "subject", "type", "options"}, returns = "A  of wikitext that renders a thumbnail.", cases = { {				args = {"TWW", "Great Fairy Figurine", "Model", { link = "Great Fairy", size = "100px" }},				expect = "", },			{				desc = "If file does not exist, show 'click to upload' thumbnail which links to Special:Upload.", args = {"TWWHD", "Great Fairy Figurine", "Model", { link = "Great Fairy", size = "150px" }},				expect = "", },			{				desc = "'No image' thumbnail has minimum 100px width, because it is illegible at smaller sizes.", args = {"TWWHD", "Great Fairy Figurine", "Model", { link = "Great Fairy", size = "64px", }},				expect = "", },		}	},	icon = { params = {"game", "subject", "options"}, returns = "An icon thumbnail for the subject in the given game.", cases = { {				args = {"LANS", "Pineapple"}, expect = "" },			{				args = {"LADX", "Pineapple"}, expect = "" },		}	} }

return p