Rooba
/
perkeep
mirror of https://github.com/perkeep/perkeep.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge "No 'and' or 'or' yet. Added description for attr and tag."

This commit is contained in:
Brad Fitzpatrick 2014-03-12 21:52:23 +00:00 committed by Gerrit Code Review
parent 607a20f349 6d9117f1c0
commit 9bd781c453
1 changed files with 25 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
doc/search-ui.txt
View File

@ -1,30 +1,42 @@
The User Interface's "Search" box understands simple (no grouping) The User Interface's "Search" box accepts a space-separated list of predicates of the
boolean expressions of "operator:value" expressions stitched together with form "[-]operator:value[:value]". These predicates are combined using conjunction.
"and" and "or" words, separated by spaces. That is to say we only have 'and' and atom negation for now.
Negation is achieved by prepending a minus sign: -is:landscape will match Negation of a predicate is achieved by prepending a minus sign: -is:landscape will match
with pictures of not landscape ratio. with pictures of not landscape ratio.
For example For example
after:"2010-01-01" and before:"2010-03-02T12:33:44" or loc:"Amsterdam" after:"2010-01-01" before:"2010-03-02T12:33:44" -loc:"Amsterdam"
will return all images having "modtime" between before and after or having will return all images having "modtime" between before and after and not in Amsterdam.
location in Amsterdam.
When you need to match a value containing a space, you need to using double quotes around
the value only. For example: tag:"Three word tagname" and not "tag:Three word tagname".
If your value contains double quotes you can use backslash escaping.
For example: attr:bar:"He said: \"Hi\""
Usable operators: Usable operators:
after: date format is RFC3339, but can be shortened as required. after: date format is RFC3339, but can be shortened as required.
before: i.e. 2011-01-01 is Jan 1 of year 2011 and "2011" means the same. before: i.e. 2011-01-01 is Jan 1 of year 2011 and "2011" means the same.
attr: match on attribute. Use attr:foo:bar to match nodes having their foo
attribute set to bar.
format: file's format (or MIME-type) such as jpg, pdf, tiff. format: file's format (or MIME-type) such as jpg, pdf, tiff.
has:location image has a location (GPSLatitude and GPSLongitude can be has:location image has a location (GPSLatitude and GPSLongitude can be
retrieved from the image's EXIF tags). retrieved from the image's EXIF tags).
loc: loc:"new york, new york" or "loc:new york, new york" both work. loc: uses the EXIF GPS fields to match images having a location near
If specified, only images having a location near the specified location. Locations are resolved using
the specified locations are matched. maps.googleapis.com. For example: loc:"new york, new york"
Locations are resolved using maps.googleapis.com.
is:image object is an image is:image object is an image
is:landscape the image has a landscape aspect is:landscape the image has a landscape aspect
is:pano the image's aspect ratio is over 2 - panorama picture. is:pano the image's aspect ratio is over 2 - panorama picture.
is:portrait the image has a portrait aspect. is:portrait the image has a portrait aspect.
height: image's height height: use height:min-max to match images having a height of at least min
width: the image's width and at most max. Use height:min- to specify only an underbound and
height:-max to specify only an upperbound.
Exact matches should use height:640-640
tag: match on a tag
width: use width:min-max to match images having a width of at least min
and at most max. Use width:min- to specify only an underbound and
width:-max to specify only an upperbound.
Exact matches should use width:480-480