模板討論:註解

可能會適合使用本模板的情況

本模板文檔建議避免使用本模板，而用<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 ；在萌百通過控制台測試效果如下：