Nepomuk/kioslaves/search: Difference between revisions
(Testing queries) |
|||
| (One intermediate revision by the same user not shown) | |||
| Line 67: | Line 67: | ||
Nepomuk offers a variety of different operators that can be used be used: | Nepomuk offers a variety of different operators that can be used be used: | ||
* Contains ''':''' | * Contains ''':''' | ||
* Less ''<''' | * Less '''<''' | ||
* Equal '''=''' | * Equal '''=''' | ||
* Greater '''>''' | * Greater '''>''' | ||
| Line 75: | Line 75: | ||
Example - <tt>nepomuksearch:/rating<4 and width=320</tt>. This will search for all the files which have a rating less than 4 and a width of 320. | Example - <tt>nepomuksearch:/rating<4 and width=320</tt>. This will search for all the files which have a rating less than 4 and a width of 320. | ||
= Testing Queries = | |||
The simplest way to test a query is through the command line | |||
<code> | |||
kioclient list 'nepomuksearch:/rating<5' | |||
</code>. This will print out all the files with a rating < 5. Once you are satisfied with the query you can run it in the proper application by typing | |||
<code> | |||
kioclient exec 'nepomuksearch:/rating<5' | |||
</code> | |||
Latest revision as of 14:31, 28 January 2013
This page documents how the features provided by the 'nepomuksearch' kioslave.
Introduction
Nepomuk allows the creation of custom search folders via the 'nepomuksearch' kioslave. This kioslave can understand a number of different queries based on the custom Nepomuk query language.
The syntax for using the kioslave is as follows - nepomuksearch:/?query='Query' or nepomuksearch:/Query. Here "Query" is the special Nepomuk query.
Though Nepomuk stores a lot of different information, this kioslave will only show information that can be represented as a file.
Nepomuk Queries
Simple Queries
The simplest queries are just simple strings that can be used for full text search. Example - nepomuksearch:/Coldplay will search for all the files which contain the word "Coldplay".
Tag Queries
You can look for files which have been tagged with certain tags by writing the following query -
nepomuksearch:/hasTag:KDE
Combining different Queries
Multiple queries can be combined with the AND and OR operators. For example - Searching for a file with multiple tags - nepomuksearch:/hasTag:KDE and hasTag:Fire.
Negation
Certain properties of the query can be negated using the - operator.
Example - nepomuksearch:/hasTag:KDE and -hasTag:Fire. This will search for all the files which have the tag KDE and do not have the Fire.
Searchable Properties
hasTag is just one of the many properties that can be used for searching in Nepomuk. Here is a list of some of the most commonly used properties -
General Properties
- title: - The title of the file. Useful for documents
- filename - The filename
- hasTag:
- numericRating
Music Properties
- performer:
- musicAlbum:
Audio Properties
- duration: - Has to be written in seconds
- channels - Generally 1/2
Video Properties
- duration
- width
- height
Image Properties
- width
- height
- flash
- whiteBalance
- isoSpeedRatings
- saturation
- model
- make
- sharpness
- orientation
Search Operators
Nepomuk offers a variety of different operators that can be used be used:
- Contains :
- Less <
- Equal =
- Greater >
- LessEqual <=
- GreaterEqual >=
Example - nepomuksearch:/rating<4 and width=320. This will search for all the files which have a rating less than 4 and a width of 320.
Testing Queries
The simplest way to test a query is through the command line
kioclient list 'nepomuksearch:/rating<5'
. This will print out all the files with a rating < 5. Once you are satisfied with the query you can run it in the proper application by typing
kioclient exec 'nepomuksearch:/rating<5'