模板: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| ##第三行歌词对齐第二行的结尾| 第四行歌词对齐第一行的“####” }} }}
效果:
本段落中所使用的歌詞,其著作權屬於原著作權人,僅以介紹為目的引用。
不僅可以對齊含有中英文及符號等不等寬字符的文本,還可以是帶有{{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
的效果。
參考
實際用例可以參考:我們存在的理由等