Support bootswatch while offline (no CDN)

[zyga]

This ticket is meant to start a dicussion on how to support bootswatch while offline. My goal is to get fully offline bootswatch theme so that those could be used in Debian/Ubuntu for certain documentation builds.

For Debian packages, depending on the CDN would be inappropriate.

There are a few factors to consider:

1. How to track upstream bootswatch code:

• Do we copy each release?
• Do we use submodule and track the version to bundle?

2. How do we release sphinx-bootstrap-theme?

3. How to select offline vs CND.

My suggestions are to:

1. Use a git submodule
2. Craft appropriate MANIFEST.in and setup.py settings to release both normal and minified css and javascript
3. Use a new theme: "cdn" defaulting to False

[ryan-roemer]

Actually, if we want to go this route, it's probably easier to just remove CDN option and host all of the static Bootswatch files directly. This is what is done with Bootstrap directly, and it hasn't been too bad so far (plus, I have to manually patch the .js files to use a special them noConflict version of jQuery). And, we can conveniently avoid that "include vanilla and bootswatch CSS files" issue in the current approach.

As for maintaining versions, we can probably script an upgrade to all the relevant Bootswatch (*.css, *.min.css) files in the Fabric files to make for easy upgrades.

My main goal with this thinking is Python packaging is way simpler with this, and it hasn't been bad for Bootstrap / jQuery so far this way.

[zyga]

I think both CDN and offline have their uses, for things like readthedocs it would make sense to use the CDN variant, in the system ${library}-doc packages I would probably not use the CDN variant to make everything function offline (after all, that's the whole point of having a -doc packages)

[pcav]

I think adding an option to copy everything locally would be a good step forward, and should not be complicated.
Am I wrong?

[pcav]

Any advance on this?

[zyga]

I don't have time to work on this ATM, sorry.

[ryan-roemer]

Implemented.

[ryan-roemer]

Published to PyPi as https://pypi.python.org/pypi/sphinx-bootstrap-theme/0.3.3