What I do is to make a reversible change to one of the .rst documents. This makes the project seem to be dirty. The CSS comes along for the ride when Sphinx Build constructs new output. To my mind this is a definite bug in the Sphinx Build utility.
On Mon, Feb 4, 2019 at 8:27 AM KDMortimer <[email protected]> wrote: > Hi there, > > I am using Sphinx 1.8.2 within a Canopy environment (running Python 3.5.2) > and the readthedocs theme. I am trying to add custom styling using CSS to > my HTML output using a file custom.css inside a _static folder and the make > html command. I am able to get custom styles, but when I make changes to > the CSS, they do not get propagated through to the output _build folder. > (Seemingly related to known Sphinx issue 2090 > <https://github.com/sphinx-doc/sphinx/issues/2090>). > > In my attempt to fix this problem, I have tried multiple variations on > importing CSS which I found through various sources (e.g., > StackExchange)... I have added the following to my conf.py, which combines > two methods of importing CSS: > > html_static_path = ['_static'] > html_context = { > 'css_files': ['custom.css'], > } > def setup(app): > app.add_stylesheet('custom.css') > > I have also added two _templates files, page.html: > > {% extends "!page.html" %} > {% set css_files = css_files + ["_static/custom.css"] %} > > as well as layout.html: > > {# layout.html #} > {# Import the theme's layout. #} > {% extends "!layout.html" %} > {% set css_files = css_files + ['_static/style.css'] %} > > However, custom.css only seems to be updated to the output folder when I > make changes to conf.py (or presumably the .rst file - I'm not editing my > rst at this time, so I am unsure about this) - as tested by making large > obvious colour changes to certain elements and comparing custom.css files. > > Obviously a workaround is to update the output CSS manually, but it would > be nice to understand why this is not working. > > -- > You received this message because you are subscribed to the Google Groups > "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at https://groups.google.com/group/sphinx-users. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
