Switch the manual theme to Furo #104735

Merged
Aaron Carlisle merged 30 commits from furo-theme into blender-v4.1-release 2024-03-20 21:38:49 +01:00

30 Commits

Author SHA1 Message Date
Aaron Carlisle c42be80e8d Remove google analytics 2024-03-20 16:25:17 -04:00
Aaron Carlisle 4060c755b3 Cleanup: Whitespace 2024-03-20 16:25:17 -04:00
Aaron Carlisle 2c0d479260 Cleanup: Remove unused CSS 2024-03-20 16:25:17 -04:00
Aaron Carlisle a844c51e95 Hide contribute links when printing to PDF 2024-03-20 16:25:17 -04:00
Aaron Carlisle 4920d607f6 Version Switch: Fixes for dark mode 2024-03-20 16:25:17 -04:00
Aaron Carlisle 94d5471702 Increase the font sizes of various text 2024-03-20 16:25:17 -04:00
Aaron Carlisle 7c0c75b64d Small fixes to toc trees 2024-03-20 16:25:17 -04:00
Aaron Carlisle 2545188c5c Add animation to sidebar arrow 2024-03-20 16:25:17 -04:00
Aaron Carlisle 22310baf69 Add rubrics to heading customizations 2024-03-20 16:25:16 -04:00
Aaron Carlisle 91ec48cfb0 Adjust external links dynamically 2024-03-20 16:25:16 -04:00
Aaron Carlisle 8f2f7f8548 Use Blender Blue as the brand color 2024-03-20 16:25:16 -04:00
Aaron Carlisle b80a843c5c Make text smaller for captions 2024-03-20 16:25:16 -04:00
Aaron Carlisle bfe6f7aeea Improve HR and toctrees 2024-03-20 16:25:16 -04:00
Aaron Carlisle 070acc741e Fix Field Lists with short terms 2024-03-20 16:25:16 -04:00
Aaron Carlisle c28a14da7c Fix: Building without furo 2024-03-20 16:25:16 -04:00
Aaron Carlisle 1c3cdb4299 Directly edit when using the pencil icon 2024-03-20 16:25:16 -04:00
Aaron Carlisle ffca813bde Tweaks to kbd, menu selection
- Vertical-align baseline
- Keep styling in definition terms
2024-03-20 16:25:16 -04:00
Aaron Carlisle 06b5fbd9f9 Small tweaks to kbd and menuselection 2024-03-20 16:25:16 -04:00
Aaron Carlisle 8ed55169d1 Dont decrease font size of kbd and menuselection 2024-03-20 16:25:16 -04:00
Aaron Carlisle 606377240f Style menuselection the same as kbd 2024-03-20 16:25:16 -04:00
Aaron Carlisle d4ff0a6da5 Adjust heading font size to our liking 2024-03-20 16:25:16 -04:00
Aaron Carlisle 4e2271deff Adjust kbd styles to our liking
- Style the parent kbd element and not the individual children
2024-03-20 16:25:16 -04:00
Aaron Carlisle 3cd1430049 Improve contrast of reference admonitions 2024-03-20 16:25:16 -04:00
Aaron Carlisle 3887d89320 Force admonition to span the full width if close to a figure 2024-03-20 16:25:16 -04:00
Aaron Carlisle 41348ae55e FIgures: Improve captions
- Make text use the secondary font color
- Decrease whitespace above caption
- Increase whitespace below caption
2024-03-20 16:25:16 -04:00
Aaron Carlisle 7aba81269b Cleanup: better organize theme css overrides
- Place "fixes" near top of file
- Place our custom stuff near the bottom
2024-03-20 16:25:16 -04:00
Aaron Carlisle 6bfeb4c029 Cleanup: Remove css fixes from old theme 2024-03-20 16:25:16 -04:00
Aaron Carlisle a2cc5f6f03 Let the theme choose the 'pygments_style' 2024-03-20 16:25:16 -04:00
Aaron Carlisle 8f5801c08b Remove jquery extension 2024-03-20 16:25:16 -04:00
Aaron Carlisle be893ef08c Switch the manual theme to Furo
Since moving from the Wiki we have used the `sphinx_rtd_theme` which has worked well but has become a little dated and has had slow development. This changes to use "Furo" instead.

Furo is a lightweight theme that is responsive and has native dark mode support.

Dark mode is one of the major enhancements but this change also brings:

- Content is slightly larger making text and images easier to view
- Site navigation and page navigation is split into two navigation trees. The site navigation is on the left and page on the right if the page has multiple headings.
- Return to top button
- Content is centered on the screen which helps with wide monitors
- No more breadcrumbs

So far the caveat that I have noticed with this is slower compile times and larger pages, this is due to the better sidebar navigation.

This change also brings a lot of simplifications to customizations that we made to the `sphinx_rtd_theme`. There is still likely room for improvement in the future.
2024-03-20 16:25:16 -04:00