Skip to content

Commit 60ca930

Browse files
Ian Spiveycyberdelia
authored andcommitted
Improves documentation to recommend ManifestFilesMixin
* Adds ManifestFilesMixin as alternative to CachedFilesMixin and links to Django documentation.
1 parent d0c073f commit 60ca930

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

docs/storages.rst

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -76,20 +76,26 @@ Using with other storages
7676

7777
You can also use your own custom storage, for example, if you want to use S3 for your assets : ::
7878

79-
STATICFILES_STORAGE = 'your.app.S3PipelineStorage'
79+
STATICFILES_STORAGE = 'your.app.S3PipelineManifestStorage'
8080

81-
Your storage only need to inherit from ``PipelineMixin`` and/or ``CachedFilesMixin`` : ::
81+
Your storage only needs to inherit from ``PipelineMixin`` and ``ManifestFilesMixin`` or ``CachedFilesMixin``.
8282

83-
from django.contrib.staticfiles.storage import CachedFilesMixin
83+
In Django 1.7+ you should use `ManifestFilesMixin <https://docs.djangoproject.com/en/1.7/ref/contrib/staticfiles/#manifeststaticfilesstorage>`_
84+
unless you don't have access to the local filesystem in which case you should use ``CachedFilesMixin``. ::
85+
86+
from django.contrib.staticfiles.storage import CachedFilesMixin, ManifestFilesMixin
8487

8588
from pipeline.storage import PipelineMixin
8689

8790
from storages.backends.s3boto import S3BotoStorage
8891

92+
class S3PipelineManifestStorage(PipelineMixin, ManifestFilesMixin, S3BotoStorage):
93+
pass
8994

90-
class S3PipelineStorage(PipelineMixin, CachedFilesMixin, S3BotoStorage):
95+
class S3PipelineCachedStorage(PipelineMixin, CachedFilesMixin, S3BotoStorage):
9196
pass
9297

98+
9399
Using Pipeline with Bower
94100
=========================
95101

0 commit comments

Comments
 (0)