Archives/gnosygnu_xowa
1
0
Fork 0
mirror of https://github.com/gnosygnu/xowa.git synced 2026-03-02 03:49:30 +00:00
Code Issues Projects Releases Wiki Activity

'v3.4.2.55'

Browse Source
This commit is contained in:
gnosygnu
2016-04-17 11:48:03 -04:00
parent 720b111814
commit 70e48dc738
240 changed files with 114045 additions and 176 deletions
Download Patch File Download Diff File Expand all files Collapse all files

300
home/wiki/App/Search/Address_bar.html Normal file
View File

@@ -0,0 +1,300 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Search/Address bar - XOWA</title>
<link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
<link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Search/Address bar</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<p>
XOWA can search for a page using the url-bar.
</p>
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Auto-complete"><span class="tocnumber">1</span> <span class="toctext">Auto-complete</span></a>
</li>
<li class="toclevel-1 tocsection-2">
<a href="#Basic_details"><span class="tocnumber">2</span> <span class="toctext">Basic details</span></a>
<ul>
<li class="toclevel-2 tocsection-3">
<a href="#UI"><span class="tocnumber">2.1</span> <span class="toctext">UI</span></a>
</li>
<li class="toclevel-2 tocsection-4">
<a href="#General"><span class="tocnumber">2.2</span> <span class="toctext">General</span></a>
</li>
<li class="toclevel-2 tocsection-5">
<a href="#Wildcard"><span class="tocnumber">2.3</span> <span class="toctext">Wildcard</span></a>
</li>
<li class="toclevel-2 tocsection-6">
<a href="#Punctuation"><span class="tocnumber">2.4</span> <span class="toctext">Punctuation</span></a>
</li>
<li class="toclevel-2 tocsection-7">
<a href="#Redirects"><span class="tocnumber">2.5</span> <span class="toctext">Redirects</span></a>
</li>
</ul>
</li>
<li class="toclevel-1 tocsection-8">
<a href="#Performance"><span class="tocnumber">3</span> <span class="toctext">Performance</span></a>
<ul>
<li class="toclevel-2 tocsection-9">
<a href="#Very_fast"><span class="tocnumber">3.1</span> <span class="toctext">Very fast</span></a>
</li>
<li class="toclevel-2 tocsection-10">
<a href="#Fast"><span class="tocnumber">3.2</span> <span class="toctext">Fast</span></a>
</li>
<li class="toclevel-2 tocsection-11">
<a href="#Slow"><span class="tocnumber">3.3</span> <span class="toctext">Slow</span></a>
</li>
</ul>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Auto-complete">Auto-complete</span>
</h2>
<p>
As of v3.3.4.1, the address bar supports auto-completion. This function can only be used with a wiki built in v3.3.4.1 or later. If the address bar is not working, you should rebuild the search-databases. See <a href="http://xowa.org/home/wiki/App/Search/Build.html" id="xolnki_2" title="App/Search/Build" class="xowa-visited">App/Search/Build</a> for more information.
</p>
<h2>
<span class="mw-headline" id="Basic_details">Basic details</span>
</h2>
<h3>
<span class="mw-headline" id="UI">UI</span>
</h3>
<ul>
<li>
<b>Searches return 10 results</b>: To change the number, see <a href="http://xowa.org/home/wiki/Options/Search_suggest.html" id="xolnki_3" title="Options/Search suggest" class="xowa-visited">Options/Search_suggest</a>
</li>
<li>
<b>The keys "up" / "down" / "page-up" / "page-down" works like Firefox</b>: The url-bar is meant to emulate Firefox's behavior. This includes:
<ul>
<li>
Pressing "up" in the first row transfers focus to the url bar.
</li>
<li>
Pressing "up" in the url bar goes goes to the last row.
</li>
<li>
Pressing "page-up" jumps up by 5 rows. This number can be changed at <a href="http://xowa.org/home/wiki/Options/Search_suggest.html" id="xolnki_4" title="Options/Search suggest" class="xowa-visited">Options/Search_suggest</a>.
</li>
<li>
Pressing "page-up" when there is less than 5 rows will jump to the first row.
</li>
<li>
Pressing "page-up" in the first row transfers focus to the url bar.
</li>
<li>
Pressing "page-up" in the url bar goes to the last row.
</li>
<li>
For "down" and "page-down" the reverse is true.
</li>
</ul>
</li>
</ul>
<h3>
<span class="mw-headline" id="General">General</span>
</h3>
<ul>
<li>
<b>Searches sort by page score</b>: By convention, XOWA scores every page with percentile ranking ("graded curve") from 0 to 1,000,000. Page score is based on <a href="https://en.wikipedia.org/wiki/PageRank" rel="nofollow" class="external free">https://en.wikipedia.org/wiki/PageRank</a> . In short, a page has a high page score if there are many pages linking to it. For more info, see <a href="http://xowa.org/home/wiki/App/Search/Score.html" id="xolnki_5" title="App/Search/Score" class="xowa-visited">App/Search/Score</a>
</li>
<li>
<b>Searches find a page that matches the text and list it as the first result</b>: For example, searching for "earth" will automatically find the page "Earth" and list it as the first result, regardless of its score. (Technically, this entry is assigned a temporary score of 3,000,000)
</li>
<li>
<b>Searches are case-insensitive</b>: There is no difference between searching for "earth" or "Earth" or "EARTH" or "earTH".
</li>
<li>
<b>Searches match any word in the page title.</b>: For example, searching for "earth" not only matches "Earth" and "Earth Day", but also "History of Earth" and "Future of Earth"
</li>
</ul>
<h3>
<span class="mw-headline" id="Wildcard">Wildcard</span>
</h3>
<ul>
<li>
<b>Searches automatically have a wildcard at the end</b>: For example, searching for "earth" is actually a search for "earth*" and will return "Earth" as well as "Earthquake", "Earthworm", "Earthenware", etc.. Similarly, "earth h" will find "History of Earth", "Earth hour", "High Earth Orbit", etc..
</li>
<li>
<b>Searches can have an explicit wildcard</b>: For example, searching for "ear* hist" can return "History of Earth" as well as "Early Modern History".
</li>
<li>
<b>Searches can be unwildcarded with a space</b>: For example, searching for "earth " (earth and a single space) will return "Earth" and "History of Earth" but not "Earthquake", "Earthworm", "Earthenware", etc..
</li>
</ul>
<h3>
<span class="mw-headline" id="Punctuation">Punctuation</span>
</h3>
<ul>
<li>
<b>Searches can use punctuation</b>: For example, searches can be for punctuated items like "c++" or "o'clock" or "role-playing". However, the following symbols are reserved: double-quotes, parentheses, dash, plus, comma, backslash and asterisk.
</li>
<li>
<b>Searches can filter out words using a dash</b>: For example, searching for "earth -middle" will return "Earth", but not "Middle-Earth"
</li>
</ul>
<h3>
<span class="mw-headline" id="Redirects">Redirects</span>
</h3>
<ul>
<li>
<b>Redirects are identified with a "-&gt;" as well as the name of the redirect destination.</b> For example, "Near-Earth asteroid" shows as "Near-Earth asteroid -&gt; Near-Earth object". This can be interpreted as the "Near-Earth asteroid" redirect which leads to the "Near-Earth object" page.
</li>
<li>
<b>Searches remove redundant redirects</b>: Wikis may have multiple redirects to the same page. For example, "The Earth", "EartH", and "Earth (Planet)" all lead to "Earth". When searching for "earth", at most, "The Earth" would be listed. "EartH", and "Earth (Planet)" would not show because they point to the same target page ("Earth") which "The Earth" already points to. (In reality, "The Earth" would not even be listed, because "earth" would automatically pull up "Earth", and "The Earth" would be considered redundant.)
</li>
</ul>
<h2>
<span class="mw-headline" id="Performance">Performance</span>
</h2>
<p>
As a brief guide, the following illustrates which search terms will be faster than others.
</p>
<h3>
<span class="mw-headline" id="Very_fast">Very fast</span>
</h3>
<ul>
<li>
<b>Exact title match</b>: For example, "earth" will be fast as it matches the page "Earth" exactly. (Technically, it searches the page table using the page_title index)
</li>
<li>
<b>One word with no wildcards</b>: For example, "earth " will be fast as it matches the "earth" word exactly. (Technically, it searches the search_link table using word_id)
</li>
</ul>
<h3>
<span class="mw-headline" id="Fast">Fast</span>
</h3>
<ul>
<li>
<b>One word with a wildcard</b>: For example, "earth*" will be moderate as it matches all words that start with earth. (Technically, it searches the search_link table using word_text for a range of words)
</li>
<li>
<b>Many words with a wildcard</b>: For example, "earth h*" will pick the word which the fewest results and search for it. In this case, "earth" has fewer pages than "h*", so it will search for "earth"
</li>
</ul>
<h3>
<span class="mw-headline" id="Slow">Slow</span>
</h3>
<ul>
<li>
<b>Many words with each word being linked to many pages but resulting in low-scored pages</b>: For example, "page meg*" will only match one page in English Wikipedia: "Megan Page".
</li>
</ul>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/home/wiki/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-started'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/home/wiki/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-android'>
<h3>Android</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Android/Setup.html" title='Setup XOWA on your Android device'>Setup</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="https://archive.org/donate/index.php" title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

164
home/wiki/App/Search/Build.html Normal file
View File

@@ -0,0 +1,164 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Search/Build - XOWA</title>
<link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
<link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Search/Build</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
As of v3.3.4.1, XOWA has a new search engine. This uses the same search functionality that is in XOWA Android.
</p>
<p>
Unfortunately, this search engine is not backward compatible with old wikis. To use it, you must do one of the following:
</p>
<ul>
<li>
Import a new wiki. The new search-databases are built automatically.
</li>
<li>
Upgrade an existing wiki by the search suggest box
<ul>
<li>
Open any page in the wiki
</li>
<li>
Click the search suggest box (the box between "View HTML" and the magnifying glass)
</li>
<li>
Start typing. XOWA will prompt you to upgrade the wiki.
</li>
</ul>
</li>
<li>
Upgrade an existing wiki through the maintenance page. You can upgrade with the following process
<ul>
<li>
Go to <a href="http://xowa.org/home/wiki/Dashboard/Wiki_maintenance.html" id="xolnki_2" title="Dashboard/Wiki maintenance" class="xowa-visited">Dashboard/Wiki_maintenance</a>
</li>
<li>
Find your wiki in the list
</li>
<li>
Click the <code>Search</code> button in the same row
</li>
<li>
Click <code>Run Script</code>
</li>
</ul>
</li>
</ul>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/home/wiki/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-started'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/home/wiki/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-android'>
<h3>Android</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Android/Setup.html" title='Setup XOWA on your Android device'>Setup</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="https://archive.org/donate/index.php" title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

706
home/wiki/App/Search/Overview.html Normal file
View File

@@ -0,0 +1,706 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Search/Overview - XOWA</title>
<link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
<link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
<style>
.symbol-col {
text-align:center;
}
code {
border: solid 1px gray;
background: #EFEFEF;
text-align:center;
padding: 1px;
}
.page-inc, .page-exc {
border: solid 1px gray;
text-align:center;
padding: 1px;
}
.page-inc {
background:#89C35C;
}
.page-exc {
background:#F62217;
}
.page-inc b, .page-exc b {
font-weight: bold;
}
</style>
<style>
.symbol-col {
text-align:center;
}
code {
border: solid 1px gray;
background: #EFEFEF;
text-align:center;
padding: 1px;
}
.page-inc, .page-exc {
border: solid 1px gray;
text-align:center;
padding: 1px;
}
.page-inc {
background:#89C35C;
}
.page-exc {
background:#F62217;
}
.page-inc b, .page-exc b {
font-weight: bold;
}
</style>
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Search/Overview</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<p>
XOWA can search for a page by title
</p>
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Search_by_page_title"><span class="tocnumber">1</span> <span class="toctext">Search by page title</span></a>
</li>
<li class="toclevel-1 tocsection-2">
<a href="#Usage"><span class="tocnumber">2</span> <span class="toctext">Usage</span></a>
</li>
<li class="toclevel-1 tocsection-3">
<a href="#Syntax"><span class="tocnumber">3</span> <span class="toctext">Syntax</span></a>
<ul>
<li class="toclevel-2 tocsection-4">
<a href="#General"><span class="tocnumber">3.1</span> <span class="toctext">General</span></a>
</li>
<li class="toclevel-2 tocsection-5">
<a href="#Wildcard"><span class="tocnumber">3.2</span> <span class="toctext">Wildcard</span></a>
</li>
<li class="toclevel-2 tocsection-6">
<a href="#Not"><span class="tocnumber">3.3</span> <span class="toctext">Not</span></a>
</li>
<li class="toclevel-2 tocsection-7">
<a href="#Quote"><span class="tocnumber">3.4</span> <span class="toctext">Quote</span></a>
</li>
</ul>
</li>
<li class="toclevel-1 tocsection-8">
<a href="#Sorting"><span class="tocnumber">4</span> <span class="toctext">Sorting</span></a>
</li>
<li class="toclevel-1 tocsection-9">
<a href="#Background_database_search"><span class="tocnumber">5</span> <span class="toctext">Background database search</span></a>
</li>
<li class="toclevel-1 tocsection-10">
<a href="#Database_update"><span class="tocnumber">6</span> <span class="toctext">Database update</span></a>
</li>
<li class="toclevel-1 tocsection-11">
<a href="#Options"><span class="tocnumber">7</span> <span class="toctext">Options</span></a>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Search_by_page_title">Search by page title</span>
</h2>
<p>
XOWA can find a page by words in its title. For example, typing <code>earth</code> will pull up all titles with the word, including <span class='page-inc'>Earth</span> and <span class='page-inc'>History of Earth</span>. More complicated searches can be performed, such as <code>earth + (history, future) -middle</code>
</p>
<p>
XOWA currently cannot search by text within a page (full-text search). This will be added in a future version.
</p>
<h2>
<span class="mw-headline" id="Usage">Usage</span>
</h2>
<p>
There are three ways to use search:
</p>
<ul>
<li>
Type into the address bar. A list of suggestions appear underneath.
</li>
<li>
Type into the suggest box. A list of suggestions appear underneath. Note that this box is near the top-right hand corner of the page between "View HTML" and the magnifying glass icon.
</li>
<li>
Type "?:some word" into the address bar. For example, enter <code>?:earth</code> in the address bar when in Simple Wikipedia
</li>
</ul>
<h2>
<span class="mw-headline" id="Syntax">Syntax</span>
</h2>
<p>
The following syntax is supported for search text:
</p>
<table class='wikitable' style='background: white;'>
<tr>
<th>
name
</th>
<th>
description
</th>
<th>
symbol
</th>
<th>
example
</th>
<th>
finds
</th>
<th>
skips
</th>
</tr>
<tr>
<td>
single word
</td>
<td>
finds pages which start with this word<br>
(automatic wildcard at the end)
</td>
<td>
</td>
<td>
<code>earth</code>
</td>
<td>
<p>
<span class='page-inc'><b>Earth</b></span><br>
<span class='page-inc'><b>History</b> of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b>quake</span>
</p>
</td>
<td>
</td>
</tr>
<tr>
<td>
single word with space
</td>
<td>
finds pages which have this word exactly<br>
(no automatic wildcard)
</td>
<td>
</td>
<td>
<code>earth&nbsp;</code>
</td>
<td>
<p>
<span class='page-inc'><b>Earth</b></span><br>
<span class='page-inc'><b>History</b> of <b>Earth</b></span>
</p>
</td>
<td>
<span class='page-exc'>Earthquake</span>
</td>
</tr>
<tr>
<td>
multiple words
</td>
<td>
finds pages which have all these words
</td>
<td>
</td>
<td>
<code>earth history</code>
</td>
<td>
<p>
<span class='page-inc'><b>History</b> of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b> <b>history</b></span>
</p>
</td>
<td>
<span class='page-exc'>Earth</span>
</td>
</tr>
<tr>
<td>
wildcard
</td>
<td>
finds pages which start with these letters
</td>
<td class='symbol-col'>
<code>*</code>
</td>
<td>
<code>earth*</code>
</td>
<td>
<p>
<span class='page-inc'><b>Earth</b></span><br>
<span class='page-inc'>History of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b>quake</span>
</p>
</td>
<td>
</td>
</tr>
<tr>
<td>
</td>
<td>
finds pages which end with these letters
</td>
<td class='symbol-col'>
<code>*</code>
</td>
<td>
<code>*earth</code>
</td>
<td>
<p>
<span class='page-inc'><b>Earth</b></span><br>
<span class='page-inc'>History of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b>quake</span><br>
<span class='page-inc'>H<b>earth</b></span>
</p>
</td>
<td>
</td>
</tr>
<tr>
<td>
</td>
<td>
finds pages which start / end with these letters
</td>
<td class='symbol-col'>
<code>*</code>
</td>
<td>
<code>e*h</code>
</td>
<td>
<p>
<span class='page-inc'><b>Earth</b></span><br>
<span class='page-inc'>History of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b>quake</span><br>
<span class='page-inc'><b>E</b>nglis<b>h</b> language</span>
</p>
</td>
<td>
</td>
</tr>
<tr>
<td>
not
</td>
<td>
skips pages which have this word
</td>
<td class='symbol-col'>
<code>-</code>
</td>
<td>
<code>earth -history</code>
</td>
<td>
<span class='page-inc'><b>Earth</b></span>
</td>
<td>
<span class='page-exc'>History of Earth</span>
</td>
</tr>
<tr>
<td>
or
</td>
<td>
includes pages which have this word
</td>
<td class='symbol-col'>
<code>,</code>
</td>
<td>
<code>earth, history</code>
</td>
<td>
<p>
<span class='page-inc'><b>History</b> of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b> <b>history</b></span><br>
<span class='page-inc'><b>History</b></span><br>
<span class='page-inc'><b>Earth</b></span>
</p>
</td>
</tr>
<tr>
<td>
and
</td>
<td>
requires pages to have this word
</td>
<td class='symbol-col'>
<code>+</code>
</td>
<td>
<code>earth + history</code>
</td>
<td>
<p>
<span class='page-inc'><b>History</b> of <b>Earth</b></span><br>
<span class='page-inc'><b>Earth</b> <b>history</b></span>
</p>
</td>
<td>
<span class='page-exc'>History</span><br>
<p>
<span class='page-exc'>Earth</span>
</p>
</td>
</tr>
<tr>
<td>
quote
</td>
<td>
requires pages to have this exact text
</td>
<td class='symbol-col'>
<code>"</code>
</td>
<td>
<code>"earth history"</code>
</td>
<td>
<p>
<span class='page-inc'><b>Earth history</b></span>
</p>
</td>
<td>
<p>
<span class='page-exc'>History of Earth</span><br>
<span class='page-exc'>History</span><br>
<span class='page-exc'>Earth</span>
</p>
</td>
</tr>
<tr>
<td>
parentheses
</td>
<td>
allows complicated and / or grouping
</td>
<td class='symbol-col'>
<code>(</code> <code>)</code>
</td>
<td>
<code>earth + (history, future)</code>
</td>
<td>
<p>
<span class='page-inc'><b>History</b> of <b>Earth</b></span><br>
<span class='page-inc'><b>Future</b> of <b>Earth</b></span>
</p>
</td>
<td>
<span class='page-exc'>Earth</span>
</td>
</tr>
<tr>
<td>
escape
</td>
<td>
allows searching for any symbols above
</td>
<td class='symbol-col'>
<code>\</code>
</td>
<td>
<code>c\+\+</code>
</td>
<td>
<p>
<span class='page-inc'><b>C++</b></span>
</p>
</td>
</tr>
</table>
<h3>
<span class="mw-headline" id="General">General</span>
</h3>
<ul>
<li>
Spaces are ignored
<ul>
<li>
<code>earth, history</code> is the same as <code>earth , history</code> or <code>earth ,history</code>
</li>
</ul>
</li>
<li>
Incorrect terms are auto-corrected as per the following:
<ul>
<li>
<code>earth - history</code> is the same as <code>earth history</code>
</li>
<li>
<code>earth +</code> is the same as <code>earth</code>
</li>
<li>
<code>earth,</code> is the same as <code>earth</code>
</li>
<li>
<code>"earth</code> is the same as <code>"earth"</code>. Note that <code>"earth history</code> becomes <code>"earth" history</code>.
</li>
<li>
<code>(earth</code> is the same as <code>earth</code>
</li>
<li>
<code>c\</code> is the same as <code>c</code>
</li>
</ul>
</li>
</ul>
<h3>
<span class="mw-headline" id="Wildcard">Wildcard</span>
</h3>
<ul>
<li>
Wildcards are automatically added to the last word. For example, <code>earth histor</code> is the same as <code>earth histor*</code>.
</li>
<li>
Wildcards will be slower than non-wildcarded versions. In terms of performance, they are ranked as following:
<ul>
<li>
<b>end of word</b>
<ul>
<li>
faster, especially when word is longer. EX: <code>abcdefghi*</code> vs <code>a*</code>
</li>
<li>
may be slow for certain multi-word queries. EX: <code>page meg*</code>
</li>
<li>
uses the <code>&gt;=</code> <code>&lt;</code> operators: <code>word_text &gt;= ? AND word_text &lt; ?</code>
</li>
<li>
uses an INDEX scan
</li>
</ul>
</li>
<li>
<b>beginning of word</b> / <b>middle of word</b>
<ul>
<li>
may be fast if matching a common string. EX: <code>*a</code>, <code>*arth</code>
</li>
<li>
will be slow for queries that don't match results. EX: <code>ea*rh</code>
</li>
<li>
uses the LIKE operator: <code>word_text LIKE ? ESCAPE '|'</code>
</li>
<li>
uses a TABLE scan
</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3>
<span class="mw-headline" id="Not">Not</span>
</h3>
<ul>
<li>
<code>-</code> only works at the start of the word
<ul>
<li>
<code>earth hi-story</code> is the same as <code>earth "hi-story"</code>. In other words, the <code>-</code> is literal
</li>
</ul>
</li>
<li>
<code>-</code> must be used with a word. Entering just <code>-QXZ</code> will return 0 results
</li>
</ul>
<h3>
<span class="mw-headline" id="Quote">Quote</span>
</h3>
<ul>
<li>
Quotes can also be used for escaping. For example <code>"c++"</code> is the same as <code>c\+\+</code>
</li>
<li>
Quotes must be doubled up inside quotes. For example <code>"a""b"</code> means search for a word with <code>a"b</code>
</li>
</ul>
<h2>
<span class="mw-headline" id="Sorting">Sorting</span>
</h2>
<p>
By default, XOWA returns results sorted by "page length descending". In other words, the largest page would be the first in the list and the smallest page would be the last.
</p>
<p>
If a wiki is built with PageRank, or if a wiki is downloaded from archive.org, then the results will be sorted by "PageRank descending". See <a href="http://xowa.org/home/wiki/Options/Search.html" id="xolnki_2" title="Options/Search" class="xowa-visited">Options/Search</a> for enabling PageRank.
</p>
<h2>
<span class="mw-headline" id="Background_database_search">Background database search</span>
</h2>
<p>
By default, XOWA runs database searches in the background. This will return results to the screen quickly for complicated searches. For example, consider a search for <code>Earth*</code>:
</p>
<ul>
<li>
When the search runs in the background, the first result shows up in 2 seconds, and more results show up every second afterwards. The search will complete in 5 seconds.
</li>
<li>
When the search does not run in the background, all the results show up at the 5 second mark.
</li>
</ul>
<p>
While a search is running in the background, there will be a link called <code>Stop searching</code>. Clicking on the link will stop the background search, though the current results may be incomplete.
</p>
<p>
Finally, all search results are cached. The first time you search for <code>Earth*</code>, XOWA will search the database. Every time afterwards, it will pull the results up from memory. If you restart XOWA, it will search the database again.
</p>
<h2>
<span class="mw-headline" id="Database_update">Database update</span>
</h2>
<p>
XOWA wikis created before v3.3.4.1 will need to be upgraded. XOWA will detect if an upgrade is needed, and show a message box for confirmation. The upgrade process will take a few minutes.
</p>
<p>
Note that new wikis created after v3.3.4.1 will automatically be in the new format.
</p>
<h2>
<span class="mw-headline" id="Options">Options</span>
</h2>
<p>
There are 2 pages for configuring Search
</p>
<ul>
<li>
<b>Configure PageRank</b>: See <a href="http://xowa.org/home/wiki/Options/Search.html" id="xolnki_3" title="Options/Search" class="xowa-visited">Options/Search</a>
</li>
<li>
<b>Configure Address bar autocomplete</b>: See <a href="http://xowa.org/home/wiki/Options/Search_suggest.html" id="xolnki_4" title="Options/Search suggest" class="xowa-visited">Options/Search_suggest</a>
</li>
</ul>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/home/wiki/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-started'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/home/wiki/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-android'>
<h3>Android</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Android/Setup.html" title='Setup XOWA on your Android device'>Setup</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="https://archive.org/donate/index.php" title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

368
home/wiki/App/Search/Score.html Normal file
View File

@@ -0,0 +1,368 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Search/Score - XOWA</title>
<link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
<link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Search/Score</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<p>
XOWA calculates a score to every page for the purpose of ranking search results.
</p>
<div id="toc" class="toc">
<div id="toctitle">
<h2>
Contents
</h2>
</div>
<ul>
<li class="toclevel-1 tocsection-1">
<a href="#Overview"><span class="tocnumber">1</span> <span class="toctext">Overview</span></a>
</li>
<li class="toclevel-1 tocsection-2">
<a href="#Scaling_.2F_Ranking"><span class="tocnumber">2</span> <span class="toctext">Scaling / Ranking</span></a>
<ul>
<li class="toclevel-2 tocsection-3">
<a href="#Scaling"><span class="tocnumber">2.1</span> <span class="toctext">Scaling</span></a>
</li>
<li class="toclevel-2 tocsection-4">
<a href="#Ranking"><span class="tocnumber">2.2</span> <span class="toctext">Ranking</span></a>
</li>
</ul>
</li>
<li class="toclevel-1 tocsection-5">
<a href="#Calculation"><span class="tocnumber">3</span> <span class="toctext">Calculation</span></a>
<ul>
<li class="toclevel-2 tocsection-6">
<a href="#PageRank"><span class="tocnumber">3.1</span> <span class="toctext">PageRank</span></a>
</li>
<li class="toclevel-2 tocsection-7">
<a href="#Short_pages_are_penalized"><span class="tocnumber">3.2</span> <span class="toctext">Short pages are penalized</span></a>
</li>
<li class="toclevel-2 tocsection-8">
<a href="#Scores_are_re-scaled"><span class="tocnumber">3.3</span> <span class="toctext">Scores are re-scaled</span></a>
</li>
</ul>
</li>
</ul>
</div>
<h2>
<span class="mw-headline" id="Overview">Overview</span>
</h2>
<p>
From a broad perspective, the following happens:
</p>
<ul>
<li>
A <a href="https://en.wikipedia.org/wiki/PageRank" rel="nofollow" class="external text">PageRank</a> score is calculated for a page. This score is <a href="https://en.wikipedia.org/wiki/Feature_scaling" rel="nofollow" class="external text">scaled</a> from 0 to 1,000,000
</li>
<li>
A page-length score is then calculated for the page. This score is <a href="https://en.wikipedia.org/wiki/Percentile_rank" rel="nofollow" class="external text">ranked</a> from 0 to 1,000,000
</li>
<li>
The PageRank score is then multiplied by a ratio if it has a low page-length score
</li>
<li>
The resulting PageRank score is then ranked from 0 to 1,000,000.
</li>
</ul>
<p>
<br>
</p>
<h2>
<span class="mw-headline" id="Scaling_.2F_Ranking">Scaling / Ranking</span>
</h2>
<p>
XOWA uses "scaling" and "ranking" at various stages to calculate the score.
</p>
<h3>
<span class="mw-headline" id="Scaling">Scaling</span>
</h3>
<p>
A simplified definition of scaling is converting a number from one range to another range based on proportion. For a more thorough definition, see <a href="https://en.wikipedia.org/wiki/Feature_scaling" rel="nofollow" class="external text">the Wikipedia page on feature scaling</a>
</p>
<p>
For example, let's say you have a score of 100 in a range of 0 to 400 and want to scale it to 0 to 1000. The following steps would be involved:
</p>
<ul>
<li>
Take 100 and divide it by 400. This yields .25
</li>
<li>
Take .25 and multiply it by 1000. This yields 250.
</li>
</ul>
<p>
The following formula is the basis for scaling:
</p>
<p>
<span id='xowa_math_txt_0'>newScore = \frac{oldScore - \text{min}(oldRange)} {\text{max}(oldRange)-\text{min}(oldRange)} \cdot (\text{max}(newRange)-\text{min}(newRange))</span>
</p>
<p>
Or, to use the example from above:
</p>
<p>
<span id='xowa_math_txt_0'>250 = \frac{100 - 0} {400-0} \cdot (1000-0)</span>
</p>
<h3>
<span class="mw-headline" id="Ranking">Ranking</span>
</h3>
<p>
A simplified definition of ranking is assigning a number based on its order in a population of numbers. For those familiar with a school setting, this is "grading on a curve". For a more thorough definition, see <a href="https://en.wikipedia.org/wiki/Percentile_rank" rel="nofollow" class="external text">the Wikipedia page on percentile ranks</a>
</p>
<p>
For example, let's say you have the following:
</p>
<ul>
<li>
A minimum score of 0
</li>
<li>
A maximum score of 100
</li>
<li>
5 entities with the following scores
<ul>
<li>
A : 99
</li>
<li>
B : 10
</li>
<li>
C : 42
</li>
<li>
D : 71
</li>
<li>
E : 56
</li>
</ul>
</li>
</ul>
<p>
Ranking would do the following:
</p>
<ul>
<li>
Sort the scores
<ul>
<li>
A : 99
</li>
<li>
D : 71
</li>
<li>
E : 56
</li>
<li>
C : 42
</li>
<li>
B : 10
</li>
</ul>
</li>
<li>
Calculate the "interval" for each score by taking the maximum and dividing by the number of scores.
<ul>
<li>
In this case, this would be 20: 100 / 5
</li>
</ul>
</li>
<li>
Assign each score a new score based on its proportionate position in the sort.
<ul>
<li>
A : 100
</li>
<li>
D : 80
</li>
<li>
E : 60
</li>
<li>
C : 40
</li>
<li>
B : 20
</li>
</ul>
</li>
</ul>
<p>
<br>
</p>
<h2>
<span class="mw-headline" id="Calculation">Calculation</span>
</h2>
<h3>
<span class="mw-headline" id="PageRank">PageRank</span>
</h3>
<p>
The basis of XOWA's page score is <a href="https://en.wikipedia.org/wiki/PageRank" rel="nofollow" class="external text">PageRank</a>.
</p>
<p>
In brief, PageRank will give high scores to pages which are:
</p>
<ol>
<li>
linked to by many pages
</li>
<li>
linked to by pages which have a high score.
</li>
</ol>
<p>
Note that #2 is recursive (a page will have a high score only if it is linked to by many pages). For more info, a good starting point is <a href="https://en.wikipedia.org/wiki/PageRank" rel="nofollow" class="external text">the Wikipedia page on PageRank</a>.
</p>
<p>
After XOWA calculates the PageRank, XOWA then scales this score in a range of 0 to 1,000,000
</p>
<h3>
<span class="mw-headline" id="Short_pages_are_penalized">Short pages are penalized</span>
</h3>
<p>
XOWA penalizes short pages. This reduces the effect of small stub pages which are linked to by many articles, but mostly from boilerplate navigation boxes.
</p>
<p>
XOWA ranks pages based on page-length. The generated score is in a range from 0 to 1,000,000
</p>
<p>
Currently the method is:
</p>
<ul>
<li>
If the page is in the bottom 60% of page lengths...
</li>
<li>
Then multiply the page score by that percentage.
</li>
</ul>
<p>
For example, a page that has a length in the bottom 10% and a score of 1000, will have a score of 100 (1000 * 10%). In contrast, a page that has a length in the top 65% with a score of 9,000 will still have a score of 9,000.
</p>
<p>
Note that this calculation is an ad-hoc creation and will probably change in the future.
</p>
<h3>
<span class="mw-headline" id="Scores_are_re-scaled">Scores are re-scaled</span>
</h3>
<p>
The final step is to take the modified score and rank it from 0 to 1,000,000. Note that this final score is an integer (not a decimal / float)
</p>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/home/wiki/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-started'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/home/wiki/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-android'>
<h3>Android</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Android/Setup.html" title='Setup XOWA on your Android device'>Setup</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="https://archive.org/donate/index.php" title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>

206
home/wiki/App/Search/Special_page.html Normal file
View File

@@ -0,0 +1,206 @@
<!DOCTYPE html>
<html dir="ltr">
<head>
<meta http-equiv="content-type" content="text/html;charset=UTF-8" />
<title>App/Search/Special page - XOWA</title>
<link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
<link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
<h1 id="firstHeading" class="firstHeading"><span>App/Search/Special page</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
<div id="contentSub"></div>
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
<h2>
<span class="mw-headline" id="Usage">Usage</span>
</h2>
<p>
If you enter a search string and press Enter, a list of pages beginning with the search term will appear.
</p>
<p>
For example, typing in "Earth" in en.wikipedia.org will retrieve a list of 345 page links. The first will be "Earth" and the other 344 will be pages that are sorted alphabetically after Earth (EX: "Earth's Age", "Earth's Answer").
</p>
<p>
Note that there are Previous and Next links at the top and bottom of the page to continue reading the next and previous list of pages
</p>
<p>
If a search term is entered for an unknown page like "Earth1", then XOWA will retrieve the first page that would sort after "Earth1". In this case it would be a page called "Earth2".
</p>
<p>
Note that sorting is done using binary collation. This means that the following titles will sort in this order "AA AB AC Aa Bb Ac", not "AA Aa AB Ab AC Ac". This matches Wikipedia's current sorting behavior.
</p>
<h2>
<span class="mw-headline" id="Configuring">Configuring</span>
</h2>
<p>
Currently, XOWA has not implemented the UI for dynamically changing the following:
</p>
<ul>
<li>
from
</li>
<li>
namespace
</li>
<li>
hideredirects
</li>
</ul>
<p>
This will be implemented in a future build. In the meantime, if you want to change these, you will need to change them in the url string.
</p>
<p>
For example, after searching for Earth, the url string will read:
</p>
<p>
<code><a href="http://en.wikipedia.org/wiki/Special:Allpages?from=Earth&amp;namespace=0&amp;hideredirects=0" rel="nofollow" class="external free">http://en.wikipedia.org/wiki/Special:Allpages?from=Earth&amp;namespace=0&amp;hideredirects=0</a></code>
</p>
<p>
If you want to hide redirects, change this to:
</p>
<p>
<code><a href="http://en.wikipedia.org/wiki/Special:Allpages?from=Earth&amp;namespace=0&amp;hideredirects=" rel="nofollow" class="external free">http://en.wikipedia.org/wiki/Special:Allpages?from=Earth&amp;namespace=0&amp;hideredirects=</a><span style="color:red;">1</span></code>
</p>
<p>
If you want to search in a different namespace, you have two options
</p>
<ul>
<li>
type "Template:Earth" into the search box. It will automatically parse the namespace from the search string. Note that non-English names will also work (Vorlage:Erde for German)
</li>
<li>
change the namespace arg to the numerical code for the namespace
</li>
</ul>
<dl>
<dd>
For example, to search for "Template:Earth" change "namespace=0" to "namespace=10"
</dd>
</dl>
<p>
Finally, the Search box can be configured within the config system. Currently the setting is the following:
</p>
<pre>
app.gui.win_opts.search_box_fmt_('Special:AllPages?from=~{search}&amp;namespace=0&amp;hideredirects=0');
</pre>
<p>
If you want to hide redirects by default, you can change this to hideredirects=1. Please see <a href="http://xowa.org/home/wiki/Dev/Config_files_files/Files.html" id="xolnki_2" title="Dev/Config files files/Files">Dev/Config_files files/Files</a> for information about where to make this change.
</p>
<h2>
<span class="mw-headline" id="Future">Future</span>
</h2>
<p>
As mentioned above, XOWA will add a basic UI for configuring from, namespace and hideredirects.
</p>
<p>
There are no current plans to implement the range functionality. For example, Wikipedia allows you to enter a <b>from</b> of "A" and a <b>to</b> of "Z". This will return a list of 60 groups of all the pages between "A" and "Z" (EX: A to An; Ao to Bd; Be to By).
</p>
<p>
This has a low priority for (a) performance reasons and (b) frequency of use reasons. It may be re-evaluated later. Feel free to contact me for further discussion.
</p>
</div>
</div>
</div>
<div id="mw-head" class="noprint">
<div id="left-navigation">
<div id="p-namespaces" class="vectorTabs">
<h3>Namespaces</h3>
<ul>
<li id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
</ul>
</div>
</div>
</div>
<div id='mw-panel' class='noprint'>
<div id='p-logo'>
<a style="background-image: url(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" title="Visit the main page"></a>
</div>
<div class="portal" id='xowa-portal-home'>
<h3>XOWA</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
<li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
<li><a href="http://xowa.org/home/wiki/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-started'>
<h3>Getting started</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
<li><a href="http://xowa.org/home/wiki/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
<li><a href="http://xowa.org/home/wiki/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-android'>
<h3>Android</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Android/Setup.html" title='Setup XOWA on your Android device'>Setup</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-help'>
<h3>Help</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Help/About.html" title='Get more information about XOWA'>About</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
<li><a href="http://xowa.org/home/wiki/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-blog'>
<h3>Blog</h3>
<div class="body">
<ul>
<li><a href="http://xowa.org/home/wiki/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-links'>
<h3>Links</h3>
<div class="body">
<ul>
<li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
<li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
<li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
</ul>
</div>
</div>
<div class="portal" id='xowa-portal-donate'>
<h3>Donate</h3>
<div class="body">
<ul>
<li><a href="https://archive.org/donate/index.php" title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
<li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
<!-- <li><a href="" title="Support XOWA! (but only after you've supported archive.org and Wikipedia)">XOWA</a></li> -->
</ul>
</div>
</div>
</div>
</body>
</html>