This syntax is a WiP and could change at any time. Currently, it allows for:
- Simple singular WORD (e.g., haxby)
or a "QUOTED STRING" (e.g., "James V. Haxby")
- Searching is case-insensitive at the moment, so haxby is identical to Haxby.
- Searching is performed within content rather than for entire words,
and so searching for ax would find Haxby,
tax, etc.
- By default, the following fields are searched: "url", "ds_id", "head", "head_describe", "branches",
"tags", "metadata".
To restrict the search to a specific field, specify the field name followed by : and
the search term, e.g.,
url:github or head:1.0 or metadata:"James Haxby".
- AND, OR, and NOT can be used for
logical operations.
- The default logical operator is AND, and so
searching for James Haxby is identical to searching for
James AND Haxby
or
Haxby AND James.
- AND and OR may not be mixed in the same
statement.
- Use ( and ) to group statements, e.g.,
(url:github.com OR url:gin.g-node) AND (Haxby (James OR Jim)).
- You can restrict a search to specific metadata extractors by specifying one or more of them,
e.g., metadata[bids_dataset,metalad_core]:"BIDSVersion\": \"v"
where the backslash is an escape character,
and the letter v is a stand-in for an actual version string.