Modul:Section link
Udseende
This module creates links to sections, nicely formatted with the "§" symbol instead of the default "#".
Brug
Fra wikitekst
From wikitext, this module should be used via the template {{section link}}. Please see the template page for documentation.
Fra Lua
First, load the module:
local mSectionLink = require('Modul:Section link')
You can then make section links via the _main function.
mSectionLink._main(page, sections, options, title)
Parametre:
- page - the page name to link to. Defaults to the full page name of title, or the current title if that is not specified.
- sections - an array of section names to link to, or a string to link to just one section name.
- options - a table of options. Accepts the following fields:
- nopage - set this to true to avoid displaying the base page name in links.
- title - a default mw.title object to use instead of the current title. Intended for testing purposes.
Alle parametre er valgfrie.
Eksempler
Lua kode | Wikitext kode | Resultat |
---|---|---|
mSectionLink('Paris', 'Arkitektur')
|
{{section link|Paris|Arkitektur}}
|
Paris § Arkitektur |
mSectionLink('Paris', {'Arkitektur', 'Kultur'})
|
{{section link|Paris|Arkitektur|Kultur}}
|
Paris §§ Arkitectur og Kultur |
mSectionLink('Paris', {'Arkitektur', 'Kultur', 'Sport'})
|
{{section link|Paris|Arkitektur|Culture|Sport}}
|
Paris §§ Architecture, Kultur, og Sport |
mSectionLink('Paris', {'Arkitektur', 'Culture', 'Sport'}, {nopage = true})
|
{{section link|Paris|Arkitektur|Culture|Sport|nopage=yes}}
|
§§ Arkitektur, Kultur, og Sport |
-- This module implements {{section link}}.
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
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(
"type error in argument #2 to '_main' " ..
"(string, table or nil expected, got %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 'Noter'
local display = '§ ' .. section
if isShowingPage then
page = page or title.prefixedText
display = page .. ' ' .. display
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 = '​ og '
else
conjunction = ', og '
end
ret = mw.text.listToText(ret, nil, conjunction)
-- Add the intro text.
local intro = '§§ '
if isShowingPage then
intro = (page or title.prefixedText) .. ' ' .. intro
end
ret = intro .. ret
return ret
end
end
function p.main(frame)
local args = require('Modul:Arguments').getArgs(frame, {
wrappers = 'Skabelon:Section link',
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 [[Modul:Arguments]]
-- when using pairs with deleted arguments.
page = v
elseif type(k) == 'number' then
sections[k] = v
else
options[k] = v
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