rtfd/readthedocs.org — Issue #133: force rebuild of docs
Author: faassen
Created: 2011-11-03 16:14:54+00:00
State: open

My project (Obviel) involves JavaScript code, and I wanted to include some demos in the documentation. I had managed to manage conf.py so that it would include the proper JavaScript in _static, and it works locally, but when I build it using readthedocs, the stuff doesn't appear in _static at all.

While I'm not sure, I suspect this may be due to sphinx-build doing an incremental build, only building changed files compared to the last versions. This is fine for restructured text content, but doesn't get triggered for anything in _static. Could some option be included to run sphinx-build with -a, which I believe will regenerate things completely?

(I tried to work around the problem by uploading a zip file with the HTML instead. I uploaded a zip file with a 'html' subdirectory, but it wouldn't take, including the 'html' subdirectory on the server as well. after that I tried to correct matters by building a zip file without this html directory, but that didn't work either for some reason. And then I tried to rebuild again, wiping out the upload, but that didn't work either - this version (0.9.1) seems trapped with a broken HTML upload version now that I cannot remove. I'll create separate issues for this stuff).