Modulo:Silpo ti papeles/pagipadasan

Dokumentasion ti modulo


Daytoy a modulo ket maus-usar a panagaramid kadagiti silpo dagiti papeles. Daytoy ket nangruna a naserbi para kadagiti plantilia a narikut iti lohika iti panagaramid kadagiti silpo ti papeles. Dagiti nalaka a silpo ti papeles ket nasken a dagus a maaramid iti pannakaisurat ti wiki, gapu ta agusar dagitoy ti basbassit a rekurso ngem ti daytoy a modulo. Para iti tulong iti pannagisurat iti wiki kadagiti papeles pangngaasi a kitaen ti dokumentasion idiay mediawiki.org.

Panagusar manipud ti wikitext

urnosen

Manipud ti wikitext, daytoy a modulo ket nasken a maawagan manipud ti plantilia , kadawyan a ti {{silpo ti papeles}}. Pangngaasi a kitaen ti panid ti plantilia para iti dokumentasion. Nupay kasta, daytoy ket mabalin pay a maawagan babaen ti sintaksis ti {{#invoke:Silpo ti papeles|main|dagiti argumento}}.

Panagusar manipud ti Lua

urnosen

Umuna a nasken nga ikarga ti modulo.

local mFileLink = require('Modulo:Silpo ti papeles')

Kalpasanna mabalinton ti agaramid kadagiti silpo ti papeles babaen ti panagusar ti annong ti _main .

mFileLink._main(args)

Ti args ket tabla dagiti argumento a mabalin nga addaan kadagiti sumaganad a tekla:

  • file - ti nagan ti papeles. (nasken)
  • format - ti pormat ti papaeles, kas iti 'thumb', 'thumbnail', 'frame', 'framed', wenno 'frameless'.
  • formatfile - ti mainaganan a nagan ti papeles nga addaan iti pormat a pagpilian ti 'thumbnail' . Ti mainaganan a nagan ti papeles ket isunto ti mausar imbes a ti automatiko a maapataud a thumbnail.
  • border - isaad daytoy iti true wenno "yes" (wenno ti ania man a sabali a pateg a mabigbigan babaen ti Modulo:Wensaan) tapno maisaad ti pagbeddengan para iti ladawan.
  • location - ti horisontal apannakailinia ti papeles, a kas ti 'right', 'left', 'center', wenno 'none'.
  • alignment - the vertical alignment of the file, e.g. 'baseline', 'middle', 'sub', 'super', 'text-top', 'text-bottom', 'top', wenno 'bottom'.
  • size - ti kadakkel ti ladawan a kas ti. '100px', 'x100px' wenno '100x100px'.
  • upright - ti parametro ti 'upright' , inus-usar para iti panangisaad ti katayag ken kaingpis dagiti ladawan.
  • link - ti panid a pakaisilpuan ti papales. Usaren ti blanko a kuerdas ti '' tapno mapasardeng ti kasisigud a silpo iti deskripsion a panid ti papeles.
  • alt - ti alternatibo a teksto. Usaren ti blanko a kuerdas ti '' tapno mapasardeng ti kasisigud a tekstot.
  • caption - ti kapsion para iti papeles.
  • page - isaadna ti bilang para iti adu a panid a pappapeles a kas dagiti PDF.
  • class - agnayon ti parametro ti class kadagiti silpo ti ladawan. Ti sopwer ti MediaWiki ket agnayon iti daytoy a parametro iti gupit ti class="..." iti <img />nga elemento no ti panid ket maiparang iti HTML.
  • lang - agnayon iti gupit iti pagsasao tapno manginagan no ania a pagsasao iti pakaiparangan ti papeles.
  • start - manginagan ti oras a panagrugi para kadagiti papeles ti audio ken video.
  • end - manginagan ti maysa panagpatingga nga oras para kadagiti papeles ti audio aken video.
  • thumbtime - manginagan ti oras a mausar iti panagpataud ti thumbnail a ladawan para iti video.

Ti mangkita ti epekto iti tunggal maysa kadagitoy a parametro, kitaen ti panid ti tulog dagiti ladawan idiay mediawiki.org.

Dagiti pagarigan

urnosen

Ti addaan laeng iti papeles:

mFileLink.main{file = 'Example.png'}
-- Maiparang a kas [[Papeles:Example.png]]

Ti addaan kadagiti pagpilian ti format, size, link ken caption:

mFileLink.main{
	file = 'Example.png',
	format = 'thumb',
	size = '220px',
	link = 'Wikipedia:Pagipadasan',
	caption = 'Ti maysa a pagarigan.'
}
-- Maiparang a kas [[Papeles:Example.png|thumb|220px|link=Wikipedia:Pagipadasan|Ti maysa a pagarigan.]]

Ti addaan iti format, size, ken border:

mFileLink.main{
	file = 'Example.png',
	format = 'frameless',
	size = '220px',
	border = true
}
-- Maiparang a kas [[Papeles:Example.png|frameless|border|220px]]
-- This module provides a library for formatting file wikilinks.

local yesno = require('Modulo:Wensaan')
local checkType = require('libraryUtil').checkType

local p = {}

function p._main(args)
	checkType('_main', 1, args, 'table')

	-- This is basically libraryUtil.checkTypeForNamedArg, but we are rolling our
	-- own function to get the right error level.
	local function checkArg(key, val, level)
		if type(val) ~= 'string' then
			error(string.format(
				"biddut ti kita iti parametro ti '%s' iti '_main' (nanamnama a kuerdas, ti naala ket %s)",
				key, type(val)
			), level)
		end
	end

	local ret = {}

	-- Adds a positional parameter to the buffer.
	local function addPositional(key)
		local val = args[key]
		if not val then
			return nil
		end
		checkArg(key, val, 4)
		ret[#ret + 1] = val
	end

	-- Adds a named parameter to the buffer. We assume that the parameter name
	-- is the same as the argument key.
	local function addNamed(key)
		local val = args[key]
		if not val then
			return nil
		end
		checkArg(key, val, 4)
		ret[#ret + 1] = key .. '=' .. val
	end

	-- Filename
	checkArg('file', args.file, 3)
	ret[#ret + 1] = 'File:' .. args.file

	-- Format
	if args.format then
		checkArg('format', args.format)
		if args.formatfile then
			checkArg('formatfile', args.formatfile)
			ret[#ret + 1] = args.format .. '=' .. args.formatfile
		else
			ret[#ret + 1] = args.format
		end
	end

	-- Border
	if yesno(args.border) then
		ret[#ret + 1] = 'border'
	end

	addPositional('location')
	addPositional('alignment')
	addPositional('size')
	addNamed('upright')
	addNamed('link')
	addNamed('alt')
	addNamed('page')
	addNamed('class')
	addNamed('lang')
	addNamed('start')
	addNamed('end')
	addNamed('thumbtime')
	addPositional('caption')

	return string.format('[[%s]]', table.concat(ret, '|'))
end

function p.main(frame)
	local origArgs = require('Modulo:Dagiti argumento').getArgs(frame, {
		wrappers = 'Plantilia:Silpo ti papeles'
	})
	if not origArgs.file then
		error("ti parametro ti 'file' ket awan manipud ti [[Plantilia:Silpo ti papeles]]", 0)
	end

	-- Copy the arguments that were passed to a new table to avoid looking up
	-- every possible parameter in the frame object.
	local args = {}
	for k, v in pairs(origArgs) do
		-- Make _BLANK a special argument to add a blank parameter. For use in
		-- conditional templates etc. it is useful for blank arguments to be
		-- ignored, but we still need a way to specify them so that we can do
		-- things like [[File:Example.png|link=]].
		if v == '_BLANK' then
			v = ''
		end
		args[k] = v
	end
	return p._main(args)
end

return p