Module:Life Guide

Module documentation

[view] [edit] [history] [purge]

Main

Documentation

Usage

This module implements {{Tutorial}} and {{Tutorials by Category Table}}.

Text above can be found here (edit)
Editors can experiment in this module's draft (create |  mirror) page.
Please add categories to the documentation subpage. Subpages of this module.

local p = {}
local lib = require('Module:Feature')
local checkExists = require('Module:Exists').checkExists
local getTemplateArgs = require('Module:Parser').getTemplateArgs

-- [[Template:Tutorial]]
function p.Tutorial(frame, args)
	if args == nil then
		args = require('Module:Arguments').getArgs(frame, { parentFirst = true })
	end
	
	local html = mw.html.create()
	if args[1] and type(args[1]) == 'string' then
		for page in lib.gsplit(args[1], ';', { removeEmpty = true }) do
			local tutorialArgs = getTemplateArgs('Tutorial/' .. page, { only = 'Tutorial' })
			if lib.isEmpty(tutorialArgs) then
				html:tag('strong'):addClass('error'):wikitext('The page [[Tutorial/', page, ']] is not a valid tutorial.')
			else
				html
					:tag('div'):addClass('tutorial')
						:tag('dl')
							:tag('dt'):wikitext(tutorialArgs.title or page)
							:tag('dd'):node(p._TutorialFormat(tutorialArgs))
			end
		end
	else
		html
			:tag('div'):addClass('tutorial')
				:node(p._TutorialFormat(args))
	end
	return frame:preprocess(tostring(html))
end

function p._TutorialFormat(args)
	local out = mw.html.create('')
	local title = mw.title.getCurrentTitle()
	if args.about then
		args.about = lib.split(args.about, ';')
		if title.rootText == 'Tutorial' then
			out:tag('i'):wikitext(require('Module:Hatnote').main(args.about))
		end
	end
	
	local size = args.size or '200px'
	if (title.rootText == 'Tutorial') then
		size = '400px'
	end
	
	-- create format
	local I = 1
	while (args['image' .. tostring(I)] or args['text' .. tostring(I)]) do
		local image = args['image' .. tostring(I)]
		local text = args['text' .. tostring(I)]
		if (image or text) then
			local row = out:tag('div'):addClass('tutorial-detail')
			row:wikitext('[[File:', (image or 'Empty.png'), '|', size, ']]')
			row:tag('div'):wikitext((text or '<wbr>'))
			if (args['image' .. tostring(I+1)] or args['text' .. tostring(I+1)]) then
				row:tag('hr'):addClass('mobile-only')
			end
		end
		I = I + 1
	end
	
	-- add categories if correct page
	local subpage = args.title or title.subpageText
	if (not args['table'] and title.baseText == 'Tutorial' and (subpage ~= nil and not lib.inArray({ 'Elements', 'Enemies', 'System', 'Adventure', 'Event', 'Quest', 'Uncategorized' }, subpage))) then
		local cat = mw.html.create()
		cat:wikitext('[[Category:Tutorials|', subpage, ']]')
		
		if args['sort'] then
			cat:wikitext('[[Category:Tutorial|', string.format('%05d', args['sort']), ']]')
		else
			cat:wikitext('[[Category:Tutorial]]')
		end
		
		if lib.inArray({ 'Elements', 'Enemies', 'System', 'Adventure' }, args['type']) then
			cat:wikitext('[[Category:', args['type'], ' Tutorials|', subpage, ']]')
			if not args['sort'] then
				cat:wikitext('[[Category:Tutorial Missing Sort]]')
			end
		elseif args['type'] == 'Event' or args['type'] == 'Quest' then
			cat:wikitext('[[Category:', args['type'], ' Tutorials|', subpage, ']]')
		else
			cat:wikitext('[[Category:Uncategorized Tutorials|', subpage, ']]')
		end
		
		if args.about then
			for _, v in pairs(args.about) do
				cat:wikitext('[[Category:', v, ' Tutorials]]')
			end
		end
		
		local I = 1
		local exists = true
		while (args['image' .. tostring(I)] and exists) do
			if not checkExists('File:' .. args['image' .. tostring(I)]) then
				cat:wikitext('[[Category:Tutorial Missing Image]]')
				exists = false;
			end
			I = I + 1
		end
			
		if not args.nocat then
			out:node(require('Module:Namespace detect')._main{main=cat, module=cat})
		end
	end
	return out
end

-- [[Template:Tutorials by Category Table]]
function p.Table(frame)
	local args = require('Module:Arguments').getArgs(frame, { parentFirst = true })
	local result = mw.html.create('div'):addClass('tutorial-table')
	local title = mw.title.getCurrentTitle().text
	
	if lib.isEmpty(args.pages) then
		result:tag('span'):wikitext('No [[Tutorial]]s ', (args[1] and 'that match the category selection' or 'are in ' .. title), '.')
	else
		local resultTable = mw.html.create('table'):addClass('article-table')
		local count = 0
		for tutorialPage in lib.gsplit(args.pages, ';;;', { noTrim = true, removeEmpty = true }) do
			local tutorialArgs = getTemplateArgs(tutorialPage, { only = 'Tutorial' })
			for key, value in pairs(tutorialArgs) do
				if value == '' then tutorialArgs[key] = nil end	
			end
			tutorialArgs.PAGENAME = tutorialPage
			resultTable:node(p._TableRow(frame, tutorialArgs))
			count = count + 1
		end
		
		local header = result:tag('div'):addClass('tutorial-header')
		if lib.isNotEmpty(args.header) then
			header:wikitext(tostring(tostring(args.header):gsub('%%PAGES%%', count)))
		else
			header:wikitext(
				'There ',
				(count == 1 and 'is ' or 'are '),
				"'''",
				count,
				"'''",
				' [[Tutorial]]',
				(count == 1 and ' ' or 's '),
				(args[1] and ('that match' .. (count == 1 and 'es' or '') .. ' the category selection:') or ' are in ' .. title)
			)
		end
		result:node(resultTable)
	end
	
	return frame:preprocess(tostring(result))
end

function p._TableRow(frame, args)
	local out = mw.html.create('')
	
	if args.title then
		local header = out:tag('tr'):tag('th')
		header:wikitext('[[', args.PAGENAME, '|', args.title, ']]')
		if args.subtitle then
			header:wikitext(' - ', args.subtitle)
		end
		if args.icon then
			header:wikitext(' [[File:', args.icon, '|25px|link=]]')
		end
		
		local row = out:tag('tr'):tag('td')
		args['table'] = true
		row:node(p.Tutorial(frame, args))
	end
	return out
end

return p