html_style works locally but not on ReadTheDocs

[Suor]

I use readthedocs theme both locally and on ReadTheDocs. However, html_style has no effect when docs are compiled on the service.

By the way, I am just trying to add some custom CSS. Here is my conf.py - https://github.com/Suor/funcy/blob/master/docs/conf.py

[ericholscher]

Here is the code that sets these variables: https://github.com/rtfd/readthedocs.org/blob/master/readthedocs/doc_builder/templates/doc_builder/conf.py.tmpl#L21-L51 -- looks like it might be overriding your custom style. We do this to keep things consistent when using our own theme, but I could probably be convinced to change it for a good reason.

[Suor]

There definitely should be a way to add some css, preferably an easy one and documented. html_style is documented is sphinx docs, it's not easy to use though, cause you need to add @import and you usually don't know what to write there.

Current situation is, however, meaning html_style is useless and there is no easy way to add custom css to your docs. So I suggest one of two variants:

1. Make html_style work as it described in sphinx docs, also document in rtd docs how one should use it. E.g. explicitly state that one should add @import "rtd.css" (or whatever, I am still not sure) on top your css file.
2. Make a separate setting to add css files, and probably js ones, to pages heads. Document it in rtd docs.

(1) is not backward compatible, srictly speaking, but since nobody probably uses setting that doesn't work shouldn't cause much trouble.

[tshead2]

I second the motion ... there are a handful of small CSS tweaks I'd like to make in my docs, and either of the suggestions by @Suor would be very welcome.

[delfick]

I'm running into the same situation here. https://github.com/realestate-com-au/bespin/blob/master/docs/sphinx/conf.py#L17

[gregmuellegger]

We are now displaying the actually used conf.py in the build process. You can have a look and see in which cases we override the html_style configuration. You can override the value properly when setting html_theme = "sphinx_rtd_theme".

[logemann]

doesnt make any difference to me. html_style is still being ignored.

Or better said, when looking at conf.py at build time, you dont override html_style but on the other hand you dont include it in the html source either.

[agjohnson]

There is a pattern for this in our docs now:
http://docs.readthedocs.io/en/latest/guides/adding-custom-css.html

Closing this here as I don't think we'll change this