本模板文档建议避免使用本模板,而用<ref></ref>的形式撰写注释,但我认为在某些情况下使用本模板可能会有较大的优势:
<ref></ref>可能会造成页脚处有大量意义不明的注释,而用本模板可以较为美观地解决问题,例如爱蜜莉雅(公主连结)的历史版本。<ref></ref>会造成注解的范围有歧义,需要在注释中解释,比较啰嗦,而本模板不会遇到这个问题,例如:某活动将会举办两次,时间分别为5月20日和6月29日(注)暂定。如果大家普遍同意的话,希望能够把这些情况加到本模板的文档页,我们也可以再来考虑如何对本模板进行改进。--Bbbbbbbbba(讨论) 2021年6月15日 (二) 10:43 (CST)回复
摘录一下我在Help:注脚里写的,供参考:
| “ | 该模板可以将需要注解的文字高亮化,并在鼠标悬停于文字时显示注解(PC版)或在右上角显示注解(移动版)。例如:
注意:
|
” |
把优劣都列出来我觉得是好的。这两个模板文档页和帮助文档的内容可以同步一下。——C8H17OH(讨论) 2021年6月15日 (二) 12:46 (CST)回复
由BearBin提出的对Widget:Annotation和{{注解}}的编辑请求:
在Widget:Annotation(或其他名字的页面,随便想的名字)的主体新增以下内容:
<script>
"use strict";
window.RLQ = window.RLQ || [];
window.RLQ.push(async () => {
await mw.loader.using(["oojs-ui"]);
$(".annotation").each((_, ele) => {
const popup = new OO.ui.PopupWidget({
$content: $(ele).children(".annotation-content"),
padded: true,
autoFlip: false,
});
$(ele)
.append(popup.$element)
.on("mouseover", () => {
popup.toggle(true);
})
.on("mouseout", () => {
popup.toggle(false);
});
});
});
</script><style>
.annotation>span {
cursor: pointer;
}
.annotation .oo-ui-popupWidget {
z-index: 10;
}
.annotation .oo-ui-popupWidget-popup {
width: fit-content !important;
}
.annotation .oo-ui-popupWidget-body {
width: fit-content;
min-width: 5.5em;
max-width: 18em !important;
overflow: auto;
}
</style>
随后,将{{注解}}的内容改为
<includeonly><span style="background-color:{{{bgcolor|#F0FFB3}}}">{{{1|}}}</span><sup class="annotation"><span class="annotation-content">{{{2|}}}</span><span style="color:{{{color|blue}}}">(-{zh:注;zh-hans:注;zh-hant:註}-)</span></sup>{{#Widget:Annotation}}</includeonly><noinclude>{{Documentation}}</noinclude>
效果可见 https://moegirl.uk/_?curid=717899 ;在萌百通过控制台测试效果如下:
考虑到本模板数次被提及适配问题(如萌娘百科_talk:讨论版/提问求助/存档/2022年08月#关于模版“注解”({{注解}})),基于oojs-ui提出一种适配移动端实现方法。对于“是否存废此模板”和“是否选用ooui”不发表意见。
相比于原模板,除了适配以外,还额外支持了在参数2中使用wikitext,并且避免了出现>、"等符号时导致的解析错误。——
BearBin 「喷他 / 留名」 2023年6月14日 (三) 08:54 (CST)回复
由ばけもの提出的对Template:注解的编辑请求:
增加以下内容:
<span style="background-color:{{{bgcolor|#F0FFB3}}}">{{{1|}}}</span><sup class="annotation"><span style="color:{{{color|blue}}}">[''原文如此'']</span>{{#if:{{{2|}}}|<span class="annotation-content">应为“{{{2|}}}”。</span>}}</sup>
并且可以考虑逐步改进相关条目。我认为萌娘百科需要一个更规范的“原文如此”而并非简单的“注”字。——ばけもの(讨论) 2025年2月4日 (二) 21:51 (CST)回复
由FrzHrzn提出的对Template:注解的编辑请求:
将以下内容:
<span style="background-color:{{{bgcolor|#F0FFB3}}}">{{{1|}}}</span><sup class="annotation"><span style="color:{{{color|blue}}}">(-{zh:注;zh-hans:注;zh-hant:註}-)</span><span class="annotation-content">{{{2|}}}</span></sup>
修改为:
<span style="background-color:{{{bgcolor|#FFFF007F}}}">{{{1|}}}</span><sup class="annotation"><span style="color:{{{color|royalblue}}}">(-{zh:注;zh-hans:注;zh-hant:註}-)</span><span class="annotation-content">{{{2|}}}</span></sup>
深色模式下无法阅读,换用浅色深色模式下都相对可读的颜色:内容(注)注解,最好的方法是用light-dark()分别指定两种颜色,但moeskin还不支持这个——Frz(查 · 论 · 编) 2025年10月8日 (三) 20:47 (CST)回复