Módulo:Página
Aparência
| Este módulo depende dos seguintes outros módulos: |
Este módulo permite acessar, a partir do código wiki, propriedades e funções dos objetos de título do Scribunto, sem a necessidade de escrever um módulo em Lua.
O uso básico é:
{{#invoke:Página|função|parâmetros}}
Funções
[editar código]função pode ser uma das seguintes propriedades ou funções de um objeto de título:
id: identificador numérico da página; retorna0se ela não existir.interwiki: prefixo interwiki ou uma cadeia vazia.namespace: número do domínio.fragment: fragmento do título ou uma cadeia vazia.nsText: nome do domínio.subjectNsText: nome do domínio de conteúdo correspondente.text: título sem o domínio nem o prefixo interwiki.prefixedText: título com domínio e prefixo interwiki.fullText: título completo, incluindo domínio, prefixo interwiki e fragmento.rootText: título da página-raiz, sem prefixos; se não houver subpágina, equivale atext.baseText: título da página imediatamente superior, sem prefixos; se não houver subpágina, equivale atext.subpageText: nome da subpágina; se não houver, equivale atext.canTalk: informa se o título pode possuir uma página de discussão.exists: informa se a página existe.fileExists: informa se o ficheiro existe.isContentPage: informa se o título pertence a um domínio de conteúdo.isExternal: informa se possui prefixo interwiki.isLocal: informa se o título pertence a um projeto considerado local.isRedirect: informa se a página é um redirecionamento.isSpecialPage: informa se é um título possível no domínio Especial.isSubpage: informa se é uma subpágina.isTalkPage: informa se pertence a um domínio de discussão.isSubpageOf(título): informa se é subpágina do título indicado.inNamespace(domínio): informa se pertence ao domínio indicado.inNamespaces(...): informa se pertence a qualquer dos domínios indicados.hasSubjectNamespace(domínio): informa se seu domínio de conteúdo corresponde ao indicado.contentModel: modelo de conteúdo da página.basePageTitle: objeto de título da página-base.rootPageTitle: objeto de título da página-raiz.talkPageTitle: objeto de título da página de discussão correspondente.subjectPageTitle: objeto de título da página de conteúdo correspondente.subPageTitle(texto): cria o título de uma subpágina.partialUrl(): devolve o título codificado para uso em URL.fullUrl(consulta, protocolo): devolve a URL completa.localUrl(consulta): devolve a URL local.canonicalUrl(consulta): devolve a URL canônica.getContent(): devolve o conteúdo não processado da página ou uma cadeia vazia se ela não existir.
Parâmetros
[editar código]Seleção da página
[editar código]id: identificador numérico da página. Quando informado, os demais parâmetros de seleção são ignorados.páginaoupage: título da página. Se omitido, é usada a página atual.fazerTítulooumakeTitle: se tiver qualquer valor, usamw.title.makeTitle; caso contrário, usamw.title.new.domínio,espaço nominalounamespace: domínio usado na criação do título.fragmentooufragment: fragmento do título.interwiki: prefixo interwiki.
Parâmetros das funções
[editar código]Os parâmetros p1 a p9 são enviados à função escolhida.
Em particular:
p1: primeiro argumento deisSubpageOf,inNamespace,inNamespaces,hasSubjectNamespace,subPageTitlee das funções de URL;p2: segundo argumento deinNamespacesou o protocolo defullUrl;p3ap9: usados principalmente porinNamespaces.
Tratamento do conteúdo
[editar código]Ao usar getContent, como ou as controla a forma da saída:
pre— envolve o conteúdo em<pre>; é o padrão;nowiki— impede a interpretação do código wiki;expand— expande o conteúdo;raw— devolve o conteúdo sem tratamento.
local callAssert = require('Module:CallAssert')
local function main(frame, field)
local args, pargs = frame.args, ( frame:getParent() or {} ).args or {}
local makeTitle=args.makeTitle or args['fazerTítulo'] or pargs.makeTitle or pargs['fazerTítulo']
local namespace=args.namespace or args['domínio'] or args['espaço nominal'] or pargs.namespace or pargs['domínio'] or pargs['espaço nominal'] or ""
local fragment=args.fragment or args.fragmento or pargs.fragment or pargs.fragmento or ""
local interwiki=args.interwiki or pargs.interwiki or ""
local page=args.page or args['página'] or args[1] or pargs.page or pargs['página'] or pargs[1] or ""
local id= tonumber( args.id or pargs.id )
local pn = {}
local title -- holds the result of the mw.title.xxx call
for i = 1,9 do pn[i] = args['p'..i] or pargs['p'..i] end
if not id and not mw.ustring.match( page, '%S' ) then page = nil end
if id then
title = callAssert(mw.title.new, 'mw.title.new', id)
elseif not page then
title = callAssert(mw.title.getCurrentTitle, 'getCurrentTitle')
elseif makeTitle then
title = callAssert(mw.title.makeTitle, 'makeTitle', namespace, page, fragment, interwiki)
else
title = callAssert(mw.title.new, 'mw.title.new', page, namespace)
end
local result = title[field]
if type(result) == "function" then
result = result(title, unpack(pn))
end
return tostring(result or "")
end
-- handle all errors in main
main = require('Módulo:Protect')(main)
local p = {}
-- main function does all the work
local meta = {}
function meta.__index(self, key)
return function(frame)
return main(frame, key)
end
end
setmetatable(p, meta)
function p.getContent(frame)
local args, pargs = frame.args, ( frame:getParent() or {} ).args or {}
local fmt = args.as or args.como or pargs.as or pargs.como or "pre"
local text = main(frame, "getContent")
fmt = mw.text.split( fmt, ", ?" )
for _, how in ipairs( fmt ) do
if how == "pre" then
text = table.concat{ "<pre>", text, "</pre>" }
elseif how == "expand" then
text = frame:preprocess(text)
elseif how == "nowiki" then
text = mw.text.nowiki(text)
end
end
return text
end
return p