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

3.1.1:search [2010/06/22 11:01]
Stephan Tittel
3.1.1:search [2010/09/16 13:13] (current)
Line 1: Line 1:
 +====== Searching resources ======
 +The search function of docendo enables you to find resources for re-use. Searching can either be done from the [[.:browser|Resource Browser]] or from various editors e.g. when you want to add media resources to a section or import an existing section into a course. docendo uses the metadata fields //title//, //keywords//, //description// and //author// to look for matches of the given search key. In addition, docendo does full-text search upon resources that consist of text (or XML).
 +<box 230px left round blue>
 +{{.:screenshots:search.png?200|Searching resources}}
 +</box|Screenshot: Searching resources>
 +The search result list will contain all matches of your search query on which you have read or write access permission. For the concept of access permissions, please refer to the [[acl|corresponding wiki page]]. By default, one search result page lists 20 resources - in order to browse the result list, use the navigation controls on the bottom of the page. The default search result order is by //relevance//: a hit is considered to be more relevant the more often the given search key appears in the metadata fields or text content of the resource. Resources that are referenced (re-used) very often will get higher scores and thus will more likely appear at the top of the search result list.
 +For each resource in the search result list, its metadata fields //title//, //description//, //keywords//, //authors// are displayed. If the resource has a license assigned to it, it will be shown to the right of the title (see screenshot). When matches have been found on its text content, a corresponding excerpt or snippet will be shown, where the search key gets highlighted in red color. In order to see what a resource from the search result list looks like, click on its title or [[resource_type_icons|resource type icon]].
 +===== Wildcard search =====
 +docendo accepts the characters //**?**// and **//*//** as [[wp>Wildcard_character|wildcards]] (or placeholders) in seach queries. The character **//*//** may be used as a substitute for any zero or more characters whereas the character //**?**// for exactly one.
 +<note tip>To get a list of all resources that you have read or write access on, simply search for **//*//**.</note>
 +<box 600px left round blue|Examples: Wildcard searches>
 +^ Search key ^ Valid hits ^
 +| * | All words |
 +| doc* | All words starting with "doc" |
 +| doc*do | All words starting with "doc" and ending with "do" |
 +| doc*d? | All words starting with "doc" and having "d" as the last but one character |
 +===== Extended search options =====
 +<box 230px right round blue>
 +{{.:screenshots:search_extended.png?200|Extended search options}}
 +</box|Screenshot: Extended search options>
 +It is possible to restrict the search with respect to which metadata fields are searched and what resource types should be found using the extended search options. Click on the link "//Show extended search options//" to see them.
 +The extended search options allow to change the sort order of the search result (Relevance / Title / Resource type / Last modified / Creation date), on which data to search (Title / Keywords / Description / Text content) and which resource types should be contained in the search result. In the screenshot to the right, the extended search options are highlighted with a green box.
 +<note tip>If you want to search just for your own resources, enable the checkbox "//Only own resources//" from the extended search options.</note>
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki