Advanced searching documentation (as of 2.0.65) - aaFn/Bookmark-search-plus-2 GitHub Wiki

BSP2 2.0.65 introduces new power search capabilities, as per #90 and #28.

From that version, the magnifier glass in the search box becomes an active button. Its filling, image and color changes depending on the selected search combination. Clicking on the button allows to select the:

• Search field: both, title only or URL only.
  • When "both", it is sufficient that title or URL matches to be selected.
• Search scope: all or inside current folder.
  • When "inside current folder", this is referring to the currently highlighted item in the bookmark tree:
    • if the selected bookmark item is a folder, the search occurs only inside the folder (the folder item itself and its sibblings are not part of it).
    • If it is a bookmark item or separator, the search starts from the containing folder, so including the selected item sibblings (but again, not the parent folder item itself).
    • If nothing is selected, the search starts from Root of the tree (not visible), which is different from the full list of items (see note below).
  • When "all", the search is applied on the full list of items.
    • Note that this can have a different result from starting from the Root, as it was observed that some bookmarks or folders can be attached to nowhere when the FF bookmark DB has some corruption, and in such cases only "all" can find them.
• Search match method: words or use regex.
  • With "words" (= default FF method), all specified words, separated by blanks, must match, in any order. So order of words does not have any significance.
  • With "use regex", Regular Expressions are used to find matches.
    • It is not the purpose here to give a course on using Regex ... see the link above or this one in MDN
    • Warning: the implementation comes for JavaScript included inside FF, and it appears that not all is working. For example, the look behind feature (?<...) doesn't appear to work. However, the look ahead (?...) does work.
    • An illustration: to find all bookmarks & folders having the word "inter" but not followed by "net" (i.e. all inter... except "internet"), use the regex: inter(?!net)
  • Note: do not forget to set the field to "title only" if you do not want matches on the URL!

IMPORTANT NOTE: all matches are:

• case insensitive
• diacritic insensitive ... meaning that é = è = ê = ë = .. = e