crate / crate-docs-theme

A Sphinx theme for the CrateDB documentation.
https://crate-docs-theme.readthedocs.io/
Apache License 2.0
19 stars 5 forks source link

Using `sphinxext-photofinish` for creating responsive images #446

Open amotl opened 1 year ago

amotl commented 1 year ago

Hi.

At https://github.com/crate/cloud-docs/pull/34, we discussed image sizes. Maybe we want to support both large and small screens at the same time optimally, not needing to rely on fast pipes everywhere, i.e. saving bandwidth.

On this matter, we may want to make use of sphinxext-photofinish:

Photofinish is a sphinx extension for creating responsive images to your Sphinx site. This has several benefits:

  • Lower bandwidth cost for browsers and devices that don't need the higher resolution version
  • Higher resolution images for higher resolution devices

Photofinish can dramatically increase the loading time of your Sphinx website.

With kind regards, Andreas.

/cc @matkuliak, @msbt

msbt commented 1 year ago

sounds good, but I hope it decreases the loading time instead of increasing it scnr ;)