django-staticfiles

Django-staticfiles er en Django program som gir hjelpere for å tjene statiske filer.
Den viktigste nettsted for django-staticfiles er bitbucket.org/jezdez/django-staticfiles hvor du kan også fil billetter.
Du kan også installere in-utvikling versjon av Django-staticfiles med pip installere django-staticfiles == dev eller easy_install django-staticfiles == dev.
Ledelse kommandoer
build_static
Samler mediefiler fra alle installerte apper og kopierer dem til STATICFILES_STORAGE.
Du kan begrense apps analyseres ved å tilby en liste over app navn:
python manage.py build_static --exclude-Dirs admin avstemninger
Duplicate File navnene er løst på en lignende måte til hvordan mal oppløsning fungerer. Filene er i utgangspunktet søkte på i STATICFILES_DIRS steder, etterfulgt av apps i den rekkefølgen som er angitt av INSTALLED_APPS innstillingen.
Noen brukte alternativer er:
--noinput
& Nbsp; IKKE be brukeren om innspill av noe slag.
-i MØNSTER eller --ignore = MØNSTER
& Nbsp; Ignorer filer eller kataloger som passer denne glob-stil mønster. Bruk flere ganger for å ignorere mer.
-n eller --dry-løp
& Nbsp; Gjør alt unntatt endre filsystemet.
-l eller --link
& Nbsp; Lag en symbolsk link til hver fil i stedet for kopiering.
--exclude-dirs
& Nbsp; ekskludere tilleggs statiske stedene som er angitt i STATICFILES_DIRS innstillingen.
For en fullstendig liste over alternativer, se build_static ledelsen kommandohjelp ved å kjøre:
python manage.py build_static --help
resolve_static
Løser ett eller flere forventet relativ URL-banen til absolutte stier til hver mediefil på filsystemet. For eksempel:
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
Som standard er alle samsvarende steder funnet. Å bare returnere den første kampen for hver relative banen, bruker --first alternativ:
python manage.py resolve_static css / base.css --first
/home/special.polls.com/core/media/css/base.css
static_url sammenheng prosessor
Å referere til statisk fil eiendeler fra en mal, sikre du har satt STATIC_URL innstillingen til URL-banen hvor de statiske filer blir servert.
Deretter legger den static_url sammenheng prosessor til din TEMPLATE_CONTEXT_PROCESSORS innstilling:
TEMPLATE_CONTEXT_PROCESSORS = (
& Nbsp; 'staticfiles.context_processors.static_url',
)
Maler utførte med RequestContext vil nå ha tilgang til en STATIC_URL sammenheng variabel:
Serverer statiske filer under utvikling
Notat
Ikke bruk dette på produksjonsservere. Denne funksjonen er bare ment for utvikling. Vær så snill, ikke skyt deg selv i foten. Takk.
Å tjene statisk media for både MEDIA_URL og STATIC_URL legge følgende kodebit til slutten av din primære URL konfigurasjon:
fra django.conf importinnstillinger
hvis settings.DEBUG:
& Nbsp; urlpatterns + = mønstre ('',
& Nbsp; (r '', inkluderer ('staticfiles.urls')),
& Nbsp;)
Innstillinger
STATIC_ROOT
Standard: '' (Tom streng)
Den absolutte banen til katalogen som inneholder statiske filer som app media:
STATIC_ROOT = "/home/polls.com/polls/site_media/static/"
Dette brukes bare av standard statiske filer lagring (dvs. hvis du bruker en annen STATICFILES_STORAGE, trenger du ikke å sette dette).
STATIC_URL
Standard: '' (Tom streng)
URL som håndterer filene servert fra STATIC_ROOT, f.eks:
STATIC_URL = '/ site_media / statisk /'
Merk at dette bør alltid ha en skråstrek.
STATICFILES_DIRS
Standard: []
Denne innstillingen definerer flere steder den staticfiles applikasjonen vil traversere når vi leter etter mediefiler, f.eks hvis du bruker build_static eller resolve_static forvaltning kommando eller bruke statisk fil serverer utsikt.
Det bør defineres som en sekvens med (prefiks, bane) tupler, for eksempel:
STATICFILES_DIRS = (
& Nbsp; ('', '/home/special.polls.com/polls/media'),
& Nbsp; ('', '/home/polls.com/polls/media'),
& Nbsp; ('vanlig', '/ opt / webfiles / felles'),
)
STATICFILES_PREPEND_LABEL_APPS
Standard: ('django.contrib.admin',)
En sekvens av app stier som bør være prefiks med navnet etiketten. For eksempel bør django.contrib.admin mediefiler bli servert fra admin / [JS, css, bilder] i stedet for mediefilene får servert direkte fra statisk roten.
STATICFILES_MEDIA_DIRNAMES
Standard: ("media",)
En sekvens av katalognavn som skal brukes når du søker etter mediefiler i installerte programmer, f.eks hvis en app har sine mediefiler i / statisk bruk:
STATICFILES_MEDIA_DIRNAMES = (
& Nbsp; 'media',
& Nbsp; 'statisk',
)
STATICFILES_EXCLUDED_APPS
Standard: []
En sekvens av app stier som bør ignoreres når du søker etter mediefiler:
STATICFILES_EXCLUDED_APPS = (
& Nbsp; 'annoying.app',
& Nbsp; 'old.company.app',
)
STATICFILES_STORAGE
Standard: 'staticfiles.storage.StaticFileStorage'
Lagringen skal brukes for å kopiere statiske filer til ett sted

Hva er nytt i denne utgaven:.

• Lagt resolver API som abstrakte måten staticfiles finner filer.
• Lagd staticfiles.urls.staticfiles_urlpatterns å unngå catch-all URLPATTERN som kan gjøre toppnivå urls.py litt mer forvirrende. Fra Brian Rosner.
• Mindre endringer dokumentasjon
• Oppdatert testrunner å jobbe med Django 1.1.x og 1.2.x.
• Fjernet definert kode for å laste lagring backend.

Hva er nytt i versjon 0.2.0:

• Omdøpt build_media og resolve_media administrasjon kommandoer for å build_static og resolve_media for å unngå forvirring mellom Django bruk av begrepet & quot; media & quot; (For opplasting) og & quot; statisk & quot; filer.
• Rework meste av indre logikk, abstrahere kjernefunksjonaliteten bort fra ledelsen kommandoer.
• Bruk filsystemet lagring backend som standard, evne til å overstyre den med tilpassede lagring backend
• Fjernet --interactive muligheten til å effektivisere statisk fil løse.
• Lagd omfattende tester
• Bruker standard logging

Krav :

• Django
• Python