模块:Lyrics

本模板已应用于12000+页面。
为避免大规模的破坏及不必要的服务器负荷，进行任何改动前请在沙盒模板内，或您自己的用户页内测试，确认代码无误后再一次性地改动本模板。
为尊重其他用户，任何功能性 / 兼容性改动在生效前都应先在讨论页进行讨论。

该模块提供了一种简便的创建大段带翻译歌词的方法。

该模板便会为您按照行一一对应的关系生成原文和译文的对照。在高分辨率情况下，这会是左右对齐的对照。在低分辨率，原文译文会各占一行。该模块对应的模板是{{LyricsKai}}。

若要在歌词中使用多种颜色来分辨不同的演唱者，请参考使用{{LyricsKai/colors}}。注意：不建议在只有单个演唱者的歌曲条目中使用该模板。

若歌词有多个翻译版本歌词，请参考使用{{LyricsKai/multi}}。

若需要全文添加罗马字，请参考使用{{LyricsKai/Roma}}。

若要实现当指针悬停于歌词上时改变歌词背景颜色，请参考使用{{LyricsKai/hover}}。

参数

该模板目前有以下参数

• original: 歌词原文。
• translated: 歌词译文。歌词原文和译文的行数需要匹配。
• llang: 原文语言标签。不指定时默认为日语（ja）。请参考Help:语言标签。
• rlang: 译文语言标签。不指定是默认为中文（zh）。格式同上。
• lstyle: 原文部分的样式。颜色等样式可以在这里指定。
• rstyle: 译文部分的样式。颜色等样式可以在这里指定。
• width：設計模板的寬度，默認為100%
• containerstyle：对整个容器应用的样式。背景颜色等同时作用于原文和译文部分的样式可以在这里指定。

此外，还有与著作权标记相关的两个参数：

• author: 词作者/歌曲版权所有者，如果在站内有条目的可以写成内链的形式。
• override: 当且仅当值为“1”时隐藏著作权标记，请只在该模板被用于非歌词场合或重复标记时使用。

使用方法

{{LyricsKai
|lstyle=color:左边字体颜色;
|rstyle=color:右边字体颜色;
|original=
原文
|translated=
译文
}}

背景颜色示例

上面一个例子示范了更改字体颜色，这个例子用于更改整个歌词部分的背景色。

{{LyricsKai
|containerstyle=background:背景颜色;
|original=
原文
|translated=
译文
}}

例子

U&I 是一个现成的使用{{LyricsKai}}的例子。

---

local p = {}

local getArgs = require('Module:Arguments').getArgs
local lang = require('Module:Lang')

function p._lyrics(args)
	local orig, tran = nil, nil

	-- 适用Template:LyricsKai/colors
	if args.colorsMode then
		orig = args.original
		if args.colorsMode == '2' then
			tran = args.translated
		end
	end

	--mw.text.split的效率太低啦，我愿称之为shit
	if not orig then
		orig = {}
		local iter = mw.ustring.gmatch((args.original or '')..'\n', '([^\n]*\n)')
		for val in iter do
			table.insert(orig, val)
		end
	end
	if not tran then
		tran = {}
		local iter = mw.ustring.gmatch((args.translated or '')..'\n', '([^\n]*\n)')
		for val in iter do
			table.insert(tran, val)
		end
	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 or 'calc(100% - ' .. (args.reserveWidth or '0px') .. ');') )
					: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 len = math.max(#orig, #tran)

	for i=1,len do
		html
			:tag('div')
			:addClass('Lyrics-line')
				:tag('div')
					:addClass('Lyrics-original')
					:cssText(lstyle)
					:node(lang.wrap(orig[i] or '', llang))
					:done()
				:tag('div')
					:addClass('Lyrics-translated')
					:cssText(rstyle)
					:node(lang.wrap(tran[i] or '', rlang))
					:done()
	end

	-- Clear the floating
	html:tag('div'):cssText('clear:both')

	return tostring(html)
end

function p.lyrics(frame)
	local args = getArgs(frame, {wrappers='Template:LyricsKai'})
	return p._lyrics(args)
end

return p