django-staticfiles

Django-staticfiles είναι μια εφαρμογή που παρέχει Django βοηθοί για την εξυπηρέτηση στατικά αρχεία.
Η κύρια ιστοσελίδα για Django-staticfiles είναι bitbucket.org/jezdez/django-staticfiles όπου μπορείτε επίσης να καταθέσει τα εισιτήρια.
Μπορείτε επίσης να εγκαταστήσετε την έκδοση του Django-staticfiles σε ανάπτυξη με pip εγκατάσταση Django-staticfiles == dev ή easy_install Django-staticfiles == dev.
Εντολές Διαχείρισης
build_static
Συλλέγει τα αρχεία πολυμέσων από όλες τις εγκατεστημένες εφαρμογές και τα αντίγραφα τους στο STATICFILES_STORAGE.
Μπορείτε να περιορίσετε τις εφαρμογές αναλυθεί παρέχοντας μια λίστα με ονόματα app:
πύθωνα manage.py build_static --exclude-dirs διαχειριστή δημοσκοπήσεις
Τα ονόματα αρχείων Διπλότυπο λυθεί κατ 'ανάλογο τρόπο με το πώς λειτουργεί το πρότυπο ψήφισμα. Τα αρχεία που αρχικά αναζητήσατε στην STATICFILES_DIRS θέσεις, ακολουθούμενο από τις εφαρμογές με τη σειρά που καθορίζεται από τη ρύθμιση INSTALLED_APPS.
Μερικοί χρησιμοποιούνται συνήθως επιλογές είναι:
--noinput
& Nbsp? ΜΗΝ ζητήσει από το χρήστη για την είσοδο οποιουδήποτε είδους.
-i μοτίβο ή --ignore = ΜΟΤΊΒΟ
& Nbsp? Αγνοήστε τα αρχεία ή τους καταλόγους που ταιριάζουν αυτό το μοτίβο glob-στυλ. Χρησιμοποίησε πολλές φορές για να αγνοήσει περισσότερο.
-n ή --dry-run
& Nbsp? Κάνει τα πάντα εκτός τροποποιήσει το σύστημα αρχείων.
-l ή --link
& Nbsp? Δημιουργήστε ένα συμβολικό σύνδεσμο για κάθε αρχείο, αντί της αντιγραφής.
--exclude-dirs
& Nbsp? Εξαίρεση επιπλέον στατικές θέσεις που καθορίζονται στη ρύθμιση STATICFILES_DIRS.
Για μια πλήρη λίστα των επιλογών, ανατρέξτε στη βοήθεια εντολών διαχείρισης build_static εκτελώντας:
πύθωνα manage.py build_static --help
resolve_static
Επιλύει ένα ή περισσότερα αναμενόμενη πορεία σχετικό URL σε απόλυτες διαδρομές του κάθε αρχείο πολυμέσων στο σύστημα αρχείων. Για παράδειγμα:
Python manage.py resolve_static CSS / base.css admin / JS / core.css
/home/special.polls.com/core/media/css/base.css
/home/polls.com/core/media/css/base.css
/home/polls.com/src/django/contrib/admin/media/js/core.js
Από προεπιλογή, όλες οι τοποθεσίες που ταιριάζουν βρέθηκε. Για να επιστρέψετε μόνο τον πρώτο αγώνα για κάθε σχετική διαδρομή, χρησιμοποιήστε την επιλογή --Πρώτο:
πύθωνα manage.py resolve_static CSS / base.css --Πρώτο
/home/special.polls.com/core/media/css/base.css
static_url επεξεργαστή πλαίσιο
Για να αναφερθείτε σε στατικές περιουσιακά στοιχεία του αρχείου από ένα πρότυπο, βεβαιωθείτε ότι έχετε ρυθμίσει την STATIC_URL ρύθμιση στη διαδρομή URL όπου τα στατικά αρχεία που εξυπηρετούνται.
Στη συνέχεια, προσθέστε το static_url επεξεργαστή πλαίσιο για τη ρύθμιση TEMPLATE_CONTEXT_PROCESSORS σας:
TEMPLATE_CONTEXT_PROCESSORS = (
& Nbsp? "Staticfiles.context_processors.static_url»,
)
Πρότυπα που παρέχονται με RequestContext θα έχουν πλέον πρόσβαση σε μια μεταβλητή περιβάλλοντος STATIC_URL:
Εξυπηρετούν στατικά αρχεία κατά τη διάρκεια της ανάπτυξης
Σημείωση
Μην χρησιμοποιείτε αυτό σε διακομιστές παραγωγής. Αυτή η λειτουργία προορίζεται μόνο για την ανάπτυξη. Παρακαλώ, μην πυροβολήσει τον εαυτό σας στο πόδι. Ευχαριστώ.
Για να εξυπηρετήσει το στατικό περιεχόμενο για τόσο MEDIA_URL και STATIC_URL προσθέστε το ακόλουθο απόσπασμα στο τέλος της πρωτοβάθμιας διαμόρφωση URL σας:
από django.conf ρυθμίσεις εισαγωγής
αν settings.DEBUG:
& Nbsp? Urlpatterns + = μοτίβα ('',
& Nbsp? (R ', περιλαμβάνουν («staticfiles.urls')),
& Nbsp?)
Ρυθμίσεις
STATIC_ROOT
Προεπιλογή: '' (Κενή συμβολοσειρά)
Η απόλυτη διαδρομή προς τον κατάλογο που κρατά στατικά αρχεία πολυμέσων, όπως το app:
STATIC_ROOT = "/home/polls.com/polls/site_media/static/"
Αυτό χρησιμοποιείται μόνο από την προεπιλεγμένη στατική αποθήκευση αρχείων (δηλαδή, αν χρησιμοποιείτε μια διαφορετική STATICFILES_STORAGE, δεν χρειάζεται να ρυθμίσετε αυτό).
STATIC_URL
Προεπιλογή: '' (Κενή συμβολοσειρά)
URL που χειρίζεται τα αρχεία που εξυπηρετούνται από STATIC_ROOT, π.χ.
STATIC_URL = '/ site_media / στατικές /'
Σημειώστε ότι αυτό θα πρέπει να έχει πάντα μια τελική κάθετο.
STATICFILES_DIRS
Προεπιλογή: []
Αυτή η ρύθμιση καθορίζει τις πρόσθετες θέσεις η staticfiles app θα διασχίσει όταν ψάχνει για αρχεία πολυμέσων, π.χ. εάν χρησιμοποιήσετε την εντολή build_static ή resolve_static διαχείριση ή χρησιμοποιήστε το στατικό αρχείο που εξυπηρετούν την άποψη.
Θα πρέπει να ορίζεται ως μία ακολουθία (πρόθεμα, διαδρομή) πλειάδες, π.χ.
STATICFILES_DIRS = (
& Nbsp? ('', '/home/special.polls.com/polls/media »),
& Nbsp? ('', '/home/polls.com/polls/media »),
& Nbsp? ("Κοινή", το '/ opt / webfiles / κοινή »),
)
STATICFILES_PREPEND_LABEL_APPS
Προεπιλογή: («django.contrib.admin»,)
Μια σειρά από μονοπάτια app που θα πρέπει να έχει ως πρόθεμα με το όνομα ετικέτας. Για παράδειγμα, django.contrib.admin αρχεία πολυμέσων, πρέπει να εξυπηρετείται από το admin / [js, CSS, εικόνες] παρά τα αρχεία πολυμέσων πάρει εξυπηρετούνται άμεσα από τη στατική ρίζα.
STATICFILES_MEDIA_DIRNAMES
Προεπιλογή: («μέσα ενημέρωσης»,)
Μια σειρά από ονόματα καταλόγων που θα χρησιμοποιηθούν κατά την αναζήτηση για αρχεία πολυμέσων σε εγκατεστημένες εφαρμογές, π.χ. αν μια εφαρμογή έχει τα αρχεία πολυμέσων του σε / στατική χρήση:
STATICFILES_MEDIA_DIRNAMES = (
& Nbsp? «Μέσα ενημέρωσης»,
& Nbsp? «Στατική»,
)
STATICFILES_EXCLUDED_APPS
Προεπιλογή: []
Μια σειρά από μονοπάτια app που θα πρέπει να αγνοείται κατά την αναζήτηση για αρχεία πολυμέσων:
STATICFILES_EXCLUDED_APPS = (
& Nbsp? "Annoying.app»,
& Nbsp? "Old.company.app»,
)
STATICFILES_STORAGE
Προεπιλογή: «staticfiles.storage.StaticFileStorage»
Η αποθήκευση να χρησιμοποιήσει για την αντιγραφή στατικά αρχεία σε μια ενιαία θέση

Τι είναι καινούργιο σε αυτή την έκδοση:.

• Προστέθηκε αναλυτή API η οποία αφηρημένο τρόπο οι staticfiles βρίσκει αρχεία.
• Προστέθηκε staticfiles.urls.staticfiles_urlpatterns να αποφευχθεί η catch-all URLPATTERN που μπορούν να κάνουν υψηλού επιπέδου urls.py ελαφρώς μεγαλύτερη σύγχυση. Από Brian Rosner.
• Μικρές αλλαγές τεκμηρίωση
• Ενημέρωση testrunner να συνεργαστεί με Django 1.1.x και 1.2.x.
• Αφαιρέθηκε προσαρμοσμένο κώδικα για να φορτώσει backend αποθήκευσης.

Τι είναι καινούργιο στην έκδοση 0.2.0:

• Μετονομάστηκε build_media και διαχείριση resolve_media εντολές να build_static και resolve_media για να αποφευχθεί η σύγχυση μεταξύ της χρήσης Django του όρου & quot? media & quot? (Για προσθήκες) και & quot? Στατική & quot? αρχεία.
• Rework το μεγαλύτερο μέρος του εσωτερική λογική, υδροληψίες την βασική λειτουργικότητα μακριά από τις εντολές διαχείρισης.

Backend σύστημα αποθήκευσης
• Χρήση αρχείων από προεπιλογή, την ικανότητα να το παρακάμψετε με backend έθιμο αποθήκευσης
• Αφαιρέθηκε --interactive επιλογή για τον εξορθολογισμό στατική επίλυση αρχείο.
• Προστέθηκε εκτεταμένες δοκιμές
• Χρησιμοποιεί την τυπική καταγραφή

Απαιτήσεις :

• Django
• Python