විකිපීඩියා:Tools/Navigation popups

විකිපීඩියා, නිදහස් විශ්වකෝෂය වෙතින්
Jump to navigation Jump to search
කෙටි මග:
WP:POP
WP:POPUP
WP:POPUPS
WP:NAVPOP
An example of popups over the link Wikipedia, using the skin Monobook. Click to enlarge preview.

Navigation popups is a script, written in JavaScript (source), that offers easy access to article previews and several Wikipedia functions in popup windows which appear when you hover the cursor over links.

  • Quick installation: Enter Special:Preferences and click "Gadgets", check the box to enable Popups, then click save. Follow the instructions on the page to bypass your browser's cache.
  • Other installation method: add {{subst:navpop}} to your current skin's .js page. See below for full installation instructions.

If you're having trouble, you may like to peruse some frequently asked questions.

Features[සංස්කරණය]

Small image preview for an article (Classic skin screenshot, but works fine with Vector/Monobook).
Click to enlarge preview.
Reverting using popups- hover over history item and select revert. Click to enlarge preview.
  • Mouseover on articles (including user pages):
    • Preview the first part of the article text (kudos to User:Pilaf for his Live Preview script which makes this possible)
    • Preview the first image on each article
    • Preview selected page information: size, number of links, number of images, number of categories and page age
    • Tells you about redirects, stubs and disambiguation pages
    • One click access to edit page, page history, most recent edit, edits by most recent contributor,[1] changes since my edit,[1] move page, what links here, related changes, watch or unwatch, protect or unprotect (for administrators), talk page, edit talk page and start new topic in talk page
  • Mouseover on image links:
    • Preview images
    • Preview file descriptions
    • Preview file links
    • Tells you if the image is on Commons
  • Mouseover on user links:
    • One-click access to user page, user space, user talk, edit user talk, new section in user talk, e-mail user, contributions and contributions tree, user log, (for administrators) delete user, (for administrators) block user, edit counter (X!'s Edit Counter), block log
  • Mouseover on footnotes:
    • Preview contents of footnotes
  • Mouseover on any wikilink:
    • Clear pop-up cache[2]
    • Enable/disable previews[2]
    • Enable/disable pop-ups[2]
  • Preview diffs and access both revisions in watchlist, history and related changes
  • Preview selected wikilinks when editing (use the mouse to select one wikilink)
  • One-click revert of vandalism from history browser (see image)
  • Wikipedia search, global Wikipedia search and Google search
  • Shortcut keys (optional)
  • Automatically fix links to bypass redirects and disambiguation pages (optional)
  • Should work on all Wikimedia wikis

Installation[සංස්කරණය]

You must have a user account in order to install and use the Navigation popups feature. If you do not have an account you will need to create one and log in.

Automatic installation
  • Go to My Preferences / Gadgets / Browsing gadgets and choose "Navigation popups", and click Save.
Manual installation
// [[User:Lupin/popups.js]]
importScript('User:Lupin/popups.js');

Note: the link above is to skin.js, which should take you to the correct page if you have Javascript enabled. For reference, the relevant file you will need to edit is listed below.

Notes

After saving the page, clear your browser's cache (on Internet Explorer Ctrl+F5; on Mozilla Firefox Shift+Ctrl+R; on Opera F5). Assuming that you have not disabled Javascript in your browser, a popup should appear whenever you hover your mouse over an internal link in Wikipedia. If you use more than one web browser, or more than one PC, you may need to clear the caches for each so that the popup appears.

To install the script on the Commons or Wiktionary, repeat this procedure on those wikis.

To uninstall the script, delete the above lines from the same page and clear your browser's cache.

Usage guide[සංස්කරණය]

This tool generates "popup hints" when you hover the mouse pointer over active links and images.

Many of the most important features can be used from the watchlist.

  • hover over a diff link to show a summary of the difference that edit has made
  • hover over a link to an article version to show a short excerpt of the version

There should also be some "navigation links" which access many functions including one-click reversion, editing that page and so on. These may appear in the popup itself, or may be hidden in an "actions" menu depending on your browser and your settings.

In normal articles:

  • hold the mouse over links pulls up a short excerpt of the linked-to article, then hover over the actions link if necessary to see more commands
  • if you hold the shift key then you can drag the popup around

Configuration (optional)[සංස්කරණය]

Changing the appearance of your popups[සංස්කරණය]

By editing your user CSS file, you can change the appearance of the popups. Your user CSS file has exactly the same name as the javascript file, but with "css" instead of "js" at the end. So you should edit your current skin's .css page.

Here is an example which gives an orange-flavoured popup with a border and changes the font used. This makes the popups look pretty silly, but it shows the sort of thing you can do if you feel like it.

.navpopup { 
  background-color: #FFBE20  !important;
  font-family:      serif    !important;
  color:            #404     !important;
  font-size:        medium   !important;
}

Options[සංස්කරණය]

There are some options that you can set. To do so, edit your user javascript file and add a line of the form

option = value;

where option and value are chosen from the table below. For example, to prevent all downloading and turn on admin links, you need something like this in your javascript file:

// [[User:Lupin/popups.js]] - please include this line 
importScript('User:Lupin/popups.js');

simplePopups=true;
popupAdminLinks=true;
Configuration options
Option Values[3] Description

විකිපීඩියා:Tools/Navigation popups/General options විකිපීඩියා:Tools/Navigation popups/Edit summary options විකිපීඩියා:Tools/Navigation popups/Preview options විකිපීඩියා:Tools/Navigation popups/Technical options විකිපීඩියා:Tools/Navigation popups/Experimental options

More options may be added, and requests for more configurability are welcome.

Advanced customization[සංස්කරණය]

Adding filters[සංස්කරණය]

You can define custom filters for articles. These are javascript functions which are run after the page statistics are generated, and their output is appended (as HTML) to that part of the 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 extraPopupFilters 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:

// initialize the array - only do this once
extraPopupFilters=[];

// define the function
function popupFilterHtmlTable (wikiText) {
  if (/<table/i.test(wikiText)) return '&lt;table&gt;';
  else return '';
};

// add the function to the array (you can repeat this for lots of functions)
extraPopupFilters.push(popupFilterHtmlTable);

Then when a popup is generated for a page containing an HTML table, you should see <table> 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).

Other examples[සංස්කරණය]

If you want to enable popupRedlinkRemoval, popupFixRedirs and popupFixDabs features in all pages except the special ones, histories and previews (where those features are obviously useless) you can add this lines

// Normally features are enabled
var toFix = true;

// In special pages, histories and previews disable them
if (wgCanonicalNamespace == "Special" || /*
    */ location.href.indexOf('&action=history') != -1 || /*
    */ location.href.indexOf('&action=submit') != -1)
  toFix = false;

// 
popupRedlinkRemoval = toFix;
popupFixRedirs = toFix;
popupFixDabs = toFix;

to your user javascript file.

Translations[සංස්කරණය]

Please see this page for translations of the script interface and of this page into other languages. You'll also find instructions for creating a translation yourself.

Browser problems[සංස්කරණය]

Internet Explorer[සංස්කරණය]

Pages with "–" in their titles will not display correctly in the popups. This bug does not exist in Internet Explorer 9, so upgrading will fix the bug.

Mozilla Firefox[සංස්කරණය]

If a user on Mozilla Firefox with the Adblock Plus extension installed cannot see the popup, only the normal tooltip, Adblock Plus may be blocking the operation of navigational popups. This can be solved by adding an exception to the filtering rules – go to the Main Page, right click the icon in the status bar and check Disable on en.wikipedia.org.

Safari[සංස්කරණය]

The menus do not function correctly in some older releases of Safari. Using a version 3 or higher is supported.

Opera[සංස්කරණය]

Using a current version (11.0 or higher) should give correctly functioning popups. Using an earlier version, you may experience problems, such as popups not loading or not disappearing after the mouse is moved away.

This tool should not be affected by any browser popup blocking settings.

Feedback[සංස්කරණය]

Please see විකිපීඩියා සාකච්ඡාව:Tools/Navigation popups.

Footnotes[සංස්කරණය]

  1. 1.0 1.1 On selected browsers, including Microsoft Internet Explorer
  2. 2.0 2.1 2.2 On selected browsers, including Mozilla Firefox
  3. Default values are listed in bold

Credits and external links[සංස්කරණය]

This tool was primarily written by Lupin, who is currently no longer active on Wikipedia. It depends on some other people's work:

Older versions of the tool used overlib by Erik Bosrup.

Wikipedians who have helped[සංස්කරණය]

"https://si.wikipedia.org/w/index.php?title=විකිපීඩියා:Tools/Navigation_popups&oldid=209295" වෙතින් සම්ප්‍රවේශනය කෙරිණි