django-staticfiles

django-staticfiles is een Django applicatie die helpers biedt voor het serveren van statische bestanden.
De belangrijkste website voor django-staticfiles is bitbucket.org/jezdez/django-staticfiles waar u ook tickets kunt indienen.
U kunt ook de in-ontwikkeling versie van Django-staticfiles installeren met pip django-staticfiles installeren == dev of easy_install django-staticfiles == dev.
Beheer Commando
build_static
Verzamelt de mediabestanden van alle geïnstalleerde apps en kopieert ze naar de STATICFILES_STORAGE.
U kunt de apps ontleed door het verstrekken van een lijst met app namen te beperken:
python manage.py build_static --exclude-dirs admin polls
Dupliceren bestandsnamen worden opgelost op een gelijkaardige manier aan hoe sjabloon resolutie werkt. Bestanden worden in eerste instantie gezocht in STATICFILES_DIRS locaties, gevolgd door apps in de volgorde die door de INSTALLED_APPS instelling.
Sommige veelgebruikte opties zijn:
--noinput
& Nbsp; de gebruiker niet om invoer gevraagd van welke aard dan ook.
-i patroon of --ignore = PATROON
& Nbsp; Negeer bestanden of mappen die overeenkomen met dit patroon glob-stijl. Gebruik meerdere keren om meer te negeren.
-n of --dry-run
& Nbsp; Doe alles behalve het bestandssysteem te wijzigen.
-l of --link
& Nbsp; Maak een symbolische link naar elk bestand in plaats van het kopiëren.
--exclude-dirs
& Nbsp; Uitsluiten extra statische locaties genoemd in de STATICFILES_DIRS setting.
Voor een volledige lijst van opties, zie de build_static beheer commando hulp door het uitvoeren van:
python manage.py build_static --help
resolve_static
Worden een of meer verwachte relatieve URL pad naar absolute paden van elk mediabestand op het bestandssysteem. Bijvoorbeeld:
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
Standaard worden alle overeenkomende locaties gevonden. Als u alleen de eerste wedstrijd terug voor elke relatief pad, gebruikt u de --first optie:
python manage.py resolve_static css / base.css --first
/home/special.polls.com/core/media/css/base.css
static_url context processor
Om te verwijzen naar statische bestand activa van een sjabloon, zodat u de STATIC_URL instellen naar de URL pad waar de statische bestanden worden geserveerd hebt ingesteld.
Voeg vervolgens de static_url context processor om uw TEMPLATE_CONTEXT_PROCESSORS instelling:
TEMPLATE_CONTEXT_PROCESSORS = (
& Nbsp; 'staticfiles.context_processors.static_url',
)
Sjablonen teruggegeven met RequestContext heeft nu toegang tot een STATIC_URL context variabele:
Presenteren statische bestanden tijdens de ontwikkeling
Notitie
Gebruik dit niet op de productie servers. Deze functie is alleen bedoeld voor ontwikkeling. Alsjeblieft, niet jezelf in de voet schieten. Thanks.
Om statische media dienen voor zowel MEDIA_URL en STATIC_URL voeg de volgende fragment aan het einde van uw primaire URL configuratie:
van django.conf instellingen import
indien settings.DEBUG:
& Nbsp; urlpatterns + = patronen ('',
& Nbsp; (r '', onder meer ('staticfiles.urls')),
& Nbsp;)
Instellingen
STATIC_ROOT
Standaard: '' (lege string)
Het absolute pad naar de directory die statische bestanden zoals app media geldt:
STATIC_ROOT = "/home/polls.com/polls/site_media/static/"
Dit wordt alleen gebruikt door de standaard statische bestanden opslag (dwz als u een andere STATICFILES_STORAGE gebruiken, hoeft u dit in te stellen).
STATIC_URL
Standaard: '' (lege string)
URL dat de bestanden geserveerd van STATIC_ROOT, bv grepen:
STATIC_URL = '/ site_media / static / "
Merk op dat deze altijd moeten een slash.
STATICFILES_DIRS
Standaard: []
Deze instelling bepaalt de extra locaties de staticfiles app zal doorkruisen bij het zoeken naar mediabestanden, zoals als je de build_static of resolve_static beheer commando gebruiken of gebruik de statische file serving uitzicht.
Het moet worden gedefinieerd als een opeenvolging van (voorvoegsel, pad) tupels, bijvoorbeeld:
STATICFILES_DIRS = (
& Nbsp; ('', '/home/special.polls.com/polls/media'),
& Nbsp; ('', '/home/polls.com/polls/media'),
& Nbsp; ('gewone', '/ opt / webfiles / common'),
)
STATICFILES_PREPEND_LABEL_APPS
Standaard: ('django.contrib.admin',)
Een opeenvolging van app paden die moet worden voorafgegaan door de naam in. Bijvoorbeeld, django.contrib.admin mediabestanden moet worden geserveerd van admin / [js, css, beelden] in plaats van de mediabestanden krijgen direct geserveerd van de statische wortel.
STATICFILES_MEDIA_DIRNAMES
Standaard: ('media',)
Een opeenvolging van directory namen te gebruiken bij het zoeken naar mediabestanden in geïnstalleerde apps, bv Als een app heeft zijn media-bestanden in / statisch gebruik:
STATICFILES_MEDIA_DIRNAMES = (
& Nbsp; 'media',
& Nbsp; 'statisch',
)
STATICFILES_EXCLUDED_APPS
Standaard: []
Een opeenvolging van app paden die moeten worden genegeerd bij het zoeken naar mediabestanden:
STATICFILES_EXCLUDED_APPS = (
& Nbsp; 'annoying.app',
& Nbsp; 'old.company.app',
)
STATICFILES_STORAGE
Standaard: 'staticfiles.storage.StaticFileStorage'
De opslag te gebruiken voor het kopiëren van statische bestanden op één locatie

Wat is nieuw in deze release:.

• Toegevoegd resolver API die abstracte de weg staticfiles bestanden vindt.
• Toegevoegd staticfiles.urls.staticfiles_urlpatterns aan de catch-all URLpattern die top-level urls.py iets meer verwarrend kan maken vermijden. Van Brian Rosner.
• Minor documentatie veranderingen
• Bijgewerkt TestRunner om te werken met Django 1.1.x en 1.2.x.
• Verwijderde aangepaste code aan opslag backend te laden.

Wat is nieuw in versie 0.2.0:

• Hernoemd build_media en resolve_media beheer commando's om build_static en resolve_media om verwarring tussen Django's gebruik van de term & quot voorkomen; media & quot; (Voor upload) en & quot; statische & quot; bestanden.
• Rework het grootste deel van de interne logica, abstraheren de kern functionaliteit van het beheer commando's.
• Gebruik bestandssysteem storage backend standaard mogelijkheid om het te overschrijven met aangepaste opslag backend
• Removed --interactive optie om statische bestand oplossen stroomlijnen.
• Toegevoegd uitgebreide tests
• Maakt gebruik van standaard logging

Eisen

• Django
• Python