Add note to docs for preload #1033
Conversation
Pull upstream develop branch
| .. note:: | ||
|
|
||
| This operation only generates the preload HTML link element with the correct filename hash. | ||
| You must subsequently load the file within a ``compress`` block to use the associated resource. |
There was a problem hiding this comment.
Perhaps "load the file via a compress block with identical contents" (not sure if that's correct, but in any case some info about how the block should look like would be nice)
There was a problem hiding this comment.
Good point. And I am realizing that we should probably also clarify that it needs the same block name.
There was a problem hiding this comment.
Hi, what do you mean by "same block name"?
There was a problem hiding this comment.
django-compressor supports setting a block name that will be prepended to the file name for a compressed resource. The block name used must be the same between the preload block and the subsequent file block for the file names to match.
There was a problem hiding this comment.
Ok, I'll try that since I still have the error with offline compression at runtime:
compressor.exceptions.OfflineGenerationError: You have offline compression enabled but key "d194e833cc7675b07be5a9dee9eea326d443e6f691265734b1b3abeb2b7982be" is missing from offline manifest. You may need to run "python manage.py compress". Here is the original content
We have identical couples of compress tags (preload + non-preload) in several templates, maybe that's the issue.
There was a problem hiding this comment.
That's what I thought and why I tried your PR. Maybe It is a corner case with inheritance and block tag inside compress tags.
I just jumped in the project for a technical migration and found the offline compression appealing.
Anyway, I'll stick to the online compression for now, many thanks for your time.
A small step in addressing #1032 . (I'd just cherry-pick 1b1ee8d.)