模板讨论:注解

可能会适合使用本模板的情况

本模板文档建议避免使用本模板，而用<ref></ref>的形式撰写注释，但我认为在某些情况下使用本模板可能会有较大的优势：

当页面中有较多内容需要注解，尤其是系统性地需要注解时，使用<ref></ref>可能会造成页脚处有大量意义不明的注释，而用本模板可以较为美观地解决问题，例如爱蜜莉雅(公主连结)的历史版本。
有时用<ref></ref>会造成注解的范围有歧义，需要在注释中解释，比较啰嗦，而本模板不会遇到这个问题，例如：某活动将会举办两次，时间分别为5月20日和6月29日^(注)暂定。
当需要注解的内容出现在某些模板（例如页顶模板）中时，将注解放在页脚不一定合理。

如果大家普遍同意的话，希望能够把这些情况加到本模板的文档页，我们也可以再来考虑如何对本模板进行改进。--Bbbbbbbbba（讨论） 2021年6月15日 (二) 10:43 (CST)

题外话。不懂就问，移动设备网页版要怎么看这个注解？--Bete1geuse（1个标签：打嗝） 2021年6月15日 (二) 10:58 (CST)

@Bete1geuse 移动版会直接在上标的位置写出注解罢，大概像这样：

电脑版：BPM^(注)
手机版：BPM^{(Beat Per Minute，每分钟节拍数)}

——

GuoPC「信じよう　一人じゃないから　歩きだせる」 2021年6月15日 (二) 11:26 (CST)

摘录一下我在Help:注脚里写的，供参考：

“

该模板可以将需要注解的文字高亮化，并在鼠标悬停于文字时显示注解（PC版）或在右上角显示注解（移动版）。例如：

[[更新姬]]没有{{注解|欧派|胸部}}。
更新姬没有欧派^(注)胸部。

注意：

注解部分仅能使用纯文本而不能带有wikitext或HTML格式。
如果注解部分过长，在移动版的显示效果可能较差。
该模板的注解不会在<references />中列出。

因此，一般来说请优先使用上文的ref形式，尤其是想在注释中使用格式或注释部分过长时。

”

把优劣都列出来我觉得是好的。这两个模板文档页和帮助文档的内容可以同步一下。——C8H17OH（讨论） 2021年6月15日 (二) 12:46 (CST)

嗯，很合理，这个模板的文档页面确实明显是有些过时了，我一会可以编辑一下。

其实我刚刚又想起来，像TV Tropes那种note（平时显示为上标“note”，点击展开，并可以再次折叠）挺好的，在很多情况下可以代替黑幕刮刮乐，更美观更易读，要说缺点的话可能就是没有见过这种形式的新用户可能会不知道怎么操作（鼠标悬停时像正常的链接一样显示下划线应该会好一些）。相比之下现在这种注释在电脑版上需要一定时间悬停（比点击慢），在移动版上又会出现过长显示效果差的问题，当然这些也都不是什么大问题就是了。--Bbbbbbbbba（讨论） 2021年6月15日 (二) 14:10 (CST)

其实我有时候会用{{HideInline}}，不过迄今都是用在讨论页。——C8H17OH（讨论） 2021年6月15日 (二) 14:52 (CST)

编辑请求 - BearBin - 2023.06.14

由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 ；在萌百通过控制台测试效果如下：