Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Using different theme for survey results #2102

Open
goatlady opened this issue Feb 28, 2024 · 6 comments
Open

Using different theme for survey results #2102

goatlady opened this issue Feb 28, 2024 · 6 comments

Comments

@goatlady
Copy link
Collaborator

Would it be possible to apply a separate Sphinx theme such as Furo just to the salary survey results? Essentially making the results page a sub-site that breaks out of the regular site theme with it's own navigation?

This would enable:

  • wider content area (800px on largest screens, vs 660px)
  • sans-serif font with regular modern numerals instead of old-style, much better for tabular data
  • fixed navigation bar to allow readers to jump back and forward through sections without having to scroll back to the top - I think it would even be good for usability to break the results up into separate pages (especially if it's possible to mix internal anchor nav with separate page nav in the sidebar)

I can tweak the CSS also to better fit WTD branding, but I don't think a lot would be required because it's pretty plain.

@plaindocs
Copy link
Contributor

It turns out you can't use multiple themes within the same doc set.

Because the survey is relatively static, we could look at publishing it separately and copying it over, but it's not super convenient.

Tagging in @ericholscher and @mxsasha in case they have better ideas.

@plaindocs plaindocs removed their assignment Feb 28, 2024
@plaindocs
Copy link
Contributor

We could just host it at survey.writethedocs.org or something entirely separately as a separate docs set?

@ericholscher
Copy link
Member

Yea, I'd put it on another RTD project probably. There's a couple options we have, but feels like a decent bit of overhead for some smallish style tweaks. We could look at making changes to the main WTD site, which could also use a refresh at some point 🤷

@goatlady
Copy link
Collaborator Author

The things I'm looking to do are usability improvements rather than style tweaks - but I'm looking now at how the conference sub-sites work with custom templates, that might be more easily achievable.

@mxsasha
Copy link
Contributor

mxsasha commented Feb 29, 2024

Hmm, my first thought is also to run it as a separate site, because it sounds like the lowest complexity solution. The conference setup has its own templates indeed, but that's also quite fragile from time to time.

(once I figured out how the conference templates work, I realized it was a lot less complicated than I initially thought)

@goatlady
Copy link
Collaborator Author

goatlady commented Mar 1, 2024

I've got a very basic custom template working locally and it seems fine so far - the results report is much less complex than the conference sites, so maybe the fragility is less of an issue? I'll make a PR with my branch and you folks can take a look.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants