Template:Utawari/doc
跳到导航
跳到搜索
简介
此模板是针对{{LyricsKai}}/{{LyricsKai/colors}}模板家族设计的格式扩展模板。主要用于简便地书写歌割り对齐的歌词。（当然你可以在其他需要对齐的地方使用这个模板。）
在超过9句歌割り歌词时，建议使用模块:Utawari。
根据2018年11月19日-2018年11月22日关于宽屏/窄屏缩进行为的讨论，目前的效果为：
- 歌词模式下：
- 宽屏设备浏览时显示缩进；
- 窄屏设备浏览时隐藏缩进。
- 非歌词模式下：
- 宽屏/窄屏设备浏览时均显示缩进。
参数
使用格式：
{{Utawari[|lyricMode=on][|newline=wiki][|lineSeparator=][|mainLineNum=1][|第一行歌词[|第二行歌词|...[|第九行歌词]]]}}
- 或者更加直观易读且在原{{LyricsKai}}/{{LyricsKai/colors}}基础上改动最小的格式：
{{Utawari[|mainLineNum=1][|lyricMode=on][|newline=wiki][|lineSeparator=][|
第一行歌词[|
第二行歌词[|
...[|
第九行歌词]]]
}}
- 注意：你可以什么参数也不加：
{{Utawari}}，那么模板什么也不会输出。不过这有什么意义呢？（ ）
lyricMode：是否开启歌词模式。歌词模式详见#歌词模式与#非歌词模式章节。newline：模板的换行方式。- 当值为
html时，模板的换行行为是添加一个HTML的换行标签<br/>。 - （默认）否则模板的换行行为是添加两个“
回车换行符（ ）”。 - 注意：此参数必须在非歌词模式下才能发挥作用。
- 当值为
lineSeparator：模板的自定义换行字符串。- 当值为非空时，参数
newline将会失去作用。 - 注意：此参数必须在非歌词模式下才能发挥作用。
- 当值为非空时，参数
mainLineNum：歌割中的主要部分在整个匿名参数列表中的位置。
- 这是一个非功能性参数。换句话说，这个参数的任何值都不会对模板的输出产生任何影响。
- 将此参数添加在此模板文档中，仅为了让使用者明白自己编辑的歌割中的主体部分是哪一行，即形式意义大于使用意义。实际上从目前的实现代码来讲，根本没有编写处理这个参数的代码。不排除在后续更新版本中添加对这个参数的支持的可能性。
（各行歌词）（ ） = 歌割中的和声部分。这部分参数兼容{{LyricsKai}}/{{LyricsKai/colors}}的使用格式，更高阶的拓展格式请见#用法章节。
用法
歌词模式
为了与{{LyricsKai/colors}}使用的转义字符'@'区分，此模板使用'#'作为转义字符。
通过在任意一行歌词中添加#n（其中n为一个正整数），标识第n行歌词的开头对齐的位置。
范例：
{{LyricsKai/colors
|original=
{{Utawari|mainLineNum=1|
第一行#2歌#4词|
第二行歌词#3|
第三行歌词对齐第二行的结尾|
第四行歌词对齐第一行的“词”
}}
}}
效果：
本段落中所使用的歌词，其著作权属于原著作权人，仅以介绍为目的引用。
第一行歌词
第一行第二行歌词
第一行第二行歌词第三行歌词对齐第二行的结尾
第一行歌第四行歌词对齐第一行的“词”
若希望在歌词中正常使用#符号，则在前面再写添加一个#符号写成##。
范例：
{{LyricsKai/colors
|original=
{{Utawari|mainLineNum=1|
第一行#2歌词→#4####←这里有两个“#”|
第二行歌词的标识是##2#3|
##第三行歌词对齐第二行的结尾|
第四行歌词对齐第一行的“####”
}}
}}
效果：
本段落中所使用的歌词，其著作权属于原著作权人，仅以介绍为目的引用。
第一行歌词→##←这里有两个“#”
第一行第二行歌词的标识是#2
第一行第二行歌词的标识是#2#第三行歌词对齐第二行的结尾
第一行歌词→第四行歌词对齐第一行的“##”
不仅可以对齐含有中英文及符号等不等宽字符的文本，还可以是带有{{ruby}}这样的自由宽高度的文本。
范例
{{LyricsKai/colors
|lstyle=color:black
|colors= <!--1 爱城华恋-->#FB5458; <!--
2 神乐光-->#6292E9; <!--
3 天堂真矢-->#CBC6CC; <!--
4 星见纯那-->#95CAEE; <!--
5 露崎真昼-->#61BF99; <!--
6 大场奈奈-->#FDD162; <!--
7 西条克洛迪娜-->#FE9952; <!--
8 石动双叶-->#8C67AA; <!--
9 花柳香子-->#E08696; <!--
10 真昼、真矢、克洛、奈奈、香子、纯那-->lg(60deg, #61BF99, #CBC6CC, #FE9952, #FDD162, #E08696, #95CAEE); <!--
11 真昼、真矢、克洛、香子、纯那、双叶-->co(#61BF99, #CBC6CC, #FE9952, #E08696, #95CAEE, #8C67AA); <!--
12 真昼、真矢、克洛、奈奈、香子、纯那、双叶-->lg(60deg, #61BF99, #CBC6CC, #FE9952, #FDD162, #E08696, #95CAEE, #8C67AA); <!--
13 真昼、真矢、克洛、奈奈、香子、纯那、双叶、华恋-->co(#61BF99, #CBC6CC, #FE9952, #FDD162, #E08696, #95CAEE, #8C67AA, #FB5458);
|charas= 爱城华恋；神乐光；天堂真矢；星见纯那；露崎真昼；大场奈奈；西条克洛迪娜；石动双叶；花柳香子；露崎真昼&天堂真矢&西条克洛迪娜&大场奈奈&花柳香子&星见纯那；露崎真昼&天堂真矢&西条克洛迪娜&花柳香子&星见纯那&石动双叶；露崎真昼&天堂真矢&西条克洛迪娜&大场奈奈&花柳香子&星见纯那&石动双叶；露崎真昼&天堂真矢&西条克洛迪娜&大场奈奈&花柳香子&星见纯那&石动双叶&爱城华恋；全员
|reserveWidth=260px
|traColors= on
|charaBlock= off
|groupName= 合唱
|original=
{{Utawari|
@1{{ruby|大切|たいせつ}}な{{ruby|人|ひと}}と#2|
@9{{ruby|一人|ひとり}}じゃない
}}
{{Utawari|
@1{{ruby|夢|ゆめ}}の{{ruby|舞台|ぶたい}}#2へと|
@5{{ruby|恐怖|きょうふ}}を
}}
{{Utawari|
@1ライト#2を{{ruby|浴|あ}}びるまで#3|
@8{{ruby|打|う}}ち{{ruby|破|やぶ}}って|
@3{{ruby|負|ま}}けられない{{ruby|自分|じぶん}}に
}}
{{Utawari|
@1{{ruby|諦|あきら}}め#2ない|
@7{{ruby|強|つよ}}くなりたいから
}}
@1{{ruby|私|わたし}}がここに{{ruby|居|い}}る{{ruby|理由|わけ}}
{{Utawari|
@4{{ruby|私|わたし}}の#2{{ruby|答|こた}}えなんて|
@1{{ruby|答|こた}}えなんてきっと#3{{ruby|一|ひと}}つじゃない|
@12{{ruby|私|わたし}}だけの{{ruby|何|なに}}かを
}}
|translated=
{{Utawari|
@1与重要的人#2|
@9并不是一个人
}}
{{Utawari|
@1在梦想的舞台#2上|
@5恐惧
}}
{{Utawari|
@1直到#2在灯光下沐浴为止#3|
@8打破吧@|
@3对着不服输的自己
}}
{{Utawari|
@1决不#2放弃|
@7因为想要变强
}}
@1我在这里的理由
{{Utawari|
@4我的#2答案|
@1答案一定不会#3只有一个|
@12只有我拥有的什么
}}
}}
效果
本段落中所使用的歌词，其著作权属于原著作权人，仅以介绍为目的引用。大切（ ）な人（ ）と
大切（ ）な人（ ）と一人（ ）じゃない夢（ ）の舞台（ ）へと
夢（ ）の舞台（ ）恐怖（ ）を諦（ ）めない
諦（ ）め強（ ）くなりたいから私（ ）がここに居（ ）る理由（ ）私（ ）の答（ ）えなんて
私（ ）の答（ ）えなんてきっと一（ ）つじゃない
私（ ）の答（ ）えなんてきっと私（ ）だけの何（ ）かを
与重要的人
与重要的人并不是一个人
在梦想的舞台上
在梦想的舞台恐惧
ライトを浴（ ）びるまで
直到在灯光下沐浴为止
ライト打（ ）ち破（ ）って
直到打破吧
ライトを浴（ ）びるまで負（ ）けられない自分（ ）に
直到在灯光下沐浴为止对着不服输的自己
决不放弃
决不因为想要变强
我在这里的理由
我的答案
我的答案一定不会只有一个
我的答案一定不会只有我拥有的什么
非歌词模式
虽然推荐和{{LyricsKai}}/{{LyricsKai/colors}}组合使用本模板，但实际上模板也可以在非歌词模式下使用。
只需要将参数lyricMode设置为除on外的任意值。为了直观可阅读性，建议设置的值为off。
范例：
{{Utawari|lyricMode=off|
a##b#2c#4d|
e#3f|
g####h|
##ij##
}}
效果：
a#bcd
a#bef
a#beg##h
a#bc#ij#
另外，由于在wiki中的换行可以通过添加两个“<br/>，因此此模板也提供了一系列预设的换行方式选项。
值为
html时当设置参数
当设置参数回车换行符（ ）”。为了直观可阅读性，建议设置的值为
当不设置此参数时，模板的换行行为等同于设置为
newline为html时，模板的换行行为是添加一个HTML的换行标签<br/>。当设置参数
newline为除html外的任意值时，模板的换行行为是添加两个“wiki。当不设置此参数时，模板的换行行为等同于设置为
wiki。
上方这段说明的wiki代码为：
{{Utawari|lyricMode=off|newline=html|
当设置参数<code>newline</code>为#2<code>html</code>时，模板的换行行为是添加一个HTML的换行标签<code><br/></code>。|
除<code>html</code>外的任意值时，模板的换行行为是添加两个“{{ruby|回车换行符|<code>\r\n</code>}}”。'''为了直观可阅读性，建议设置的值为<code>wiki</code>。'''|
'''''当不设置此参数时，模板的换行行为等同于设置为<code>wiki</code>。'''''
}}
值为
wiki时当设置参数
newline为html时，模板的换行行为是添加一个HTML的换行标签<br/>。
当设置参数newline为除html外的任意值时，模板的换行行为是添加两个“wiki。
当不设置此参数时，模板的换行行为等同于设置为wiki。
上方这段说明的wiki代码为：
{{Utawari|lyricMode=off|newline=wiki|
当设置参数<code>newline</code>为#2<code>html</code>时，模板的换行行为是添加一个HTML的换行标签<code><br/></code>。|
除<code>html</code>外的任意值时，模板的换行行为是添加两个“{{ruby|回车换行符|<code>\r\n</code>}}”。'''为了直观可阅读性，建议设置的值为<code>wiki</code>。'''|
'''''当不设置此参数时，模板的换行行为等同于设置为<code>wiki</code>。'''''
}}
值为自定义值时
略|当设置参数
略|当设置参数回车换行符（ ）”。为了直观可阅读性，建议设置的值为
略|当不设置此参数时，模板的换行行为等同于设置为
newline为html时，模板的换行行为是添加一个HTML的换行标签<br/>。略|当设置参数
newline为除html外的任意值时，模板的换行行为是添加两个“wiki。略|当不设置此参数时，模板的换行行为等同于设置为
wiki。
上方这段说明的wiki代码为：
{{color|red|'''略'''}}{{color|darkblue|{{!}}}}{{Utawari|lyricMode=off|lineSeparator=<br/>{{color|red|'''略'''}}{{color|darkblue|{{!}}}}|
当设置参数<code>newline</code>为#2<code>html</code>时，模板的换行行为是添加一个HTML的换行标签<code><br/></code>。|
除<code>html</code>外的任意值时，模板的换行行为是添加两个“{{ruby|回车换行符|<code>\r\n</code>}}”。'''为了直观可阅读性，建议设置的值为<code>wiki</code>。'''|
'''''当不设置此参数时，模板的换行行为等同于设置为<code>wiki</code>。'''''
}}
点这里！点这里！
略略略~
两种预设换行方式的效果不同，值为wiki时行间距明显比值为html时大。实际使用时可以配合制作出多样的效果。
除了预设换行方式外，模板还提供了自定义换行字符串的功能。
通过设置参数lineSeparator为自定义的值，可以制作出意想不到的效果。注意：设置此参数为非空值后，将会覆盖参数newline的效果。
参考
实际用例可以参考：我们存在的理由等