diff --git a/docs/storages.rst b/docs/storages.rst index c17d41a3..f461453e 100644 --- a/docs/storages.rst +++ b/docs/storages.rst @@ -26,6 +26,23 @@ Also available if you want versioning :: STATICFILES_STORAGE = 'pipeline.storage.NonPackagingPipelineCachedStorage' +Optimized storage with cache invalidation +----------------------------------------- + +There is also an optimized storage which compress only the packages with +modifications. This speeds up the collectstatic process substantially when you +have multiple packages in your pipeline configuration. + +In addition, this storage produces a hash from the compressed files which is +appended to the resources' URL. Thus, whenever you modify your files and +compress them, the cache registries (from cache server ou browser) will be +automatically invalidated :: + + STATICFILES_STORAGE = 'pipeline.storage.OptimizedPipelineStorage' + +File finders (staticfiles with DEBUG = False) +============================================= + If you use staticfiles with ``DEBUG = False`` (i.e. for integration tests with `Selenium `_) you should install the finder that allows staticfiles to locate your outputted assets : :: diff --git a/docs/usage.rst b/docs/usage.rst index f453a93b..b8ccec89 100644 --- a/docs/usage.rst +++ b/docs/usage.rst @@ -9,7 +9,7 @@ Describes how to use Pipeline when it is installed and configured. Templatetags ============ -Pipeline includes two template tags: ``stylesheet`` and ``javascript``, +Pipeline includes two main template tags: ``stylesheet`` and ``javascript``, in a template library called ``pipeline``. They are used to output the ```` and ``