django-staticfiles

django-staticfiles est une application Django qui fournit des aides pour servir des fichiers statiques.
Le site Web principal de django-staticfiles est bitbucket.org/jezdez/django-staticfiles où vous pouvez également déposer des billets.
Vous pouvez également installer la version en développement de Django-staticfiles avec pip installer django-staticfiles == dev ou easy_install django-staticfiles == dev.
Commandes de gestion
build_static
Recueille les fichiers multimédias à partir de toutes les applications et les copie installés à l'STATICFILES_STORAGE.
Vous pouvez limiter les applications analysées en fournissant une liste de noms d'applications:
sondages administrateur python manage.py build_static --exclude-dirs
Duplicate File noms sont résolus d'une manière similaire à la façon dont la résolution modèle fonctionne. Les fichiers sont d'abord recherchées dans des endroits STATICFILES_DIRS, suivie par des applications dans l'ordre spécifié par le paramètre INSTALLED_APPS.
Certaines options couramment utilisés sont:
--noinput
& Nbsp; Ne pas demander à l'utilisateur pour l'entrée d'aucune sorte.
-i motif ou --ignore = MOTIF
& Nbsp; Ignorez des fichiers ou répertoires correspondant à ce modèle glob de style. Utilisez plusieurs fois d'ignorer plus.
-n ou --dry-run
& Nbsp; tout faire, sauf modifier le système de fichiers.
-l ou --link
& Nbsp; Créez un lien symbolique à chaque fichier au lieu de copier.
--exclude-dirs
& Nbsp; Exclure emplacements statiques supplémentaires spécifiées dans le cadre STATICFILES_DIRS.
Pour une liste complète des options, reportez-vous à la commande de la gestion build_static aide en exécutant:
python manage.py build_static --help
resolve_static
Résout un ou plusieurs attendu chemin de l'URL par rapport à des chemins absolus de chaque fichier multimédia sur le système de fichiers. Par exemple:
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
Par défaut, tous les emplacements correspondants sont trouvés. Pour ne retournera le premier match pour chaque chemin relatif, utilisez l'option --first:
python manage.py resolve_static css / base.css --first
/home/special.polls.com/core/media/css/base.css
Processeur de contexte static_url
Pour faire référence à des actifs de fichiers statiques à partir d'un modèle, vérifiez que vous avez réglez le paramètre le chemin de l'URL où les fichiers statiques sont servis STATIC_URL.
Ensuite, ajoutez le processeur de contexte static_url à votre paramètre TEMPLATE_CONTEXT_PROCESSORS:
TEMPLATE_CONTEXT_PROCESSORS = (
& Nbsp; »staticfiles.context_processors.static_url ',
)
Modèles rendus avec RequestContext auront désormais accès à une variable de contexte de STATIC_URL:
Servir des fichiers statiques au cours du développement
Note
Ne pas utiliser sur les serveurs de production. Cette fonctionnalité est destinée seulement pour le développement. Se il vous plaît, ne vous tirez pas dans le pied. Merci.
Pour servir les médias statique pour deux MEDIA_URL et STATIC_URL ajouter l'extrait suivant à la fin de la configuration de votre URL principale:
à partir des paramètres django.conf d'importation
si settings.DEBUG:
& Nbsp; urlpatterns + = patterns ('',
& Nbsp; (r '', include ('staticfiles.urls')),
& Nbsp;)
Paramètres
STATIC_ROOT
Par défaut: '' (chaîne vide)
Le chemin absolu du répertoire qui contient les fichiers statiques comme app médias:
STATIC_ROOT = "/home/polls.com/polls/site_media/static/"
Ceci ne est utilisé par le stockage de fichiers statiques par défaut (ce est à dire si vous utilisez un STATICFILES_STORAGE différent, vous ne avez pas besoin de définir cette).
STATIC_URL
Par défaut: '' (chaîne vide)
URL qui gère les fichiers servi de STATIC_ROOT, par exemple:
STATIC_URL = '/ site_media / static /'
Notez que cela devrait toujours avoir une barre oblique.
STATICFILES_DIRS
Par défaut: []
Ce paramètre définit les emplacements supplémentaires l'application staticfiles va traverser lors de la recherche pour les fichiers multimédias, par exemple si vous utilisez la commande ou la gestion build_static resolve_static ou utilisez la vue de service de fichiers statiques.
Elle devrait être définie comme une séquence de (préfixe, le chemin) tuples, par exemple:
STATICFILES_DIRS = (
& Nbsp; ('', '/home/special.polls.com/polls/media'),
& Nbsp; ('', '/home/polls.com/polls/media'),
& Nbsp; (, '/ opt / webfiles / commune' 'commune'),
)
STATICFILES_PREPEND_LABEL_APPS
Défaut: ('django.contrib.admin',)
Une séquence de chemins d'applications qui devraient être préfixé avec le nom de l'étiquette. Par exemple, django.contrib.admin fichiers multimédia devrait être servi à partir de admin / [js, css, images] plutôt que les fichiers médias pour se faire servir directement à partir de la racine statique.
STATICFILES_MEDIA_DIRNAMES
Défaut: («médias»,)
Une séquence de noms de répertoires à utiliser lors de la recherche pour les fichiers multimédias dans les applications installées, par exemple si une application a ses fichiers de médias dans l'utilisation / statique:
STATICFILES_MEDIA_DIRNAMES = (
& Nbsp; «médias»,
& Nbsp; «statique»,
)
STATICFILES_EXCLUDED_APPS
Par défaut: []
Une séquence de chemins d'applications qui doivent être ignorés lors de la recherche pour les fichiers multimédias:
STATICFILES_EXCLUDED_APPS = (
& Nbsp; »annoying.app ',
& Nbsp; »old.company.app ',
)
STATICFILES_STORAGE
Par défaut: 'staticfiles.storage.StaticFileStorage'
Le stockage à utiliser pour la copie de fichiers statiques à un emplacement unique

Quoi de neuf dans cette version:.

• Ajout API de résolveur où la manière dont staticfiles abstraite trouve les fichiers.
• staticfiles.urls.staticfiles_urlpatterns ajoutée pour éviter le fourre-tout qui peut rendre urlPattern haut niveau urls.py un peu plus confus. De Brian Rosner.
• modifications mineures dans la documentation
• Mise à jour TestRunner de travailler avec Django 1.1.X et 1.2.X.
• Suppression de code personnalisé pour charger backend de stockage.

Quoi de neuf dans la version 0.2.0:

• build_media Rebaptisé et la gestion des commandes de resolve_media build_static et resolve_media d'éviter les confusions entre l'utilisation de Django du terme & quot; & quot médias; (Pour les téléchargements) et & quot; & quot statique; fichiers.
• Retravailler la plupart de la logique interne, en faisant abstraction de la fonctionnalité de base à l'écart des commandes de gestion.

Backend de stockage du système
• de fichier utiliser par défaut, possibilité de remplacer avec backend de stockage personnalisé
• supprimé l'option --interactive de rationaliser fichier statique résoudre.
• Ajout de tests approfondis
• utilise l'enregistrement standard

Exigences :

• Django
• Python