Template:Utawari

模板文档  

这个文档嵌入自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：是否开启歌词模式。歌词模式详见#歌词模式与#非歌词模式章节。
  • （默认）当值为on时，开启歌词模式。
  • 否则关闭歌词模式。
• newline：模板的换行方式。
  • 当值为html时，模板的换行行为是添加一个HTML的换行标签<br/>。
  • （默认）否则模板的换行行为是添加两个“回车换行符（\r\n）”。
  • 注意：此参数必须在非歌词模式下才能发挥作用。
• 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中的换行可以通过添加两个“回车换行符（\r\n）”或添加一个HTML的换行标签<br/>，因此此模板也提供了一系列预设的换行方式选项。

值为html时

当设置参数newline为html时，模板的换行行为是添加一个HTML的换行标签<br/>。
当设置参数newline为除html外的任意值时，模板的换行行为是添加两个“回车换行符（\r\n）”。为了直观可阅读性，建议设置的值为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外的任意值时，模板的换行行为是添加两个“回车换行符（\r\n）”。为了直观可阅读性，建议设置的值为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外的任意值时，模板的换行行为是添加两个“回车换行符（\r\n）”。为了直观可阅读性，建议设置的值为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的效果。

参考

实际用例可以参考：我们存在的理由等