Template:AdvancedSiteNotices/doc：修订间差异

以互动方式浏览历史

←上一版本

删除的内容添加的内容

可视化wikitext

行内

2022年9月2日 (五) 17:21的最新版本

此頁面是Template:AdvancedSiteNotices的Template文档。
此頁面可能包含了模板的使用說明、分類和其他内容。

用法

添加一项通告时，请将通告填写在源代码内的{{AdvancedSiteNotices/core}}模板内。假如修改前的源代码为：

{{AdvancedSiteNotices/core|
  {{AdvancedSiteNotices/item|欢迎来到维基百科}}
}}

修改后的源代码将类似于下面的代码：

{{AdvancedSiteNotices/core|
  {{AdvancedSiteNotices/item|欢迎来到维基百科}}
  {{AdvancedSiteNotices/item|你好，世界}}
}}

{{AdvancedSiteNotices/item}}的参数

{{AdvancedSiteNotices/item}}有两个匿名参数和一个命名参数：{{{1}}}为必填参数，填写通告的实际内容；{{{2}}}和{{{criteria}}}为选填参数，可以定义通告面向的人群：

  {{AdvancedSiteNotices/item|{{{1}}}|{{{2}}}|criteria={{{criteria}}}}}

参数{{{criteria}}}应为一个有效的JavaScript表达式，在执行时提供以下测试函数。当没有填写时，将使用参数{{{2}}}。

in_country - 测试用户所在国家或地区
in_region - 测试用户所在主要行政区
in_city - 测试用户所在城市
in_group - 测试用户所在用户组

参数{{{2}}}有多种模式，各种模式可以混用，并以空格分隔：

only_sysop - 只对管理员显示
only_logged - 只对登录用户显示
only_anon - 只对匿名用户显示
only_zh_cn - 只对大陆用户显示
only_zh_hk - 只对香港和澳门用户显示
only_zh_sg - 只对新加坡和马来西亚用户显示
only_zh_tw - 只对台湾用户显示

实际用例：

{{AdvancedSiteNotices/item|[[Wikipedia:聚会/2010年台灣秋聚|'''2010年台灣維基人秋聚''']]與[[Wikipedia_talk:聚会/2010上海夏聚|'''2010年上海维基人夏聚''']]圓滿落幕。|criteria=in_country('TW') {{!!}} in_country('CN') && in_city('Shanghai')}}
{{AdvancedSiteNotices/item|维基媒体基金会推出了“只有权限较高的好孩子知道的功能”。|criteria=in_group('rollbacker') {{!!}} in_group('patroller') {{!!}} in_group('sysop') {{!!}} in_group('autoreviewer')}}

注意事項

如在公告包含其他模板，而該模板的內容會在不用編輯的情況下自動更新（如倒數），您可能需要清除ajax頁面的緩存，內容才會更新。要清除緩存，請點選此處。
如需查詢目前公告的顯示性質，請至Template:AdvancedSiteNotices/viewer。
本頁面目前被全保護－需要在公告中加入內容的用戶請到Template_talk:AdvancedSiteNotices提出請求，由管理員代為加入。

參見

MediaWiki:Gadget-AdvancedSiteNotices.js

@@ 第1行： / 第1行： @@
-<includeonly>{{pp-template}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
+<includeonly><!-- /ajax --></includeonly><noinclude>{{Documentation subpage}}</noinclude>
 <!-- 在本行下編輯模板說明 -->
+{{For|英语维基模板[[:en:Template:ASN|Template:ASN]]|Template:ASNet}}
-存档时，请存档到[[Wikipedia:公告欄/存檔]]。
 == 用法 ==
 添加一项通告时，请将通告填写在源代码内的{{tl|AdvancedSiteNotices/core}}模板内。假如修改前的源代码为：
-<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
+<pre style="background: #F9F9F9; border: 1px dashed #2F6FAB;">
-&#123;{AdvancedSiteNotices/core|<br />
+&#123;{AdvancedSiteNotices/core|
-&nbsp;&nbsp;&#123;{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}&#125;<br />
+&nbsp;&nbsp;&#123;{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}&#125;
 }&#125;
-</div>
+</pre>
 修改后的源代码将类似于下面的代码：
+ -{}-&#123;{AdvancedSiteNotices/core{{!}}
-<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
-&#123;{AdvancedSiteNotices/core|<br />
+ &nbsp;&nbsp;&#123;{AdvancedSiteNotices/item{{!}}欢迎来到维基百科}&#125;
-&nbsp;&nbsp;&#123;{AdvancedSiteNotices/item|欢迎来到维基百科}&#125;<br />
+ <span style="color:darkgreen;">&nbsp;&nbsp;'''&#123;{AdvancedSiteNotices/item{{!}}你好，世界}&#125;'''</span>
+ }&#125;<!-- |style="background: #F9F9F9; border: 1px dashed #2F6FAB;"|class=mw-code -->
-<span style="color:darkgreen;">&nbsp;&nbsp;'''&#123;{AdvancedSiteNotices/item|你好，世界}&#125;'''</span><br />
-}&#125;
-</div>
 === &#123;{AdvancedSiteNotices/item}&#125;的参数 ===
 &#123;{AdvancedSiteNotices/item}&#125;有两个匿名参数和一个命名参数：'''<span style="color:#FF00FF;">{&#123;{1}&#125;}</span>'''为必填参数，填写通告的实际内容；'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''和'''<span style="color:#FF00FF;">{&#123;{criteria}&#125;}</span>'''为选填参数，可以定义通告面向的人群：
+<!--<pre style="background: #F9F9F9; border: 1px dashed #2F6FAB">-->
+ &nbsp;&nbsp;&#123;{AdvancedSiteNotices/item|'''<span style="color:#F-F00FF;">{&#123;{1}&#125;}</span>'''|'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''|'''criteria=<span style="color:#FF00FF;">{&#123;{criteria}&#125;}</span>'''}&#125;
+参数'''<span style="color:#FF00FF;">{&#123;{criteria}&#125;}</span>'''应为一个有效的JavaScript表达式，在执行时提供以下测试函数。当没有填写时，将使用参数'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''。
 <div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
+* <span style="color:blue;">in_country</span> - 测试用户所在[[ISO 3166-1|国家或地区]]
-&nbsp;&nbsp;&#123;{AdvancedSiteNotices/item|'''<span style="color:#FF00FF;">{&#123;{1}&#125;}</span>'''|'''<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''|'''criteria=<span style="color:#FF00FF;">{&#123;{2}&#125;}</span>'''}&#125;
+* <span style="color:blue;">in_region</span> - 测试用户所在[[ISO 3166-2|主要行政区]]
+* <span style="color:blue;">in_city</span> - 测试用户所在城市
+* <span style="color:blue;">in_group</span> - 测试用户所在用户组
 </div>
@@ 第29行： / 第35行： @@
 * <span style="color:blue;">only_logged</span> - 只对登录用户显示
 * <span style="color:blue;">only_anon</span> - 只对匿名用户显示
-* <span style="color:blue;">only_zh</span> - 只在不转换模式下显示（罕用）
+* <span style="color:blue;">only_zh_cn</span> - 只对大陆用户显示
-* <span style="color:blue;">only_zh_hans</span> - 只在简体模式（不包括大陆简体和新马简体）下显示（罕用）
+* <span style="color:blue;">only_zh_hk</span> - 只对香港和澳门用户显示
-* <span style="color:blue;">only_zh_hant</span> - 只在繁体模式（不包括台湾正体和香港繁体）下显示（罕用）
+* <span style="color:blue;">only_zh_sg</span> - 只对新加坡和马来西亚用户显示
-* <span style="color:blue;">only_zh_cn</span> - 只在大陆简体下显示
+* <span style="color:blue;">only_zh_tw</span> - 只对台湾用户显示
-* <span style="color:blue;">only_zh_hk</span> - 只在香港繁体下显示
-* <span style="color:blue;">only_zh_sg</span> - 只在新马简体下显示
-* <span style="color:blue;">only_zh_tw</span> - 只在台湾正体下显示
 </div>
 实际用例：
-<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
+<pre style="background: #F9F9F9; border: 1px dashed #2F6FAB">-{}-
-{&#123;AdvancedSiteNotices/item|[&#91;Wikipedia:聚会/2010年台灣秋聚|'&#39;'2010年台灣維基人秋聚'&#39;'&#93;]與[&#91;Wikipedia_talk:聚会/2010上海夏聚|'&#39;'2010年上海维基人夏聚'&#39;'&#93;]圓滿落幕。|only_zh_cn only_zh_tw&#125;}
+{&#123;AdvancedSiteNotices/item|[&#91;Wikipedia:聚会/2010年台灣秋聚|'&#39;'2010年台灣維基人秋聚'&#39;'&#93;]與[&#91;Wikipedia_talk:聚会/2010上海夏聚|'&#39;'2010年上海维基人夏聚'&#39;'&#93;]圓滿落幕。|criteria=in_country('TW') {&#123;!!&#125;} in_country('CN') && in_city('Shanghai')&#125;}
+{&#123;AdvancedSiteNotices/item|维基媒体基金会推出了“只有权限较高的好孩子知道的功能”。|criteria=in_group('rollbacker') {&#123;!!&#125;} in_group('patroller') {&#123;!!&#125;} in_group('sysop') {&#123;!!&#125;} in_group('autoreviewer')&#125;}
-</div>
+</pre>
+== 注意事項 ==
+* 如在公告'''包含其他模板，而該模板的內容會在{{color|red|不用編輯}}的情況下自動更新'''（如倒數），您可能'''需要清除[[Template:AdvancedSiteNotices/ajax|ajax頁面]]的緩存'''，內容才會更新。要'''清除緩存，請點選[[Special:Purge/Template:AdvancedSiteNotices/ajax|<span class="plainlinks">此處</span>]]'''。
+* 如需查詢目前公告的顯示性質，請至[[Template:AdvancedSiteNotices/viewer]]。
+* 本頁面目前被全保護－需要在公告中加入內容的用戶請到[[Template_talk:AdvancedSiteNotices]]提出請求，由管理員代為加入。
+== 參見 ==
-如需查詢目前公告的顯示性質，請至[[Template:AdvancedSiteNotices/viewer]]
+* [[MediaWiki:Gadget-AdvancedSiteNotices.js]]
 <includeonly>
 <!-- 本行下加入模板的分類 -->
 [[category:公告栏|模]]
 [[Category:辅助模板|{{PAGENAME}}]]
-<!-- 本行下加入模板的跨語言鏈接 -->
-[[ar:Template:AdvancedSiteNotices]]
 </includeonly>