Last edited 2 years ago
by WikiSysop

Search: Difference between revisions

No edit summary
Tag: 2017 source edit
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 22: Line 22:
'''Right column:'''
'''Right column:'''


*T'''ools and secondary results:''' Tools are displayed in the top portion of the right column and contain:
*'''Tools and secondary results:''' Tools are displayed in the top portion of the right column and contain:
**a button to create the page with the current search term as the title (only if user has permission to create new pages)
**a button to create the page with the current search term as the title (only if user has permission to create new pages).
**a button to execute full-text search for the current term. Selecting this option leads to the Search Center.
**a button to initiate the full-text search for the current term. Selecting this option opens the Search center.


In the bottom portion of the right column, secondary results are displayed. Secondary results are matches that do not directly match the given term, but might be relevant for the user. These show up only in certain contexts:
In the bottom portion of the right column, secondary results are displayed. Secondary results are matches that do not directly match the given term, but might be relevant for the user.  


*If there are significantly more matches for a similar term than the term actually searched for (in a situation of a typo for example)
===Namespace "pills"===
*If the namespace or subpage pill is present (see next section). In this case, secondary results will show direct matches in other namespaces/pages.
The autocomplete search bar supports pills for [[Namespaces|namespaces:]] [[File:extendedsearch-pilleEN.png|thumb|Namespace "pill"|none|link=Special:FilePath/extendedsearch-pilleEN.png]]
 
If a user types <code>Manual:</code>, a pill for the namespace "Manual" appears and the search for the following term is limited to this namespace.  
===Namespace and subpage "pills"===
Autocomplete search bar supports pills for namespaces and subpages. [[File:extendedsearch-pilleEN.png|thumb|Namespace "pill"|center|link=Special:FilePath/extendedsearch-pilleEN.png]]
If a user types <code>Manual:</code>, a pill for the namespace "Manual" appears and the search for the following term is limited to this namespace. .
Subpage pills work in the same way. If the user types in <code>PageName/</code>, any term after that is matched in the context of that page. If you search for "TestPage/Te", for example, the search will match only subpages of "TestPage" that contain "Te" in the title, like "TestPage/Test" and "TestPage/TestSubpage".


===Search operators===
===Search operators===
Since the autocomplete search only searches for titles, search operators such as AND or OR are not supported. However, they are supported using the Search Center.
Since the Quick search only searches for titles, search operators such as AND or NOT are not supported. However, they are supported in the Search center.


===Dates as search terms===
===Dates as search terms===
The search recognizes certain date formats. In the search center, these date formats are treated with surrounding quotation marks.  <gallery widths="400" heights="200">
The search recognizes certain date formats. In the search center, these date formats are treated with surrounding quotation marks.  <gallery widths="400" heights="200">
File:Manual:extendedsearch-datum1.png
File:extendedsearch-datum1.png
File:Manual:extendedsearch-datum2.png
File:extendedsearch-datum2.png
</gallery><br />
</gallery><br />
==Search Center (extended search)==
==Search center (Extended search)==
As soon as you trigger the full-search with the magnifying glass symbol or the ''Enter'' key, the wiki switches to the Search Center. This is a special page that offers the full functionality of the search. The search in the Search Center is carried out using the same search bar that is also used for autocomplete.
As soon as you trigger the full-text search with the magnifying glass symbol or the ''Enter'' key, the search switches to the Search center. It does not index the source code of a wiki page, but rather the rendered content.<br />
Here, the search engine carries out a full text search, which also includes the metadata of documents. It does not index the wikitext of a wiki page, but rather the rendered content, that is the output by the browser.<br />
[[File:extendedsearch-searchcenter.png|link=link=Special:FilePath/ExtendedSearch2.png|none|thumb|402x402px|Search Center]]
[[File:Manual:extendedsearch-searchcenter.png|link=link=Special:FilePath/ExtendedSearch2.png|alt=|center|thumb|402x402px|Search Center]]


===Search operators===
===Search operators===
To use search operators in the full-text search, the following syntax can be used:
To use search operators in the full-text search, the following syntax can be used:


*Sandbox '''AND'''  Widgets - returns pages that contain both the term sandbox and the term widgets
*Sandbox '''AND'''  widget - returns pages that contain both the term sandbox and the term widget.
*Sandbox '''OR''' Widgets - returns pages that contain either the term sandbox or the term widgets.
*Sandbox '''OR''' Widgets - returns pages that contain either the term sandbox or the term widgets.
*(Sandbox) '''NOT''' (Widgets) - returns pages that contain the term sandbox but not the term widgets..<br />
*(Sandbox) '''NOT''' (Widgets) - returns pages that contain the term sandbox but not the term widgets. <br />


The search operators have to be written in uppercase letters.
The search operators have to be written in uppercase letters. The search terms are matched exactly. Wildcards are necessary to widen the search (Sandbox* AND Widget*).


===Elements===
===Elements===
Line 62: Line 57:
*'''Hit count''' - shows how many matches a search has returned. It may be exact or approximate. Approximation is due to dynamic check for permissions to view each page in the results, some results may not be shown to the user with no adequate permissions event if it matches the search term.
*'''Hit count''' - shows how many matches a search has returned. It may be exact or approximate. Approximation is due to dynamic check for permissions to view each page in the results, some results may not be shown to the user with no adequate permissions event if it matches the search term.
*'''Tools''' - these are located in the top right as a set of buttons:
*'''Tools''' - these are located in the top right as a set of buttons:
**Create a page - represented by a "plus" button - will create a page with current search term as a title (only visible if user has permission to  create pages)
**'''Plus-button:''' Creates a page with current search term as a title (only visible if user has permission to  create pages)
**Add filters - represented by a "funnel" icon - opens a dialog where users can select the type of filter to apply to the search.<br />[[File:Manual:extendedsearch3.png|link=link=https://en.wiki.bluespice.com/wiki/File:ExtendedSearch3.png|alt=|center|thumb|341x341px|Adding filters]]
**'''Funnel-button:''' Opens a dialog where users can select additional filters.<br />[[File:extendedsearch3.png|link=link=https://en.wiki.bluespice.com/wiki/File:ExtendedSearch3.png|none|thumb|341x341px|Adding filters]]
**Search options - represented by a "gear" icon - opens a dialog where users can change settings for the current search. It provides options like the number of results per page, sorting field and order.<br />[[File:Manual:extendedsearch4.png|link=link=Special:FilePath/ExtendedSearch5.png|alt=|center|thumb|Options dialog]]
**'''Gear-button:'''Formatting options like the number of results per page, sorting field and order.<br />[[File:extendedsearch4.png|link=link=Special:FilePath/ExtendedSearch5.png|none|thumb|Options dialog]]
**Export search - represented by the "export" icon - opens a dialog to export current search results to a dedicated page (only visible to authorized users, by default admin users).
**'''Export-button:''' Opens a dialog to export current search results to a dedicated page (only visible to authorized users, by default admin users).


*'''Filter:''' Filters are displayed in form of pills below the results counter. Each filter pill represents a different attribute. Filter values can be changed by clicking on the filter pill and selecting the desired options from the popup that will open. Filter can be removed by clicking on  the "x" button in each pill.<br />[[File:Manual:extendedsearch2.png|link=link=Special:FilePath/ExtendedSearch4.png|alt=|center|thumb|Editing filter]]
*'''Filter:''' Filters are displayed in form of "search pills" below the results counter.Filter values can be changed by clicking on the filter pill and selecting the desired options from the popup. Filters can be removed by clicking on  the "x" button in each pill.<br />[[File:extendedsearch2.png|link=link=Special:FilePath/ExtendedSearch4.png|none|thumb|Editing filter]]
*'''Results:''' If current search criteria field any results, a list of results is displayed. The information available in the results is depending on the result type):
*'''Results:''' If current search criteria field any results, a list of results is displayed. The information available in the results is depending on the result type):
**Main title of the result (page title, file name...)
**Main title of the result (page title, file name...)
Line 74: Line 69:
**Thumb image (for images) or file type icon (for other file types)
**Thumb image (for images) or file type icon (for other file types)
**Redirect information
**Redirect information
**Original name (for wikipages, if the page display title is different than the actual page title)
**Original name (for pages, if the page display title is different than the actual page title)
**Secondary information like page categories, modification and creation date, author, etc.
**Secondary information like page categories, modification and creation date, author, etc.
**Snippet of the matches in the content of the page (if there are matches in the page content),
**Snippet of the matches in the content of the page (if there are matches in the page content)
**Sections with matches in the content (for wikipages)
**Sections with matches in the content (forpages)
 
In case there is an exact match for a given search term, the result that matches exactly is displayed as a "featured" result.


In case there is an exact match for a given search term, the result that matches exactly is displayed as a "featured" result. Such a result displays a preview image of the page and always displays the content snippet, regardless of whether there are matches in the content or not.
== Easy Tasks/Projects ==
To find articles from an Easy Task or Project, click the light bulb icon in the side menu.
[[File:Search Easy.png|alt=Knowledge base search field|none|thumb|400x400px|Knowledge base search field]]
[[Category:Concept]]

Latest revision as of 12:06, 30 September 2022

Articles and files are indexed immediately and available for searching in real-time.

Types of search

  1. Quick search: Searches article and file names and titles (no fulltext-search)
  2. Search center: Completes a full-text search of all articles and files in the wiki. It also searches in Easy Tasks and Projects.
  3. Easy Tasks/Project: Provides a dedicated search bar to search for articles.

Quick search

The search box in the Header bar with autocomplete functionality is active as long as a user is not on the Search center page. Autocomplete matches only page and file titles and names, but does not provide a full-text search.

When typing in the Quick search bar, an autocomplete popup appears.

Quick search bar
Quick search bar

This popup is divided in two columns.

Left column:

  • Primary results: These are the results that are direct matches for the search term. The exact matches are shown in bold letters.
  • When looking for the term "quality management", it is also possible to type in "qual man" and the search starts looking for matches
  • The best match is often shown with a thumbnail preview as a top search result

Right column:

  • Tools and secondary results: Tools are displayed in the top portion of the right column and contain:
    • a button to create the page with the current search term as the title (only if user has permission to create new pages).
    • a button to initiate the full-text search for the current term. Selecting this option opens the Search center.

In the bottom portion of the right column, secondary results are displayed. Secondary results are matches that do not directly match the given term, but might be relevant for the user.

Namespace "pills"

The autocomplete search bar supports pills for namespaces:

Namespace "pill"

If a user types Manual:, a pill for the namespace "Manual" appears and the search for the following term is limited to this namespace.

Search operators

Since the Quick search only searches for titles, search operators such as AND or NOT are not supported. However, they are supported in the Search center.

Dates as search terms

The search recognizes certain date formats. In the search center, these date formats are treated with surrounding quotation marks.


Search center (Extended search)

As soon as you trigger the full-text search with the magnifying glass symbol or the Enter key, the search switches to the Search center. It does not index the source code of a wiki page, but rather the rendered content.

Search Center

Search operators

To use search operators in the full-text search, the following syntax can be used:

  • Sandbox AND widget - returns pages that contain both the term sandbox and the term widget.
  • Sandbox OR Widgets - returns pages that contain either the term sandbox or the term widgets.
  • (Sandbox) NOT (Widgets) - returns pages that contain the term sandbox but not the term widgets.

The search operators have to be written in uppercase letters. The search terms are matched exactly. Wildcards are necessary to widen the search (Sandbox* AND Widget*).

Elements

  • Hit count - shows how many matches a search has returned. It may be exact or approximate. Approximation is due to dynamic check for permissions to view each page in the results, some results may not be shown to the user with no adequate permissions event if it matches the search term.
  • Tools - these are located in the top right as a set of buttons:
    • Plus-button: Creates a page with current search term as a title (only visible if user has permission to create pages)
    • Funnel-button: Opens a dialog where users can select additional filters.
      Adding filters
    • Gear-button:Formatting options like the number of results per page, sorting field and order.
      Options dialog
    • Export-button: Opens a dialog to export current search results to a dedicated page (only visible to authorized users, by default admin users).
  • Filter: Filters are displayed in form of "search pills" below the results counter.Filter values can be changed by clicking on the filter pill and selecting the desired options from the popup. Filters can be removed by clicking on the "x" button in each pill.
    Editing filter
  • Results: If current search criteria field any results, a list of results is displayed. The information available in the results is depending on the result type):
    • Main title of the result (page title, file name...)
    • Result type
    • Size and extension (for files)
    • Thumb image (for images) or file type icon (for other file types)
    • Redirect information
    • Original name (for pages, if the page display title is different than the actual page title)
    • Secondary information like page categories, modification and creation date, author, etc.
    • Snippet of the matches in the content of the page (if there are matches in the page content)
    • Sections with matches in the content (forpages)

In case there is an exact match for a given search term, the result that matches exactly is displayed as a "featured" result.

Easy Tasks/Projects

To find articles from an Easy Task or Project, click the light bulb icon in the side menu.

Knowledge base search field
Knowledge base search field