模板:註解/doc

本模板已應用於10000+頁面。
為避免大規模的破壞及不必要的伺服器負荷，任何改動均應先在該模板對應的沙盒頁面或您自己的用戶頁下進行測試，並將測試無誤的代碼一次性地改動至本模板。
為尊重其他用戶，任何功能/兼容性改動在生效前都應先在討論頁進行討論。

本模板使用OOui實現，修改時請注意和全站JS/CSS的配合。

使用場景

用來高亮需要註解的文字，並在鼠標懸停於文字時顯示註解（手機版則為直接顯示）。

請注意，在萌娘百科為文字添加註釋的首選方式是註腳（即頁內<ref></ref>+頁腳<references/>的形式），只有在使用註腳的效果不理想的時候，才應當考慮使用本模板，主要包括以下幾種情況：

當頁面中有較多內容需要註解，尤其是系統性地需要註解時，使用<ref></ref>可能會造成頁腳處有大量意義不明的註釋，而用本模板可以較為美觀地解決問題。
- 例如：以無敵狀態^{(註)持續2.2秒}對面前的一名敵人突進；對目標造成大幅度^{(註)26*(技能等級+1)+2.1*魔法攻擊}的魔法傷害；對目標周圍^{(註)範圍450內}的敵人造成中幅度^{(註)24*(技能等級+1)+1.89*魔法攻擊}的魔法傷害。^[1]
有時用<ref></ref>會造成註解的範圍有歧義，需要在註釋中解釋，比較囉嗦，而本模板不會遇到這個問題。
- 例如：某活動將會舉辦兩次，時間分別為5月20日和6月29日^(註)暫定。
當需要註解的內容出現在某些模板（例如頁頂模板）中時，將註解放在頁腳不一定合理。

更多可選的解決方案及其優劣比較，請參見Help:註腳#相關模板。

代碼	效果
`你{{注解\|萝莉\|萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性}}！你全家都萝莉！`	你蘿莉^{(註)蘿莉通常是指出現在動漫中5-13歲的女性，或者擁有5-13歲女性外貌的女性}！你全家都蘿莉！
`我明天{{color\|green\|{{bgcolor\|black\|{{注解\|更新\|假的}}}}}}！`	我明天更新^(註)假的！

上述第二個例子中使用了{{color}}和{{bgcolor}}模板，但其中需註解文字的背景顏色和註釋角標的文字顏色分別被本模板覆蓋。如果需要更加精細的顏色控制，或需要修改註釋角標上的文字等，可以直接使用本模板所基於的{{高亮文字}}模板。