Use with CDN

[QuLogic]

We (at obspy/obspy) are hosting our documentation online and would like to switch to the bootstrap theme. There are two important optimizations lacking though. First is loading CSS and JS from a CDN. Second is deferring JS loading to the end of the document.

My first attempt at achieving this was to extend layout.html, and overwrite css_files and scripts_files with CDN links instead. Unfortunately, this does not work because jinja2 executes statements outside blocks in reverse. So it seems the only way to get this to happen is to have the bootstrap theme support it natively.

[ryan-roemer]

@QuLogic -- We have to minorly patch Bootstrap to use our "no conflict" jQuery since out-of-the box Sphinx won't work with BS 2 or BS3. So, I'm not sure how feasible this is without a "more impactful" change of also overriding jQuery site-wide... /cc @russell

[QuLogic]

out-of-the box Sphinx won't work with BS 2 or BS3

I assume this is something that #92 would fix?

[ryan-roemer]

@QuLogic Unfortunately, no -- we have to patch Bootstrap source itself. See, e.g., this line: https://github.com/ryan-roemer/sphinx-bootstrap-theme/blob/master/sphinx_bootstrap_theme/bootstrap/static/bootstrap-3.1.0/js/bootstrap.js#L56 -- we have to do that everywhere to ensure the theme plays well with older Sphinx's that need old jQuery.

So, I'm going to close this issue as "currently impossible" unless a new approach or tactic comes up...