# App/Search/Address bar

From XOWA: the free, open-source, offline wiki application

XOWA can search for a page using the url-bar.

## Auto-complete

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 App/Search/Build for more information.

## Basic details

### UI

- Searches return 10 results: To change the number, see Options/Search_suggest
- The keys "up" / "down" / "page-up" / "page-down" works like Firefox: The url-bar is meant to emulate Firefox's behavior. This includes:
  - Pressing "up" in the first row transfers focus to the url bar.
  - Pressing "up" in the url bar goes goes to the last row.
  - Pressing "page-up" jumps up by 5 rows. This number can be changed at Options/Search_suggest.
  - Pressing "page-up" when there is less than 5 rows will jump to the first row.
  - Pressing "page-up" in the first row transfers focus to the url bar.
  - Pressing "page-up" in the url bar goes to the last row.
  - For "down" and "page-down" the reverse is true.

### General

- Searches sort by page score: By convention, XOWA scores every page with percentile ranking ("graded curve") from 0 to 1,000,000. Page score is based on https://en.wikipedia.org/wiki/PageRank . In short, a page has a high page score if there are many pages linking to it. For more info, see App/Search/Score
- Searches find a page that matches the text and list it as the first result: 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)
- Searches are case-insensitive: There is no difference between searching for "earth" or "Earth" or "EARTH" or "earTH".
- Searches match any word in the page title.: For example, searching for "earth" not only matches "Earth" and "Earth Day", but also "History of Earth" and "Future of Earth"

### Wildcard

- Searches automatically have a wildcard at the end: 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..
- Searches can have an explicit wildcard: For example, searching for "ear* hist" can return "History of Earth" as well as "Early Modern History".
- Searches can be unwildcarded with a space: For example, searching for "earth " (earth and a single space) will return "Earth" and "History of Earth" but not "Earthquake", "Earthworm", "Earthenware", etc..

### Punctuation

- Searches can use punctuation: 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.
- Searches can filter out words using a dash: For example, searching for "earth -middle" will return "Earth", but not "Middle-Earth"

### Redirects

- Redirects are identified with a "->" as well as the name of the redirect destination. For example, "Near-Earth asteroid" shows as "Near-Earth asteroid -> Near-Earth object". This can be interpreted as the "Near-Earth asteroid" redirect which leads to the "Near-Earth object" page.
- Searches remove redundant redirects: 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.)

## Performance

As a brief guide, the following illustrates which search terms will be faster than others.

### Very fast

- Exact title match: For example, "earth" will be fast as it matches the page "Earth" exactly. (Technically, it searches the page table using the page_title index)
- One word with no wildcards: For example, "earth " will be fast as it matches the "earth" word exactly. (Technically, it searches the search_link table using word_id)

### Fast

- One word with a wildcard: 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)
- Many words with a wildcard: 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"

### Slow

- Many words with each word being linked to many pages but resulting in low-scored pages: For example, "page meg*" will only match one page in English Wikipedia: "Megan Page".

### XOWA

- Main page
- Screenshots
- Video
- Download XOWA
- Download wikis

### Getting started

- Requirements
- Installation
- Simple Wikipedia
- English Wikipedia
- Other Wikipedias

### Android

- Setup
- Video

### Help

- About
- Contents
- Media
- Feedback

### Blog

- Current

### Links

- Wikimedia dumps
- XOWA @ archive.org
- English Wikipedia

### Donate

- archive.org
- Wikipedia
- XOWA