模組:TaxonList
外观
您可能想要创建本Scribunto模块的文档。 编者可以在本模块的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。 请在/doc子页面中添加分类。本模块的子页面。 |
--[[
This module provides the core functionality to a set of templates used to
display a list of taxon name/authority pairs, with the taxon names optionally
italicized, wikilinked and/or emboldened. Such lists are usually part of
taxoboxes.
]]
-- use a function from Module:TaxonItalics to italicize a taxon name
local TaxonItalics = require("Module:TaxonItalics")
local p = {}
--[[=========================================================================
Utility function to strip off any initial † present to mark the taxon as
extinct. The † must not be italicized, emboldened, or included in the
wikilinked text, so needs to be added back afterwards.
† is assumed to be present as one of:
* the unicode character †
* the HTML entity †
* the output of {{extinct}} – this will have been expanded before reaching this
module and is assumed to have the form '<span ... </span>'
The function returns two values: the taxon name with any † before it removed
and either '†' if it was present or the empty string if not.
=============================================================================]]
function p.stripDagger(taxonName)
local dagger = ''
if mw.ustring.sub(taxonName,1,1) == '†' then
taxonName = mw.ustring.sub(taxonName,2,#taxonName)
dagger = '†'
else
if string.sub(taxonName,1,8) == '†' then
taxonName = string.sub(taxonName,9,#taxonName)
dagger = '†'
else
-- did the taxon name originally have {{extinct}} before it?
if (string.sub(taxonName,1,5) == '<span') and mw.ustring.find(taxonName, '†') then
taxonName = string.gsub(taxonName, '^.*</span>', '', 1)
dagger = '†'
end
end
end
return taxonName, dagger
end
function p.stripBullet(taxonName)
if mw.ustring.sub(taxonName,1,1) == '*' then
taxonName = mw.ustring.sub(taxonName,2,#taxonName)
end
return taxonName
end
--[[=========================================================================
The function returns a list of taxon names and authorities, appropriately
formatted.
Usage:
{{#invoke:TaxonList|main
|italic = yes - to italicize the taxon name
|linked = yes - to wikilink the taxon name
|bold = yes - to emboldent the taxon name
|incomplete = yes - to output "(incomplete)" at the end of the list
}}
The template that transcludes the invoking template must supply an indefinite
even number of arguments in the format
|Name1|Author1 |Name2|Author2| ... |NameN|AuthorN
=============================================================================]]
function p.main(frame)
local italic = frame.args['italic'] == 'yes'
local bold = frame.args['bold'] == 'yes'
local linked = frame.args['linked'] == 'yes'
if bold then linked = false end -- must not have bold and wikilinked
local incomplete = frame.args['incomplete'] == 'yes'
local taxonArgs = frame:getParent().args
local result = ''
-- iterate over unnamed variables
local taxonName
local dagger
local first = true -- is this the first of a taxon name/author pair?
for param, value in pairs(taxonArgs) do
if tonumber(param) then
if first then
taxonName = mw.text.trim(value)
taxonName = p.stripBullet(taxonName) -- remove '*' used in old method
-- if necessary separate any initial † from the taxon name
if linked or italic or bold then
taxonName, dagger = p.stripDagger(taxonName)
else
dagger = ''
end
if linked and not italic then
taxonName = '[[' .. taxonName .. ']]'
end
if italic then
taxonName = TaxonItalics.italicizeTaxonName(taxonName, linked)
end
if bold then
taxonName = '<b>' .. taxonName .. '</b>'
end
result = result .. '<li>' .. dagger .. taxonName
else
result = result .. ' <small>' .. value .. '</small></li>'
end
first = not first
end
end
if incomplete then
result = result .. '<small>(不完整列表)</small>'
end
return '<ul style="plainlist">' .. result .. '</ul>'
end
--[[=========================================================================
此為本地化三項式(中文名、學名、作者)列表
用法如下:
{{#invoke:TaxonList|common
|italic = yes - 將學名斜寫
|linked = yes - 為中文名添加內部鏈接
|bold = yes - 粗體字
|incomplete = yes - 註明非完整列表
}}
相關模板必須依照下列次序來排列
|中文名1 |學名1 |作者1 |中文名2 |學名2 |作者2 | ... |中文名N |學名N |作者N
=============================================================================]]
function p.common(frame)
local italic = frame.args['italic'] == 'yes'
local bold = frame.args['bold'] == 'yes'
local linked = frame.args['linked'] == 'yes'
if bold then linked = false end -- 預設粗體時則不加內部鏈接
local incomplete = frame.args['incomplete'] == 'yes'
local taxonArgs = frame:getParent().args
local result = ''
-- iterate over unnamed variables
local taxonName
local dagger
local emptyCommon = false -- 中文名存在否
local item = 1 -- 用以區分中文名、學名與作者欄目
for param, value in pairs(taxonArgs) do
if tonumber(param) then
if item == 1 then -- 中文名欄目
taxonName = mw.text.trim(value)
taxonName = p.stripBullet(taxonName) -- 移除舊式用法中可能存在的開頭“*”號
-- 必要時將開頭的†號與名稱分開處理
if linked or bold then
taxonName, dagger = p.stripDagger(taxonName)
else
dagger = ''
end
if linked and taxonName ~='' and taxonName ~=' ' and taxonName ~=' ' then
taxonName = '[[' .. taxonName .. ']]'
emptyCommon = false
else
emptyCommon = true
end
if bold then
taxonName = '<b>' .. taxonName .. '</b>'
end
result = result .. '<li>' .. dagger .. taxonName
end
if item == 2 then -- 學名欄目
taxonName = mw.text.trim(value)
taxonName = p.stripBullet(taxonName) -- 移除舊式用法中可能存在的開頭“*”號
--必要時將任何開頭的†號與名稱分開處理
if italic or bold then
taxonName, dagger = p.stripDagger(taxonName)
else
dagger = ''
end
if italic then
taxonName = TaxonItalics.italicizeTaxonName(taxonName, emptyCommon)
end
if linked and not italic and emptyCommon then
taxonName = '[[' .. taxonName .. ']]'
end
if bold then
taxonName = '<b>' .. taxonName .. '</b>'
end
result = result .. ' ' .. dagger .. taxonName
end
if item == 3 then -- 作者欄目
result = result .. ' <small>' .. value .. '</small></li>'
end
if item == 3 then
item = 1
else
item = item + 1
end
end
end
if incomplete then
result = result .. '<small>(不完整列表)</small>'
end
return '<ul style="plainlist">' .. result .. '</ul>'
end
return p