Switch to Furo theme

[simonw]

Suggested by Adam Johnson - Furo looks neat. I like that it doesn't use any web fonts so should load faster.

In my local dev environment (make livehtml so this includes the live reload stuff) Furo uses 257KB for a full reload compared to 842KB for sphinx_rtd_theme.

[simonw]

OK, deployed that for latest - https://shot-scraper.datasette.io/en/latest/ now shows 218.16KB transferred in the network pane, compared to 627.84KB for https://shot-scraper.datasette.io/en/stable/

[simonw]

Comparison:

shot-scraper https://shot-scraper.datasette.io/en/stable/ --retina --height 1200

shot-scraper https://shot-scraper.datasette.io/en/latest/ --retina --height 1200

[simonw]

Just spotted this note in the Furo docs: https://pradyunsg.me/furo/customisation/sidebar/#using-html-sidebars

If you’re hosting your documentation on Read the Docs, please make sure that sidebar/ethical-ads.html is included in the sidebar. This helps keep Read the Docs sustainable.

[simonw]

I think I'm OK there - I don't set a custom html_sidebars in my conf.py and it looks like it includes those on Read The Docs by default - I found this in the generated HTML in production:

<div
  id="furo-sidebar-ad-placement"
  class="flat"
  data-ea-publisher="readthedocs"
  data-ea-type="readthedocs-sidebar"
  data-ea-manual="true"
></div>
</div>