Differences

This shows you the differences between two versions of the page.

--- search [2015-08-23 18:12] – [Search] 87.117.189.18
+++ search [2023-11-29 05:23] (current) – [Some Background on the Searchindex] state that numbering starts at 0 in page.idx schplurtz
@@ Line 1: / Line 1: @@
 ====== Search ======
-Search is done through the Search box in top <del>row</del> (when using the default [[template]]).
+Search is done through the Search box in top row (when using the default [[template]]).
 ===== Syntax =====
@@ Line 49: / Line 50: @@
 ===== OpenSearch =====
-{{ :opensearch.png|OpenSearch in Firefox}}
+{{ :opensearch2.png|OpenSearch in Firefox}}
 [[http://www.opensearch.org/|OpenSearch]] is a standard to make it easy to integrate a website's search into your browser. It is supported by all modern browsers. DokuWiki is OpenSearch enabled.
-Here is how to add your Wiki's search to Firefox (other browsers probably handle it in a similar way):
+Here is how to add your wiki's search to Firefox (other browsers probably handle it in a similar way):
   - open your wiki in the browser
-  - click the little arrow on the left of your search field
+  - click the magnifying glass on the left of your browser's search field
-  - choose "Add DokuWiki" ((It might be named different if your Wiki is named different))
+  - choose "Add <your wiki's title>", e.g. "Add DokuWiki"
 ===== Some Background on the Searchindex =====
@@ Line 63: / Line 64: @@
 DokuWiki now uses an index to search even big wikis very fast, to be able to find anything the index needs to be filled with current data. Information about a page's content is added and updated when a page is viewed by a user. Each page includes an invisible image ([[wp>webbug]]) which calls the index update process if needed.((Note that the webbug is used for other tasks, too.  See http://forum.dokuwiki.org/post/3116))  (That is, if the timestamp of the page is newer than the timestamp of the index file.)
-The index consists of files called ''page.idx'', ''w//[n]//.idx'' and ''i//[n]//.idx'' located in the index directory. ''w//[n]//.idx'' contains a list of all words (except stopwords) with a length of //n// that appear on the wiki pages. For every line in ''w//[n]//.idx'' there is a line in the corresponding ''i//[n]//.idx'' file that contains page references in the form of ''pn*freq''. ''pn'' is a line number for ''page.idx'', ''freq'' denotes how often the word appears on the page. Multiple page references are separated with a colon.
+The index consists of files called ''page.idx'', ''w//[n]//.idx'' and ''i//[n]//.idx'' located in the index directory. ''w//[n]//.idx'' contains a list of all words (except stopwords) with a length of //n// that appear on the wiki pages. For every line in ''w//[n]//.idx'' there is a line in the corresponding ''i//[n]//.idx'' file that contains page references in the form of ''pn*freq''. ''pn'' is a line offset for ''page.idx'', ''freq'' denotes how often the word appears on the page. Multiple page references are separated with a colon.
-The [[indexer]] uses a language specific stopword file which contains a list of very common words which will never be indexed (e.g. the word ''the'' in English). Searching for such a word will not return any hits. This stopword file is located in language folder of the DokuWiki installation, that is <dokuwiki>/inc/lang/<language>/stopwords.txt so you can edit the file in proper folder for adding or removing words not indexed for that language.
+The [[taskrunner|indexer]] uses a language specific stopword file which contains a list of very common words which will never be indexed (e.g. the word ''the'' in English). Searching for such a word will not return any hits. This stopword file is located in language folder of the DokuWiki installation, that is ''<dokuwiki>/inc/lang/<language>/stopwords.txt'' so you can edit the file in proper folder for adding or removing words not indexed for that language (Unfortunately, these edits are not kept on upgrades of DokuWiki).
 If you upgraded your wiki from an older version without an index, your search won't return anything until the index is built. You can either wait until this happens by browsing your wiki or install the [[plugin:searchindex]] plugin. You can also use the provided [[cli|commandline script]] for updating the index.
+===== See also =====
+  * [[faq:searchindex|Search Index Issues]]
+  * [[config:search_fragment|Configuration Setting: search_fragment]]
+  * [[config:search_nslimit|Configuration Setting: search_nslimit]]
+  * [[config:readdircache|Configuration Setting: readdircache]]
+  * [[plugintag>search|Plugins tagged with "search"]]