Allowing global selectors

[pixelastic]

The selectors we can currently specify are only scoped selectord. It means that, for any given lvlX element, in order to get its lvl{X-1} and lvl{X-2} parents, we have to check the DOM tree.

It works well for correctly crafted HTML, but fails as soon as the hierarchy is not in the HTML DOM order. This happens often when the hierarchy is in a sidebar, while the content is in the main part of the page. With our current scoped selectors, we cannot build such a hierarchy.

We need to allow global selectors, that instead of looking up the DOM tree will simply try to select an element in the page, wherever it is placed.

A possible API would be to allow passing objects to each selectors instead of strings.

{
  "selectors": {
    "lvl0": {
        "selector": "#accordion a.category-title:not(.collapsed)",
        "global": true
    },
    "lvl1": ".content h2",
    "lvl2": ".content h3",
    "lvl3": ".content h4",
    "lvl4": ".content h5",
    "text": ".content p"
  }

We keep retrocompatibility by converting simple strings to objects with a global: false and a selector key.

Checklist

• Should still allow string based syntax
• ...as well as an object with global: false as the default
• if global: true, will use the result of the first match of the selector

[maxiloc]

Fixed with #39