模块:Lyrics

来自科学ADV中文wiki
HimuL讨论 | 贡献2022年7月1日 (五) 19:47的版本
跳到导航 跳到搜索

介绍

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

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

参数

该模板目前有以下参数

  • 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:Arguments2').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 = 'Module:stylecss' } }

	return copyright .. css .. html
end

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

return p