View source for The Broken Dagger Wiki:Searching

This article provides an overview of BDWiki's search feature, as well as using external search engines, such as <tt>[http://www.google.com Google]</tt>, to find information.

==BDWiki search==
test
The searchbox provides an input field with two buttons:
* '''Go''' - the ''Go'' button (or ''Enter'' on the keyboard), will take you automatically to the best match for the entered keyword.
* '''Search''' - the ''Search'' button will return a list of matching results.

===Effective searching===
Here are few good tips and hints for using the BDWiki search feature effectively:

====Limiting results====
* '''Any word''': BDWiki's default search mode will turn up results with '''''any''''' of the words in your query. For instance, <tt>[http://www.wikipedia.org/w/wiki.phtml?search=search+engine search engine]</tt> turns up many results containing only "search" but not "engine" or only "engine" but not "search" in addition to the ones you probably wanted, which contain both words. 
* '''All words''': To limit to results that include '''''all''''' words, put a "+" at the beginning of each word: <tt>[http://www.wikipedia.org/w/wiki.phtml?search=%2Bsearch+%2Bengine +search +engine]</tt> returns only pages containing both words, like Google's default mode.  You can also do a phrase search by enclosing words in quotes: <tt>[http://www.wikipedia.org/w/wiki.phtml?search=%22search+engine%22 "search engine"]</tt> turns up a smaller set of results, which not only have both words but have them in order.
* '''Exclude words''': To exclude results that include some words, put a "-" at the beginning: <tt>[http://www.wikipedia.org/w/wiki.phtml?search=search+-engine search -engine]</tt> 

Boolean search is also possible, using words including "AND", "OR", and "NOT". 

====Avoid short and common words====
If your search terms include a common "stop word" (such as "the", "one", "your", "more", "right", "while", "when", "who", "which",
"such", "every", "about") it may give a large number of non-relevant results. Historically, these words [[BDWiki:Common words, searching for which is not possible|could not be searched]] but as of February 2006, BDWiki's Lucene index does not use "stop words", so any word can be successfully used in search queries.

====Wildcards====
You can use some limited wildcards if you really want to. Look up "[http://dev.mysql.com/doc/mysql/en/fulltext-boolean.html fulltext search]" on http://www.mysql.com/ and look down under 'boolean search' for the details. However, wildcard searches are slower, so go easy on the poor server.

====Words with special characters====
In a search for a word with a [[diaeresis]], such as Sint Odili&euml;nberg, it depends whether this ë is stored as one character or as "&amp;euml;". In the first case one can simply search for Odilienberg (or Odili&euml;nberg); in the second case it can only be found by searching for Odili, euml and/or nberg.  This is actually a bug that should be fixed -- the entities should be folded into their raw character equivalents so all searches on them are equivalent. See also [[BDWiki:Special characters]].

====Words in single quotes====
If a word appears in an article with single quotes, you can only find it if you search for the word with quotes. Since this is rarely desirable it is better to use double quotes in articles, for which this problem does not arise. See the [[BDWiki:manual of style|manual of style]] for more info.

An apostrophe is identical to a single quote, therefore Mu'ammar can be found searching for exactly that (and not otherwise). A word with apostrophe s is an exception in that it can be found also searching for the word without the apostrophe and the s.

====Namespaces searched by default====
The search only applies to the namespaces selected in the user's [[special:preferences|preferences]]. To search the other namespaces check or uncheck the tickboxes in "Search in namespaces" box found at the bottom of a search results page. Depending on the browser, a box may still be checked from a previous search, but without being effective any longer! To make sure, uncheck and recheck it.

Searching the image namespace means searching the image descriptions, i.e. the first parts of the image description pages.

====The source text is searched====
The source text (what one sees in the edit box, also called [[wiki text]]) is searched. This distinction is relevant for [[piped link]]s, for [[BDWiki:interlanguage link]]s (to find links to Chinese articles, search for zh, not for Zhongwen), special characters (if ê is coded as &amp;ecirc; it is found searching for ecirc), etc.

====Delay in updating the search index====
For reasons of efficiency and priority, very recent changes are not always immediately taken into account in searches.

At the moment, the search engine uses an index that isn't updated at all.

====Search BDWiki from the sidebar search tab or address bar====
Works with: Mozilla Suite, Mozilla Firefox, Netscape 6/7.

Mozilla and Netscape 6 & 7 come with a sidebar that allows a user to search the BDWiki site, and Firefox has a toolbar item to do the same. To install the search plugin that tells Mozilla how to search BDWiki, do the following:

===Searching the page history===
To search the text that appears only in the page history, you must [[special:export|export]] the text to [[XML]] format first. 

==If you cannot find an appropriate page on BDWiki==
If there is no appropriate page on BDWiki, consider [[BDWiki:How to start a page|creating a page]], since [[Welcome, newcomers|you]] can edit BDWiki right now.  Or consider adding what you were looking for to the '''[[Requested articles]]''' page. Or if you have a question, then see '''[[BDWiki:Questions|Where to ask questions]]''', which is a list of departments where our volunteers answer questions, any question you can possibly imagine.<br>

==See also==
* [[BDWiki:Look it up]], for a general guide.
* [[BDWiki:User preferences help]], "Search result settings" section.
* [[BDWiki:Go button]]

[[Category:BDWiki features|{{PAGENAME}}]]