question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Consider switching sphinx theme

See original GitHub issue

I see that https://github.com/marshmallow-code/webargs/pull/607 is failing with an error because sphinx-typlog-theme is somehow mismatching with sphinx==4.0.2. I haven’t looked carefully into what that error about metatags means, but I’m betting it was dropped in sphinx v4 and sphinx is now catching this usage.

Given that the theme hasn’t been updated in a couple of years, I wonder if we should consider switching the theme for webargs?

We could go with alabaster, which is what marshmallow uses, or the new hotness of furo. I’ve been looking at furo for some things at work, and I like generally how it looks and feels.

@sloria, @lafrech, what do you guys think? Try out furo, switch to alabaster, or should we look at contributing a fix to the typlog theme?

Issue Analytics

  • State:closed
  • Created 2 years ago
  • Comments:5 (2 by maintainers)

github_iconTop GitHub Comments

1reaction
sirosencommented, Jun 2, 2021

Well, this is slightly embarrassing for me! Furo doesn’t support sphinx v4 yet.

~I’ll open an issue there to see if it’s easy to handle, but I won’t do a branch of webargs for it yet.~ EDIT: Turns out, there’s active effort on this but in a discussion, so I didn’t find it in an issue search. I’ll just wait a little.

0reactions
sirosencommented, Jul 1, 2021

closed by #615

Read more comments on GitHub >

github_iconTop Results From Across the Web

HTML Theming - Sphinx documentation
Sphinx supports changing the appearance of its HTML output via themes. A theme is a collection of HTML templates, stylesheet(s) and other static...
Read more >
Configuration — PyData Sphinx Theme ... - Read the Docs
This configuration value tells the switcher what docs version is currently being viewed, and is used to style the switcher (i.e., to highlight...
Read more >
Customize sphinxdoc theme - python - Stack Overflow
In order to customize the existing sphinxdoc theme, you need to create a custom template and stylesheet that contains the desired modifications.
Read more >
Common Ways to Customize Sphinx Themes - Jared Dillard
1. Custom Javascript and CSS · 2. Custom theme. · 3. Changing the code highlighting styles · 4. Using html_context Variables · 5....
Read more >
How to Document using Sphinx: Part 2—Building ... - YouTube
This video shows you how to work with the index file or the home page as well as how to change themes.Find the...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found