Você pode seguir a nossa conta no Twitter onde são publicadas notícias sobre Minecraft e links rápidos para a Wiki

Ajude os parentes e amigos mais velhos!

Proteja-se contra o novo coronavírus! Traduzimos os splashes temporários do Minecraft para que todos possam se informar contra a pandemia do COVID-19.

Módulo:Section link

De Minecraft Wiki
Ir para: navegação, pesquisa

Este módulo cria links para seções, bem formatados com o símbolo "§" em vez do padrão "#". O módulo é retirado diretamente Template:Section link na Wikipédia em inglês.

Uso[editar código-fonte]

Do wikitexto[editar código-fonte]

Do wikitexto, este módulo deve ser usado através da predefinição {{link de seção}}. Por favor, veja a página da predefinição para documentação.

Do Lua[editar código-fonte]

Primeiro, carregue o módulo:

local mSectionLink = require('Módulo:Section link')

Você pode então fazer links de seção através da função _main.

mSectionLink._main(page, sections, options, title)

Parâmetros:

  • page - o nome da página para vincular. O padrão é o nome completo da página de title, ou o título atual, se isso não for especificado.
  • sections - uma matriz de nomes de seção para vincular a ou uma string para vincular apenas um nome de seção.
  • options - uma tabela de opções. Aceita os seguintes campos:
    • nopage - defina como true para evitar a exibição do nome da página base nos links.
  • title - um objeto mw.title padrão para usar em vez do título atual. Destinado a fins de teste.

Todos os parâmetros são opcionais.

Exêmplos[editar código-fonte]

Código Lua Código Wikitexto Resultado
mSectionLink('Ovelha', 'Drops') {{link de seção|Ovelha|Drops}} Ovelha § Drops
mSectionLink('Ovelha', {'Drops', 'Comportamento'}) {{link de seção|Ovelha|Drops|Comportamento}} Ovelha § Drops
mSectionLink('Ovelha', {'Drops', 'Comportamento', 'Colorindo'}) {{link de seção|Ovelha|Drops|Comportamento|Colorindo}} Ovelha § Drops
mSectionLink('Ovelha', {'Drops', 'Comportamento', 'Colorindo'}, {nopage = true}) {{link de seção|Ovelha|Drops|Comportamento|Colorindo|nopage=yes}} Ovelha § Drops
[ver | editar | histórico | purgar]A documentação acima é transcluída de Módulo:Section link/doc.
-- Este módulo implementa {{link de seção}}.

local checkType = require('libraryUtil').checkType

local p = {}

local function makeSectionLink(page, section, display)
	display = display or section
	page = page or ''
	return string.format('[[%s#%s|%s]]', page, section, display)
end

local function normalizeTitle(title)
	title = mw.ustring.gsub(mw.ustring.gsub(title,"'",""),'"','')
	return mw.title.new(mw.ustring.gsub(title,"%b<>","")).prefixedText
end

function p._main(page, sections, options, title)
	-- Validate input.
	checkType('_main', 1, page, 'string', true)
	checkType('_main', 3, options, 'table', true)
	if sections == nil then
		sections = {}
	elseif type(sections) == 'string' then
		sections = {sections}
	elseif type(sections) ~= 'table' then
		error(string.format(
			"erro de digitação no argumento #2 para '_main' " ..
			"(string, table ou nil esperado, recebido %s)",
			type(sections)
		), 2)
	end
	options = options or {}
	title = title or mw.title.getCurrentTitle()

	-- Deal with blank page names elegantly
	if page and not page:find('%S') then
		page = nil
		options.nopage = true
	end

	-- Make the link(s).
	local isShowingPage = not options.nopage
	if #sections <= 1 then
		local linkPage = page or ''
		local section = sections[1] or 'Notas'
		local display = '§&nbsp;' .. section
		if isShowingPage then
			page = page or title.prefixedText
			if options.display and options.display ~= '' then
				if normalizeTitle(options.display) == normalizeTitle(page) then
					display = options.display .. ' ' .. display
				else
					error(string.format(
						'Título de exibição "%s" foi ignorado, pois não ' ..
						"é equivalente ao título real da página",
						options.display
					), 0)
				end
			else
				display = page .. ' ' .. display
			end
		end
		return makeSectionLink(linkPage, section, display)
	else
		-- Multiple sections. First, make a list of the links to display.
		local ret = {}
		for i, section in ipairs(sections) do
			ret[i] = makeSectionLink(page, section)
		end

		-- Assemble the list of links into a string with mw.text.listToText.
		-- We use the default separator for mw.text.listToText, but a custom
		-- conjunction. There is also a special case conjunction if we only
		-- have two links.
		local conjunction
		if #sections == 2 then
			conjunction = '&#8203; e '
		else
			conjunction = ', e '
		end
		ret = mw.text.listToText(ret, nil, conjunction)

		-- Add the intro text.
		local intro = '§§&nbsp;'
		if isShowingPage then
			intro = (page or title.prefixedText) .. ' ' .. intro
		end
		ret = intro .. ret

		return ret
	end
end

function p.main(frame)
	local args = require('Módulo:Arguments').getArgs(frame, {
		wrappers = 'Predefinição:Link de seção',
		valueFunc = function (key, value)
			value = value:match('^%s*(.-)%s*$') -- Trim whitespace
			-- Allow blank first parameters, as the wikitext template does this.
			if value ~= '' or key == 1 then
				return value
			end
		end
	})

	-- Sort the arguments.
	local page
	local sections, options = {}, {}
	for k, v in pairs(args) do
		if k == 1 then
			-- Doing this in the loop because of a bug in [[Module:Arguments]]
			-- when using pairs with deleted arguments.
			page = v
		elseif type(k) == 'number' then
			sections[k] = v
		else
			options[k] = v
		end
	end
	
	-- Extract section from page, if present
	if page then
		local p, s = page:match('^(.-)#(.*)$')
		if p then page, sections[1] = p, s end
	end

	-- Compress the sections array.
	local function compressArray(t)
		local nums, ret = {}, {}
		for num in pairs(t) do
			nums[#nums + 1] = num
		end
		table.sort(nums)
		for i, num in ipairs(nums) do
			ret[i] = t[num]
		end
		return ret
	end
	sections = compressArray(sections)

	return p._main(page, sections, options)
end

return p