模板: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的效果。

參考

實際用例可以參考：我們存在的理由等