furo docs theme

[adamgayoso]

New features

• Dark mode
• Better CSS formatting for tutorials
• Cleaner feel to docs
• Fixes Add doc extension for link preview #1155

View built docs on this branch here (best to do in private window due to browser caching)

Everything generally looks good in both light and dark mode. We can force white backgrounds on images in the first cell of tutorials to make those look good in dark mode. We can also refactor the notebook gallery images in a future release.

[codecov]

Codecov Report

Merging #1290 (7505b12) into master (d117b1c) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #1290   +/-   ##
=======================================
  Coverage   90.81%   90.81%           
=======================================
  Files         109      109           
  Lines        8263     8263           
=======================================
  Hits         7504     7504           
  Misses        759      759           

Impacted Files	Coverage Δ
scvi/model/_autozi.py	98.83% <ø> (ø)
scvi/model/_destvi.py	88.28% <ø> (ø)
scvi/model/_peakvi.py	88.88% <ø> (ø)
scvi/model/_scanvi.py	93.27% <ø> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d117b1c...7505b12. Read the comment docs.

[galenxing]

Looks cool! Would be nice if the api methods were all one liners in the left side bar (e.g. make the text smaller or make the sidebar larger).

[adamgayoso]

Looks cool! Would be nice if the api methods were all one liners in the left side bar (e.g. make the text smaller or make the sidebar larger).

This should be fixed now

[watiss]

I think I like our current one a little better, but this is also nice.

Couple of notes:

• Some tutorial features seem broken in dark mode, such as this umap:

• Should we have a side menu drop-down for User guides like we do for Tutorials?

[adamgayoso]

Should we have a side menu drop-down for User guides like we do for Tutorials?

I removed this because it's going to be too long eventually -- scikit-learn and pytorch do not make use of long content sidebars

@watiss The images will be rerun when we rerun all the tutorials and white background on images will be forced.

[justjhong]

Dark mode boxes could be slightly lighter here

Also these boxes can just match the ones on the homepage if possible (or change from images to badges to make it even simpler

Otherwise I'm a big fan of this new theme!