From 93d497f7adc22a0d504318d697fc08942327e830 Mon Sep 17 00:00:00 2001 From: Zweibach Date: Sun, 17 Apr 2022 17:59:03 +0200 Subject: [PATCH] Deleting the old search page and moved section from tags page --- docs/getting_started_searching.md | 86 ------------------------------- docs/getting_started_tags.md | 2 - 2 files changed, 88 deletions(-) delete mode 100644 docs/getting_started_searching.md diff --git a/docs/getting_started_searching.md b/docs/getting_started_searching.md deleted file mode 100644 index a7c09678..00000000 --- a/docs/getting_started_searching.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: powerful searching ---- - -# powerful searching - -## the dropdown controls - -Let's look at the tag autocomplete dropdown again: - -![](images/ac_dropdown.png) - -* **favourite searches star** - - Once you get experience with the client, have a play with this. Rather than leaving common search pages open, save them in here and load them up as needed. You will keep your client lightweight and save time. - -* **include current/pending tags** - - Turn these on and off to control whether tag _search predicates_ apply to tags the exist, or limit just to those pending to be uploaded to a tag repository. Just searching 'pending' tags is useful if you want to scan what you have pending to go up to the PTR--just turn off 'current' tags and search `system:num tags > 0`. - -* **searching immediately** - - This controls whether a change to the search tags will instantly run the new search and get new results. Turning this off is helpful if you want to add, remove, or replace several heavy search terms in a row without getting UI lag. - -* **OR** - - You only see this if you have 'advanced mode' on. It lets you enter some pretty complicated tags! - -* **file/tag domains** - - By default, you will search in 'my files' and 'all known tags' domain. This is the intersection of your local media files (on your hard disk) and the union of all known tag searches. If you search for `character:samus aran`, then you will get file results from your 'my files' domain that have `character:samus aran` in any tag service. For most purposes, this search domain is fine, but as you use the client more, you may want to access different search domains. - - For instance, if you change the file domain to 'trash', then you will instead get files that are in your trash. Setting the tag domain to 'my tags' will ignore other tag services (e.g. the PTR) for all tag search predicates, so a `system:num_tags` or a `character:samus aran` will only look 'my tags'. - - Turning on 'advanced mode' gives access to more search domains. Some of them are subtly complicated and only useful for clever jobs--most of the time, you still want 'my files' and 'all known tags'. - - -## searching with wildcards { id="wildcards" } - -The autocomplete tag dropdown supports wildcard searching with `*`. - -![](images/wildcard_gelion.png) - -The `*` will match any number of characters. Every normal autocomplete search has a secret `*` on the end that you don't see, which is how full words get matched from you only typing in a few letters. - -This is useful when you can only remember part of a word, or can't spell part of it. You can put `*` characters anywhere, but you should experiment to get used to the exact way these searches work. Some results can be surprising! - -![](images/wildcard_vage.png) - -You can select the special predicate inserted at the top of your autocomplete results (the highlighted `*gelion` and `*va*ge*` above). **It will return all files that match that wildcard,** i.e. every file for every other tag in the dropdown list. - -This is particularly useful if you have a number of files with commonly structured over-informationed tags, like this: - -![](images/wildcard_cool_pic.png) - -In this case, selecting the `title:cool pic*` predicate will return all three images in the same search, where you can conveniently give them some more-easily searched tags like `series:cool pic` and `page:1`, `page:2`, `page:3`. - -## OR searching - -Searches find files that match every search 'predicate' in the list (it is an **AND** search), which makes it difficult to search for files that include one **OR** another tag. More recently, simple OR search support was added. All you have to do is hold down Shift when you enter/double-click a tag in the autocomplete entry area. Instead of sending the tag up to the active search list up top, it will instead start an under-construction 'OR chain' in the tag results below: - -![](images/or_under_construction.png) - -You can keep searching for and entering new tags. Holding down Shift on new tags will extend the OR chain, and entering them as normal will 'cap' the chain and send it to the complete and active search predicates above. - -![](images/or_done.png) - -Any file that has one or more of those OR sub-tags will match. - -If you enter an OR tag incorrectly, you can either cancel or 'rewind' the under-construction search predicate with these new buttons that will appear: - -![](images/or_buttons.png) - -You can also cancel an under-construction OR by hitting Esc on an empty input. You can add any sort of search term to an OR search predicate, including system predicates. Some unusual sub-predicates (typically a `-tag`, or a very broad system predicate) can run very slowly, but they will run much faster if you include non-OR search predicates in the search: - -![](images/or_mixed.png) - -This search will return all files that have the tag `fanfic` and one or more of `medium:text`, a positive value for the like/dislike rating 'read later', or PDF mime. - -## sorting with system limit - -If you add system:limit to a search, the client will consider what that page's file sort currently is. If it is simple enough--something like file size or import time--then it will sort your results before they come back and clip the limit according to that sort, getting the n 'largest file size' or 'newest imports' and so on. This can be a great way to set up a lightweight filtering page for 'the 256 biggest videos in my inbox'. - -If you change the sort, hydrus will not refresh the search, it'll just re-sort the n files you have. Hit F5 to refresh the search with a new sort. - -Not all sorts are supported. Anything complicated like tag sort will result in a random sample instead. diff --git a/docs/getting_started_tags.md b/docs/getting_started_tags.md index 97f1d811..81906c5e 100644 --- a/docs/getting_started_tags.md +++ b/docs/getting_started_tags.md @@ -4,8 +4,6 @@ title: tags # getting started with tags -If any of this is confusing, a simpler guide is [here](https://github.com/Zweibach/text/blob/master/Hydrus/Hydrus%20Help%20Docs/00_tableOfContents.md), and some video guides are [here](https://github.com/CuddleBear92/Hydrus-guides)! - ## how do we find files? { id="intro" } So, you have stored some media in your database. Everything is hashed and cached. You can search by inbox and resolution and size and so on, but if you really want to find what we are looking for, you will have to use _tags_.