Help:导航Popup：修订间差异

|text=

由于历史遗留问题，当前版本的Navigation Popups可能存在若干BUG，如您发现，请在[[Qiuwen talk:茶馆|茶馆]]留言，尽可能附上详尽的复现步骤，并建议您在回报的同时，在QQ群内发送错误截图，以便维护人员定位问题，谢谢。

源代码在[[MediaWiki:Gadget-popups.js]]及[[MediaWiki:Gadget-popups-main.js]]。

[[File:popups-toggle-size-small-zh.png|right|280px|thumb|条目中的小图片预览（经典外观的截图，但完全兼容Monobook）]]

** 单击即可进行页面编辑，查看页面历史，查看最近的版本，查看最近的编辑者<ref name="on-selected-browsers-ie">On selected browsers, including Microsoft Internet Explorer</ref>，查看自我最后更改以来的编辑<ref name="on-selected-browsers-ie" />，移动页面，查看链入，链出更改，监视或解除监视页面，保护、解除保护或更改保护（限管理员），进入讨论页，编辑讨论页及开启新话题。

** 如果图像位于commons上时会有提示

** 单击可访问用户页，用户空间，用户讨论页，编辑用户讨论页，讨论页开启新对话，电邮用户，贡献与贡献树，用户日志，删除用户（限管理员），封禁用户（限管理员），用户贡献统计（[[tools:~soxred93/count|X!'s Edit Counter]]），封禁日志。

** 清除POPUPS缓存<ref name="on-selected-browsers-mff">On selected browsers, including Mozilla Firefox</ref>

** 启用/禁用预览<ref name="on-selected-browsers-mff" />

** 启用/禁用预览POPUPS<ref name="on-selected-browsers-mff" />

* 在编辑时预览wiki链接（使用鼠标选定一个wiki链接）。

* 维基搜索，[http://vs.aka-online.de/globalwpsearch/ global Wikipedia search]和[[Google]]搜索。

安装之前，您必须拥有一个中文维基百科的-{zh-hans:账号;zh-hant:帳號}-，这样您才可以使用弹出式导航-{zh-hans:菜单;zh-hant:選單}-的功能。如果您没有-{zh-hans:账号;zh-hant:帳號}-，那么您需要[[Special:Userlogin|申请一个]]然后登入。

也可以直接引用[//zh.wikipedia.org/w/load.php?modules=ext.gadget.Navigation_popups load.php]的檔案，但不建議使用：

mw.loader.load('//zh.wikipedia.org/w/load.php?modules=ext.gadget.Navigation_popups');

:如果您曾經使用其他方法引用導航Popup，這些方法已過時，請卸載曾經加上的相關JavaScript腳本，然后保存并清除浏览器缓存。

:下面列出了使用不同面板下您需要修改原有編輯的页面：

:*'''Vector(默认): [[Special:Mypage/vector.js|vector.js]]'''

:*Minerva: '''[[Special:Mypage/minerva.js|minerva.js]]'''

:*MonoBook: '''[[Special:Mypage/monobook.js|monobook.js]]'''

:*Timeless: '''[[Special:Mypage/timeless.js|timeless.js]]'''

{{hideH|過時的引用方法}}

您必须从您的用户页新建（编辑）一个特殊的文档，对大多数人来说，这个相关的文檔是[[Special:Mypage/vector.js|'''vector.js''']]（位於User:您的用戶名/vector.js）。點選左邊的連結就可以編輯這個檔案。

另外，如果您使用的面板不是預設的Vector，下面列出了不同情况下您需要编辑的页面：

:*Chick: '''[[Special:Mypage/chick.js|chick.js]]'''

:*MonoBook: '''[[Special:Mypage/monobook.js|monobook.js]]'''

:*MySkin: '''[[Special:Mypage/myskin.js|myskin.js]]'''

:*Simple: '''[[Special:Mypage/simple.js|simple.js]]'''

:*怀旧: '''[[Special:Mypage/nostalgia.js|nostalgia.js]]'''

:*标准: '''[[Special:Mypage/standard.js|standard.js]]'''

:*现代: '''[[Special:Mypage/modern.js|modern.js]]'''

:*科隆香水蓝: '''[[Special:Mypage/cologneblue.js|cologneblue.js]]'''

下一步，点击"编辑本页"，复制下面的文本粘贴在您的页面中（不要把下面的用戶名修改成为您的用户名），然后保存页面。

<br clear=all />

使用英文維基上的最新版本，加上中文介面檔案：

<syntaxhighlight lang=javascript>

// [[User:Lupin/popups.js]] - please include this line

importScript("http://en.wikipedia.org/wiki/User:Lupin/popups.js?action=raw&ctype=text/javascript&dontcountme=s");

importScript("User:笨笨的小B/jstool/strings-zh.js");

</syntaxhighlight>

[[User:笨笨的小B]]作過修改的版本：

<syntaxhighlight lang=javascript>

// [[:en:User:Lupin/popups.js]] - please include this line

// [[User:笨笨的小B/jstool/popups.js]] - 請保留此行

importScript("User:笨笨的小B/jstool/popups.js");

importScript("User:笨笨的小B/jstool/strings-zh.js");

</syntaxhighlight>

[[User:Vipuser]]所製作的中文界面：

<syntaxhighlight lang=javascript>

// [[User:Vipuser/popups.js]] - 请保留此行

importScript("User:vipuser/popups.js");

</syntaxhighlight>

在保存页面之后，请刷新您的浏览器缓存（对于[[Internet Explorer]]或[[Firefox]]可以使用快捷键Ctrl+F5），然后确定您的浏览器没有禁用javascript脚本。这样，在您把鼠标悬停在一个维基百科的内部链接上片刻之后，就可以看到一个弹出式菜单了。

需要安装脚本在commons或者wiktionary上的时候，重复上面的步骤在其他wiki上就可以了。

需要'''卸载'''脚本时，只需在同一页面删除您添加的上面几行文本然后保存并清除浏览器缓存即可。

{{hideF}}

== 可选配置 ==

{{Transexpan}}

=== 改变你的 popups 的外观 ===

只要修改個人的[[CSS]]檔，您就可以變更popups的外觀（默認根據[[Mediawiki:Gadget-popups.css]]），您個人的CSS檔如下： '''[[Special:Mypage/vector.css|User:您的用戶名/vector.css]]'''.

此為其中一個範例，background-color為背景顏色、font-family為字型種類、color為文字顏色、font-size為文字大小。

<syntaxhighlight lang=CSS>

.navpopup {

background-color: #BFFF00 !important;

font-family: arial !important;

color: #008000 !important;

font-size: 13px;

}

span.popup_contribs > a.popupNavLink {

display: block; /* 加寬“貢獻”，使得懸浮更加方便 */

}

</syntaxhighlight>

=== 选项 ===

您可以自行設定一些選項。從下面的表格中選擇<code>選項</code>以及<code>值</code>，每項屬性單獨一行添加到[[Special:Mypage/common.js|您的用戶自定义JavaScript页面]]<!-- 中文维基尚不支持skin.js自动跳转 -->。

:<code>window.選項 = 值;</code>

舉例來說，要打開管理員功能的屬性，您需要修改您的JavaScript檔案如下：

<syntaxhighlight lang=javascript>

window.popupStructure = 'menus';

window.popupAdminLinks = true;

</syntaxhighlight>

{| class="wikitable" cellpadding="4" border="1"

|+ 配置选项

|-

!選項 (Option)

!值 (Value)<br />{{Center|1=<small>默认值是<code>{{Hilite|1='''粗体'''}}</code></small>}}

!class="unsortable"|描述

|-

|<code>popupDelay</code>

|'''0.5'''，十进制小数

|停留幾秒後導航Popup才顯示。

|-

|<code>popupHideDelay</code> || '''0.5'''，十进制数 || 彈出式窗口的隱藏延遲

|-

|<code>simplePopups</code>

|<code>true</code>, '''<code>false</code>'''

|如果仅仅想要显示链接，或者认为流量消耗过多，可以把这个选项设为<code>true</code>。这样数据就不会被下载，poups也仅仅显示链接列表，除非您还将下列选项设为true：<code>popupUserInfo</code>, <code>popupPreviewDiffs</code>, <code>popupPreviewHistory</code>, <code>popupCategoryMembers</code>, <code>imagePopupsForImages</code>。

|-

|<code>popupStructure</code>

|<code>'original'</code>, <code>'fancy'</code>, <code>'fancy2'</code>, <code>'menus'</code>, <code>{{Hilite|1=''''shortmenus''''}}</code>, <code>'lite'</code>, <code>'nostalgia'</code>

|选择popups的结构。——[[:en:Wikipedia:Tools/Navigation popups/Structure examples|截图示例]]。<code>simplePopups</code> 选项为<code>true</code>或者您的浏览器支持菜单有问题时默认是<code>'original'</code>，弹窗中有所有导航链接。<code>'fancy'</code>、<code>fancy2</code>和<code>'nostalgia'</code>是<code>'original'</code>的变体。<code>simplePopups</code>不为true时默认是<code>simplePopups</code>，当鼠标悬停在popup标题上时，会把链接列表显现在菜单栏中。<code>'menus'</code>是<code>'shortmenus'</code>的增强版本，提供有更多链接。

最后，<code>'lite'</code>是一个非常简单的版本，仅提供预览，没有导航链接。<p>注意，设定此变量需使用单引号，例如{{code|lang=javascript|code=popupStructure='fancy';}}。

|-

|<code>popupActionsMenu</code>

|<code>{{Hilite|1='''true'''}}</code>, <code>false</code>

|When using menus, you can either have the title link in the popup generating a menu (if this is set to <code>false</code>) or a separate "actions" menu (if this is set to <code>true</code>, the default).

|-

|<code>popupImages</code>

|'''<code>true</code>''', <code>false</code>

|值設為 <code>false</code> ，則不顯示圖像。

|-

|<code>popupAdminLinks</code>

|<code>true</code>, '''<code>false</code>'''

|值設為 <code>true</code> ，則管理員可使用Popup執行封禁，刪除頁面，保護或解除保護頁面。

|-

|<code>popupShortcutKeys</code>

|<code>true</code>, '''<code>false</code>'''

|If this variable is set to <code>true</code> then you can focus some of the links in the popups quickly by pressing keys. When you hover the mouse over a link with a shortcut, the shortcut key appears at the end of the popup hint. For example, in Firefox or Opera, to quickly edit an article in a new tab you can type '<code>e Control-Enter</code>'. Internet Explorer users beware: shortcut keys don't work and turning this option on will reveal various bugs, so it's not recommended. <!-- Pressing escape should kill the popup, too. -->

|-

|<code>popupDragging</code>

|'''<code>true</code>''', <code>false</code>

|值設為<code>true</code> ，則能夠按住shift鍵不放，用滑鼠拖曳popups視窗。

|-

|<code>popupFixRedirs</code>

|<code>true</code>, '''<code>false</code>'''

|值設為<code>true</code> ，則能夠以點選"Redirects"連結而自動地修正重定向頁面。

|-

|<code>popupRedirAutoClick</code>

|<code>'wpSave'</code>, <code>'wpPreview'</code>, '''<code>'wpDiff'</code>'''

|The button which is automatically pressed when fixing redirects.

|-

|<code>popupFixDabs</code>

|<code>true</code>, '''<code>false</code>'''

|值設為<code>true</code> ，則能夠以點選Popup上的一個連結自動修正連向消歧義頁的錯誤。

|-

|<code>popupNavLinks</code>

|'''<code>true</code>''', <code>false</code>

|值設為<code>true</code> ，則popups會顯示導航連結，<code>false</code>則關閉此功能。

|-

|<code>popupLastEditLink</code>

|'''<code>true</code>''', <code>false</code>

|值設為<code>true</code>，則popus會顯示最近一次編輯鏈接，<code>false</code>則關閉此功能。

|-

|<code>popupHistoricalLinks</code>

|'''<code>true</code>''', <code>false</code>

|When hovering over links to old revisions and diff links, extra links such as "editOld" are generated if this is <code>true</code>. Otherwise, you get the same links as when hovering over an ordinary link.

|-

|<code>popupPreviews</code>

|'''<code>true</code>''', <code>false</code>

|If this is <code>true</code> and you haven't set <code>simplePopups</code>, then a preview of the first part of the article will appear. ([[User:Lupin/Pages with buggy previews|Reports of pages for which this is done badly]] are most welcome). If <code>false</code>, then this is switched off.

|-

|<code>popupSummaryData</code>

|'''<code>true</code>''', <code>false</code>

|值設為<code>true</code>，則popups會顯示目標頁的摘要，<code>false</code>則關閉此功能。

|-

|<code>popupLastModified</code>

|'''<code>true</code>''', <code>false</code>

|值設為<code>true</code>，則popups會顯示該頁面最後一次編輯距今的時間。

|-

|<code>popupOnlyArticleLinks</code>

|'''<code>true</code>''', <code>false</code>

|值設為<code>true</code>, 則popups只在連往頁面的連結才會啟動。否則，許多連結（例如編輯，-{zh-hans:帮助;zh-hk:說明;zh-sg:帮助;zh-tw:說明;}-）均會啟動popups。

|-

|<code>imagePopupsForImages</code>

|'''<code>true</code>''', <code>false</code>

|By default, preview images are loaded even when hoving over visible images. Setting this to <code>false</code> turns that off.

|-

|<code>popupMaxWidth</code>

|'''300'''，整数或者<code>false</code>

|Popup視窗的最大寬度的像素。若設為<code>false</code> 則Popup視窗將擴展至容納它所含有的內容。

|-

|<code>popupInitialWidth</code>

|整数或者'''<code>false</code>'''

|The initial width of the popup in pixels. Setting this to <code>false</code> means the popup will initially be the size needed to accommodate its initial contents.

|-

|<code>popupRevertSummary</code>

|字符串

|回復時的編輯摘要。 %s 為回復的版本ID。

|-

|<code>popupFixRedirsSummary</code>

|字符串

|修正重定向時的編輯摘要。 第一個 %s 為置換的重向定頁名稱，第二個 %s 為置換的目標頁面名稱。

|-

|<code>popupFixDabsSummary</code>

|字符串

|The edit summary used when disambiguating links. The first %s appearing in this string is replaced with the disambiguation page, and the second %s is replaced with the target page.

|-

|colspan=3|'''預覽選項'''（preview options）

|-

|<code>popupHistoryPreviewLimit</code>

|<code>{{Hilite|1='''25'''}}</code>, an integer

|

|-

|<code>popupCategoryMembers</code>

|<code>{{Hilite|1='''true'''}}</code>, <code>false</code>

|

|-

|<code>popupPreviewHistory</code>

|<code>{{Hilite|1='''true'''}}</code>, <code>false</code>

|

|-

|<code>popupContribsPreviewLimit</code>

|<code>{{Hilite|1='''25'''}}</code>, 一個整數

|貢獻預覽限制

|-

|<code>popupPreviewKillTemplates</code>

|<code>{{Hilite|1='''true'''}}</code>, <code>false</code>

|如果為<code>true</code>，文章中提到的模板只是從預覽刪除了。否則，他們以原始的維基文本形式出現。

|-

|<code>popupPreviewRawTemplates</code>

|<code>{{Hilite|1='''true'''}}</code>, <code>false</code>

|

|-

|<code>popupPreviewFirstParOnly</code>

|<code>{{Hilite|1='''true'''}}</code>, <code>false</code>

|

|-

|<code>popupMaxPreviewSentences</code>

|<code>{{Hilite|1='''5'''}}</code>, 一個整數

|

|-

|<code>popupMaxPreviewCharacters</code>

|<code>{{Hilite|1='''600'''}}</code>, 一個整數

|預覽文章的第一段的摘錄的長度。

|-

|colspan=3|'''技术选项'''

|-

|<code>popupNavLinkSeparator</code>

|字符串，<br>'''<tt><nowiki>' &amp;sdot; '</nowiki></tt>'''

|HTML inserted between the navigation links. This defaults to <tt>' &amp;bull; '</tt> in [[Konqueror]] and to <tt>' &amp;#183; '</tt> in Microsoft browsers, as they don't appear to like the &amp;sdot; character.

|-

|<code>popupAppendRedirNavLinks</code>

|'''<code>true</code>''', <code>false</code>

|If <code>true</code>, then a new set of navigation links is generated for the target of redirects; if <code>false</code>, then you're warned about the redirect but no navigation links are generated. This does nothing if <code>popupNavLinks</code> is <code>false</code>.

|-

|<code>removeTitles</code>

|'''<code>true</code>''', <code>false</code>

|此標題（popup的預設提示）of links are moved to the main link of the popup if this is <code>true</code>. If this is <code>false</code> then they're not.

|-

|colspan=3|'''实验选项'''

|-

|colspan=3|下列选项还未经过充分测试，并且未归档：<tt>popupLiveOptions</tt>, <tt>popupCookies</tt>, <tt>popupUnsimplifyLink</tt>。想要测试它们（以及其它未归档选项）的最简单互动办法就是做如下设置：<tt>popupLiveOptions=true</tt>.

|}

可能更多的选项，也欢迎建议更多设置需求。

=== 進階設定 ===

您能夠為文章定義客製化的過濾。這些是javascript在頁面統計產生後執行的功能，它們的輸出將附加(as HTML)為popup視窗的一部份。 (Note that if simplePopups is true or popupSummaryData is false, then nothing will be displayed).

The way to set this up is to write a filter function which accepts a string (the wikitext of the article) as input, and returns a fragment of HTML. Repeat for as many filters as you want, and then create an array <tt>extraPopupFilters</tt> which contains all of the functions, in the order in which you want them to be run.

For example, let's say you want to be told whenever the wikitext of an article contains a table written using HTML tags rather than wiki markup. One way to do this is to add the following to your user javascript file:

<pre>

// initialize the array - only do this once

extraPopupFilters=new Array();

// define the function

function popupFilterHtmlTable (wikiText) {

if (/<table/i.test(wikiText)) return '&amp;lt;table&amp;gt;';

else return '';

};

// add the function to the array (you can repeat this for lots of functions)

extraPopupFilters.push(popupFilterHtmlTable);

</pre>

Then when a popup is generated for a page containing an HTML table, you should see &lt;table&gt; in the popup. (It may also appear for other pages, such as this page. Correcting this defect is left as an exercise for the reader).

== 浏览器问题 ==

<!-- If anyone can get to the bottom of these problems, I'd like to [[User_talk:Lupin|hear about it]]. -->

如果哪位能找出這些問題的原因，麻煩請[[:en:User_talk:Lupin|告訴我]]{{en icon}}。中文版可以和[[User_talk:Vipuser|維遊]]聯繫。

*某些人發現使用此腳本時，會使 [[Safari]] 的許多功能出現故障。

*在某些版本的 [[Internet Explorer]]，當 <tt>popupFixDabs</tt> 的選項為“true”時，消歧義頁如 [[:en:mummification|mummification]] 無法顯示所有的它應有的連結。

<!-- *Keyboard shortcuts and dragging popups don't work in Internet Explorer. -->

*在 Internet Explorer裏，<s>鍵盤快捷鍵失效，</s>彈出窗口也無法拖曳。有人發現快捷鍵絲毫無損

*指針移動到'''[[Special:用户贡献/用户乙|贡献]]'''上，不顯示彈窗。但是可以依次將指針移動到'''[[User:用户乙|用户乙]]''' > '''用户''' > '''贡献'''來顯示貢獻的彈窗。

== 反馈 ==

发现任何漏洞、问题，或者有任何建议或改进，请联系[[:en:Wikipedia_talk:Tools/Navigation_popups]]。

中文版因为由[[user:vipuser|维游]]汉化，所以请直接和维游联系。

==参看==

*[[:en:Wikipedia:Easy navigation|Wikipedia:Easy navigation]] &ndash; 建议使用指南

*[http://meta.wikimedia.org/wiki/Help:User_style Help:User style] &ndash; 自定义维基百科页面外观

*[[:mw:Beta Features/Hovercards]] &ndash; 測試中的浮動窗格

*[http://www.bosrup.com/web/overlib overlib] by Erik Bosrup

*[[:enwiki:User:Pilaf/Live Preview|Live Preview]] by Pilaf

*a Javascript [[MD5]] hash function by Paul Johnston and others, available [http://pajhome.org.uk/crypt/md5 here]

*[http://www.youngpup.net/2001/domdrag domdrag] by Aaron Boodman

== 注释 ==

{{reflist}}