Shot-scraper

- Improved example workflow in [Optimizing PNGs using Oxipng](https://shot-scraper.datasette.io/en/stable/github-actions.html#optimizing-pngs-using-oxipng).
- Fixed typos in README and documentation. [83](https://github.com/simonw/shot-scraper/pull/83)

- Documentation improvements. [0.14.1...0.14.2](https://github.com/simonw/shot-scraper/compare/0.14.1...0.14.2)

- Switched [documentation site](https://shot-scraper.datasette.io/) over to the [Furo](https://github.com/pradyunsg/furo) theme. [#77](https://github.com/simonw/shot-scraper/issues/77)

- Documentation is now hosted at **[shot-scraper.datasette.io](https://shot-scraper.datasette.io/)** and has been expanded to multiple pages. [#73](https://github.com/simonw/shot-scraper/issues/73)
- `shot-scraper $URL --wait-for EXPRESSION` can be used to take the screenshot only once the provided JavaScript expression returns `true`. See [Waiting until a specific condition](https://shot-scraper.datasette.io/en/stable/screenshots.html#waiting-until-a-specific-condition). [72](https://github.com/simonw/shot-scraper/issues/72)
- The `wait_for:` key in the YAML format used by `shot-scraper multi` provides equivalent functionality for scripted multiple screenshots.
- New documentation on [Using shot-scraper with GitHub Actions](https://shot-scraper.datasette.io/en/stable/github-actions.html). [#74](https://github.com/simonw/shot-scraper/issues/74)
- New example: [Extracting page content with Readability.js](https://shot-scraper.datasette.io/en/stable/javascript.html#example-extracting-page-content-with-readability-js)

- `shot-scraper auth --devtools` option for opening DevTools when authenticating with a site. [66](https://github.com/simonw/shot-scraper/issues/66)
- `shot-scraper multi -n/--no-clobber` option for skipping screenshots where the output image already exists on disk. [70](https://github.com/simonw/shot-scraper/issues/70)

- `--selector-all` option to take a screenshot that encompasses every element matching the specified CSS selector - complements `--selector` which takes a screenshot of just the first element matching that selector. See [Specifying elements using JavaScript filters](https://github.com/simonw/shot-scraper/blob/0.12/README.md#specifying-elements-using-javascript-filters). [64](https://github.com/simonw/shot-scraper/issues/64)
- `selector_all:` and `selectors_all:` keys in the `shot-scraper multi` YAML format.
- `--js-selector` and `--js-selector-all` options for specifying elements to screenshot using a JavaScript expression, for cases which cannot be handled using CSS selectors [43](https://github.com/simonw/shot-scraper/issues/43). The following example takes a screenshot of the first paragraph on the page that mentions `shot-scraper`:

shot-scraper https://github.com/simonw/shot-scraper \
--js-selector 'el.tagName == "P" && el.innerText.includes("shot-scraper")'

- `js_selector:`, `js_selectors:`, `js_selector_all:` and `js_selectors_all:` equivalent keys in the `shot-scraper multi` YAML format.
- `--user-agent` option for setting a custom user agent header. [63](https://github.com/simonw/shot-scraper/issues/63)
- `--browser webkit` option for running [WebKit](https://playwright.dev/docs/browsers#webkit) - thanks, [Ryan Murphy](https://github.com/rdmurphy). [#56](https://github.com/simonw/shot-scraper/pull/56)