diff --git a/home/wiki/Dashboard/Wiki_maintenance.html b/home/wiki/Dashboard/Wiki_maintenance.html index 0ecbfc8a4..d823a858d 100644 --- a/home/wiki/Dashboard/Wiki_maintenance.html +++ b/home/wiki/Dashboard/Wiki_maintenance.html @@ -222,6 +222,41 @@ +
This page provides options for Popups. -
- -Controls popup functionality +
Choose one of the following:
Number of words to show in popup
+
Enter a minimum size for the cache to use (in MB)
Number of additional words to show when "show more" is clicked
+
This is an advanced configuration tweak. When the cache reaches its maximum size, it will delete files to free space. It will continue deleting files until the minimum size is reached.
Automatically show the entire article if article is less than these number of bytes
-This feature is intended for small articles whose entire text...
-
It allows a complete preview of small articles without having to click "more" or "all"
-To deactivate this feature, set the number to -1
-
Number of extra words to read forward to look for a header
-This option tries to stop the popup text right before a header.
-
To deactivate this option, set it to -1.
-Technical details follow.
-
The approach works in the following manner: -
- -For example:
01 02 03 04 05 06 07 ==08== 09
+ 01 02 03 04 05
+ 06 07 ==08== 09
+ ==08==
- 01 02 03 04 05 06 07
- ==08== was just 08, then it would just have returned the original: 01 02 03 04 05
+ Number of words to read backward to remove header at end
-This option tries to stop a header from appearing at the end of the popup text.
-
To deactivate this option, set it to -1
-Technical details follow.
-
The approach works in the following manner: -
- -For example: -
- -01 02 03 04 05 06 07 ==08== 09
- 01 02 03 04 05 06 07 ==08== 09
- 06 07 ==08== 09
- ==08==
- 01 02 03 04 05 06 07
- ==08== was just 08, then it would just have returned the original: 01 02 03 04 05 06 07 08 09
- Stops reading if a header is found after # of words
-This option will stop reading if a header is found after the # of words. It is useful for increasing the probability that a popup will end at a header.
-
To deactivate this option, set it to -1. This will always show as much content as possible
-Technical details follow.
-
The following is a simplified example: -
- -01 02 03 04 05 ==06== 07 08 09 ==10== 11 12 13 14 15 16
- ==06== is found, but it is less than 8. The parser continues.
- ==10== is found, and it is greater than 8. The parser stops there and returns 01 02 03 04 05 ==06== 07 08 09
- Note the following variations: -
- -==06== and returned 01 02 03 04 05
- 01 02 03 04 05 ==06== 07 08 09 ==10== 11 12 13 14 15 16
- Note that the the read-bwd setting is still applied after the stop-hdr setting. -
-Number of milliseconds to wait before showing popup
-
Note that popup data will only be retrieved after the popup starts showing. For example: -
- -Number of milliseconds to wait before hiding popup
-
Maximum width of popup in pixels
-
Maximum height of popup in pixels
-
Maximum width of popup in pixels when show all is clicked
-This option was added because:
-
Note that -1 indicates no maximum width, which defaults to about 500 pixels +
Enter a maximum size for the cache to use (in MB)
Shows popup when link receives focus (tabbed into)
-This option allows keyboard users to use popups whenever a link is focused. Specifically:
+
Press to reduce the cache to the minimum now (typically 75 MB).
- -Maximum length of template token (in bytes) to evaluate
-This option allows faster popups, but at the cost of accuracy:
-
Templates are wikitext of the form {{Name|Arg_1|Arg_2|...}}. They are used throughout a wiki to perform functions ranging from unit conversion (like converting kilometers to miles), or generating large pieces of HTML (like rendering entire InfoBoxes). However, these templates are the "slowest" pieces of wikitext to parse, particularly if they call other templates or Scribunto
Ideally, popups should skip templates that produce structural html (like infoboxes), while still trying to render templates that do smaller functions (like converting units). This option attempts a heuristic that says "if the template is long, assume it's an infobox and should be skipped". It counts the total number of bytes in a template, and skips it if it's greater than the max. For example, {{Name|Arg_1}} has a length of 10, and will be skipped if the max length is set to 8. If the max length is set to 16, then the template won't be skipped.
This option is imperfect, but should work well enough on most cases. Note that Navigation Popups does something similar by skipping template text, but without any configuration. (always set to 0).
Specifies templates to be shown in popup
-This is a performance optimization for English Wikipedia. It only evaluates listed templates.
-The format is as follows
+
Press to clear the cache (reduces to 0 MB).
- -;)
- en.wikipedia.org|name*|name_to_always_skip will match any template that starts with "name" unless the template is named "name_to_always_skip". Note that unless-names have the same rules as keep-names (semi-colon separator; wildcards)To disable this option, replaces the keep-names with a *. For example: en.wikipedia.org|*|
-
Default option -
--en.wikipedia.org|formatnum;age_in_days;as_of;gregorian_serial_date;currentminute;currentsecond;dmca;spaced_ndash;trim;month*;convert*;worldpop*;ipa*;lang*;nowrap*;h:*;vgy;iso_639_name;transl;translate;linktext;zh;nihongo;japanese_name;ko-hhrm;| --
Restrict popups to certain namespaces
-This option allows popups to be suppressed for namespaces that would ordinarily generate no content. For example, Portal pages are often contained in a table / div, whereas Module pages are code.
-Note the following:
-
|). For example, (Main)|Help
- Aide would only allow the Help namespace in French wikis, wheras Help will allow the Help namespace across all wikis.
- | Title - | -
|---|
| (Main) - | -
| User - | -
| Project - | -
| File - | -
| MediaWiki - | -
| Template - | -
| Help - | -
| Category - | -
| Special - | -
Ignore html elements that have the following ids
-This feature is intended for English Wikipedia which has a {{Coordinates}} tag at the top of most geographical articles (for example, North Pole)
-Without this option, a Coordinates span would be visible in the top right of the popup, which....
+
Miscellaneous information about the cache
- -Usage notes: -
- -<span id='coordinates'>0 N 90 E</span> will not show b/c the html element (span) has a listed id (coordinates)
- | character. For example, coordinates|some_other_id.
- coordinates and Coordinates. There is a difference between é and É
- (empty)Number of bytes to read for each pass
-This number represents the number of bytes the popup parser reads at a time. For example, it will read the first 1024 bytes of the article, and if it doesn't find 64 words, it continues to read sections of 1024 bytes until it does.
-
Maximum number of bytes to read
-
This number represents the maximum number of bytes the popup parser reads before it gives up. Note that if the parser gives up, then no text will be returned for the preview.
-This setting should only apply to badly formatted articles. For example consider a page that has a comment with 100,000 5 letter words (<!-- 100,000 5 letter words -->). This page will be considered to have 0 words, even though it has a page length of 500,000. Rather than read the entire 500,000 bytes, the popup parser will stop after 32,768.