模块文档
该模块提供了一种简便的创建大段带翻译歌词的方法。
该模板便会为您按照行一一对应的关系生成原文和译文的对照。在高分辨率情况下，这会是左右对齐的对照。在低分辨率，原文译文会各占一行。该模块对应的模板是{{LyricsKai}}。
若要在歌词中使用多种颜色来分辨不同的演唱者，请参考使用{{LyricsKai/colors}}。注意：不建议在只有单个演唱者的歌曲条目中使用该模板。
若歌词有多个翻译版本歌词，请参考使用{{LyricsKai/multi}}。
若需要全文添加罗马字，请参考使用{{LyricsKai/Roma}}。
若要实现当指针悬停于歌词上时改变歌词背景颜色，请参考使用{{LyricsKai/hover}}。
参数
该模板目前有以下参数
- original: 歌词原文。
- translated: 歌词译文。歌词原文和译文的行数需要匹配。
- llang: 原文语言标签。不指定时默认为日语（ja）。请参考Help:语言标签。
- rlang: 译文语言标签。不指定是默认为中文（zh）。格式同上。
- lstyle: 原文部分的样式。颜色等样式可以在这里指定。
- rstyle: 译文部分的样式。颜色等样式可以在这里指定。
- width：设计模板的宽度，默认为100%
- containerstyle：对整个容器应用的样式。背景颜色等同时作用于原文和译文部分的样式可以在这里指定。
此外，还有与著作权标记相关的两个参数：
- author: 词作者/歌曲版权所有者，如果在站内有条目的可以写成内链的形式。
- override: 当且仅当值为“1”时隐藏著作权标记，请只在该模板被用于非歌词场合或重复标记时使用。
使用方法
※注意：如果你尝试更改样式（lstyle、rstyle、containerstyle），请注意使用半角冒号以及分号。
{{LyricsKai
|lstyle=color:左边字体颜色;
|rstyle=color:右边字体颜色;
|original=
原文
|translated=
译文
}}
背景颜色示例
上面一个例子示范了更改字体颜色，这个例子用于更改整个歌词部分的背景色。
{{LyricsKai
|containerstyle=background:背景颜色;
|original=
原文
|translated=
译文
}}
例子
local p = {}
local getArgs = require('Module:Arguments').getArgs
local lang = require('Module:Lang')
function p._lyrics(args, hookTrigger, customArgs)
local original = args.original or ''
local translated = args.translated or ''
if hookTrigger then
original, translated = hookTrigger('preSplit', original, translated, customArgs)
end
--mw.text.split的效率太低啦，我愿称之为shit
local orig = {}
local iter = mw.ustring.gmatch(original..'\n', '([^\n]*)\n')
for val in iter do
table.insert(orig, val)
end
local tran = {}
local iter = mw.ustring.gmatch(translated..'\n', '([^\n]*)\n')
for val in iter do
table.insert(tran, val)
end
local llang = args.llang or 'ja'
local rlang = args.rlang or 'zh'
local lstyle = args.lstyle or ''
local rstyle = args.rstyle or ''
local html = mw.html.create('div')
:addClass('Lyrics')
:css('width', args.width)
:cssText(args.containerstyle or '')
if ((args['hasRuby'] or '') ~= '') or (not args.colorsMode and (args.original or ''):find('<ruby')) then
html:addClass('Lyrics-has-ruby')
else
html:addClass('Lyrics-no-ruby')
end
local hastran = true
if #tran == 1 and tran[1] == '' then
hastran = false
else
html:addClass('Lyrics-has-translate')
end
if hookTrigger then
hookTrigger('preParse', orig, hastran and tran or false, customArgs)
end
local lines = {}
local len = math.max(#orig, #tran)
for i=1, len do
local line = mw.html.create('div'):addClass('Lyrics-line')
:tag('div')
:addClass('Lyrics-original')
:cssText(lstyle)
:node(lang.wrap(orig[i] or '', llang))
:done()
if hastran then
line:tag('div')
:addClass('Lyrics-translated')
:cssText(rstyle)
:node(lang.wrap(tran[i] or '', rlang))
:done()
end
table.insert(lines, tostring(line))
end
if hookTrigger then
hookTrigger('postParse', lines, customArgs)
end
html:node(table.concat(lines))
-- Clear the floating
html:tag('div'):cssText('clear:both')
html = tostring(html)
if hookTrigger then
html = hookTrigger('preOutput', html, customArgs)
end
local copyright = ''
local frame = mw.getCurrentFrame()
local LDC = frame:callParserFunction{ name = '#var', args = { 'LDC', '0' } }
if LDC ~= '1' and args.override ~= '1' then
copyright = '<small>本段落中所使用的歌词，其著作权属于' .. (args.author or '原著作权人') .. '，仅以介绍为目的引用。</small>'
elseif LDC == '1' and args.override == '1' then
copyright = frame:expandTemplate{ title = 'ac', args = { '不必要使用override参数的音乐条目' } }
end
local css = frame:extensionTag{ name = 'templatestyles', args = { src = 'Template:LyricsKai/styles.css' } }
return copyright .. css .. html
end
function p.lyrics(frame)
local args = getArgs(frame, {wrappers='Template:LyricsKai'})
return p._lyrics(args)
end
return p