Skip to content

Latest commit

 

History

History
148 lines (116 loc) · 4.68 KB

search.rst

File metadata and controls

148 lines (116 loc) · 4.68 KB

Searching

.. versionadded:: 3.9

Advanced queries using boolean operations, parentheses, or field specific lookup can be used to find the strings you want.

When no field is defined, the lookup happens on :guilabel:`Source`, :guilabel:`Translate` and :guilabel:`Context` fields.

/screenshots/search.png

Simple search

Any phrase typed into the search box is split into words. Strings containing any of them are shown. To look for an exact phrase, put "the searchphrase" into quotes (both single (') and double (") quotes will work): "this is a quoted string" or 'another quoted string'.

Fields

source:TEXT
Source string case insensitive search.
target:TEXT
Target string case insensitive search.
context:TEXT
Context string case insensitive search.
key:TEXT
Key string case insensitive search.
note:TEXT
Comment string case insensitive search.
location:TEXT
Location string case insensitive search.
priority:NUMBER
String priority.
added:DATETIME
Timestamp for when the string was added to Weblate.
state:TEXT
State search (approved, translated, needs-editing, empty, read-only), supports :ref:`search-operators`.
pending:BOOLEAN
String pending for flushing to VCS.
has:TEXT
Search for string having attributes - plural, context, suggestion, comment, check, dismissed-check, translation, variant, screenshot, flags, explanation, glossary, note.
is:TEXT
Search for string states (pending, translated, untranslated).
language:TEXT
String target language.
component:TEXT
Component slug or name case insensitive search, see :ref:`component-slug` and :ref:`component-name`.
project:TEXT
Project slug, see :ref:`project-slug`.
changed_by:TEXT
String was changed by author with given username.
changed:DATETIME
String content was changed on date, supports :ref:`search-operators`.
change_time:DATETIME
String was changed on date, supports :ref:`search-operators`, unlike changed this includes event which don't change content and you can apply custom action filtering using change_action.
change_action:TEXT
Filters on change action, useful together with change_time. Accepts English name of the change action, either quoted and with spaces or lowercase and spaces replaced by a hyphen. See :ref:`search-changes` for examples.
check:TEXT
String has failing check.
dismissed_check:TEXT
String has dismissed check.
comment:TEXT
Search in user comments.
comment_author:TEXT
Filter by comment author.
suggestion:TEXT
Search in suggestions.
suggestion_author:TEXT
Filter by suggestion author.
explanation:TEXT
Search in explanations.

Boolean operators

You can combine lookups using AND, OR, NOT and parentheses to form complex queries. For example: state:translated AND (source:hello OR source:bar)

Field operators

You can specify operators, ranges or partial lookups for date or numeric searches:

state:>=translated
State is translated or better (approved).
changed:2019
Changed in year 2019.
changed:[2019-03-01 to 2019-04-01]
Changed between two given dates.

Exact operators

You can do an exact match query on different string fields using = operator. For example, to search for all source strings exactly matching hello world, use: source:="hello world". For searching single word expressions, you can skip quotes. For example, to search for all source strings matching hello, you can use: source:=hello.

Searching for changes

.. versionadded:: 4.4

Searching for history events can be done using change_action and change_time operators.

For example, searching for strings marked for edit in 2018 can be entered as change_time:2018 AND change_action:marked-for-edit or change_time:2018 AND change_action:"Marked for edit".

Regular expressions

Anywhere text is accepted you can also specify a regular expression as r"regexp".

For example, to search for all source strings which contain any digit between 2 and 5, use source:r"[2-5]".

Predefined queries

You can select out of predefined queries on the search page, this allows you to quickly access the most frequent searches:

/screenshots/query-dropdown.png

Ordering the results

There are many options to order the strings according to your needs:

/screenshots/query-sort.png