-
Notifications
You must be signed in to change notification settings - Fork 339
MAINT: split bootstrap and theme styling #994
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
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks like a great start to me - I agree it will be easier to reason with the CSS and JS if we separate the two cleanly. One comment and two quick answers to your questions:
do we need all the bootstrap variables in the pydata-sphinx-theme.scss ?
Almost certainly not, but I don't think we need to block this PR on that decision as it might be complex to figure out. I'm fine w/ doing that in a follow-up.
why is the bootstrap.css no available in the readthedoc build when it works just fine on my local build ?
I wonder if it's because we aren't packaging the bootstrap JS and CSS with the theme? I believe we do some configuration of static assets with sphinx-theme-builder
here:
pydata-sphinx-theme/pyproject.toml
Lines 8 to 11 in d99811d
additional-compiled-static-assets = [ | |
"webpack-macros.html", | |
"vendor/", | |
] |
So maybe that needs to be modified to tell it to include the bootstrap JS/CSS as well? (I think it automatically picks up the pydata-sphinx-theme.css
file because of the configuration in theme.conf
.
One way to test this locally is to make sure you're not installing the theme in editable
mode - make sure you're installing the package in the same way any other person would install from pypi
...sometimes that helps clarify issues due to packaging mistakes
nice catch I needed to add the bootstrap .js and .css |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This generally looks pretty good to me! The demo on RTD looks to be styled correctly too. A few minor comments in there. @12rambau anything else you are looking to do here?
@choldgraf, nope it's waiting to be merged |
I think once the merge conflict is fixed we are good to go 👍 |
woot - many thanks @12rambau :-) |
`bootstrap.js` and `bootstrap.css` are necessary to the latest document site. They are copied (moved) into result files of `make update-document` by adding them into files.am. The reason why we need to add `bootstrap.js` and `bootstrap.css` is because `pydata-sphinx-theme` split bootstrap and theme styling. pydata/pydata-sphinx-theme#994
Fix #142
I actually need help on this one.
What I did:
My problem:
If anyone is ready to give me a hand that would be much appreciated