django-staticfiles

Django-staticfiles je aplikace, Django, která poskytuje pomocníky pro servírování statické soubory.
Hlavní internetové stránky pro Django-staticfiles je bitbucket.org/jezdez/django-staticfiles, kde si můžete také file lístky.
Můžete také nainstalovat verzi in-vývoji Django-staticfiles s pip nainstalovat Django-staticfiles == dev nebo easy_install Django-staticfiles == dev.
Správa Příkazy
build_static
Sbírá mediální soubory ze všech nainstalovaných aplikací a zkopíruje do STATICFILES_STORAGE.
Můžete omezit aplikace analyzované tím, že poskytuje seznam jmen app:
python manage.py build_static --exclude-Dirs admin hlasování
Duplicate File názvy jsou řešeny podobným způsobem, jak šablony rozlišení funguje. Soubory jsou nejprve vyhledávány v STATICFILES_DIRS místa, následuje aplikace v pořadí určeném nastavení INSTALLED_APPS.
Některé běžně používané volby jsou:
--noinput
& Nbsp; NOT vyzve uživatele k zadání jakéhokoli druhu.
-i PATTERN nebo --ignore = VZOR
& Nbsp; Ignorovat soubory nebo adresáře odpovídající tuto glob stylu vzor. Použijte několikrát ignorovat víc.
-n nebo --dry-run
& Nbsp; Dělejte vše kromě změnit souborový systém.
-l nebo --link
& Nbsp; Vytvořte symbolický odkaz na každého souboru namísto kopírování.
--exclude-dirs
& Nbsp; Vyloučit další statické umístění uvedené v nastavení STATICFILES_DIRS.
Úplný seznam možností, najdete v řízení build_static příkazu pomoci příkazem:
python manage.py build_static --help
resolve_static
Řeší jeden či více očekávané relativní URL cestu k absolutní cesty každého multimediálního souboru na souborovém systému. Například:
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
Ve výchozím nastavení jsou všechny odpovídající lokality se nacházejí. Chcete-li vrátit pouze první zápas za každou relativní cestu, použijte --first možnosti:
python manage.py resolve_static css / base.css --first
/home/special.polls.com/core/media/css/base.css
static_url kontext procesor
Chcete-li odkazovat na statické majetku souborů ze šablony, ujistěte se, že jste nastavili STATIC_URL nastavení na cestu URL, kde se podávají statické soubory.
Dále přidejte static_url kontextu procesoru vašeho nastavení TEMPLATE_CONTEXT_PROCESSORS:
TEMPLATE_CONTEXT_PROCESSORS = (
& Nbsp; "staticfiles.context_processors.static_url"
)
Šablony poskytované s RequestContext budou mít nyní přístup k STATIC_URL kontextu proměnné:
Podávat statické soubory v průběhu vývoje
Poznámka
Nepoužívejte tuto funkci na produkčních serverech. Tato funkce je určena pouze pro účely vývoje. Prosím, nestřílejte se do nohy. Díky.
Sloužit statické médium pro oba MEDIA_URL i STATIC_URL přidejte následující úryvek na konci svého primárního nastavení URL:
od django.conf nastavení dovozních
pokud settings.DEBUG:
& Nbsp; urlpatterns + = vzory ('',
& Nbsp; (R '', patří ("staticfiles.urls")),
& Nbsp;)
Nastavení
STATIC_ROOT
Výchozí hodnota: "" (prázdný řetězec)
Absolutní cesta k adresáři, který drží statické soubory, jako app pro média:
STATIC_ROOT = "/home/polls.com/polls/site_media/static/"
Používá se pouze výchozí statické úložiště souborů (tedy pokud používáte jiný STATICFILES_STORAGE, není nutné nastavit to).
STATIC_URL
Výchozí hodnota: "" (prázdný řetězec)
URL, který zpracovává soubory sloužil od STATIC_ROOT, například:
STATIC_URL = '/ site_media / static / "
Všimněte si, že by to mělo mít vždy koncové lomítko.
STATICFILES_DIRS
Výchozí: []
Toto nastavení definuje další umístění staticfiles aplikace bude přejdou při pohledu na mediální soubory, např Pokud použijete příkaz build_static nebo resolve_static řízení, nebo použijte statických souborů slouží názor.
To by mělo být definováno jako sekvence (předčíslí, cesta) n-tic, např:
STATICFILES_DIRS = (
& Nbsp; ('', '/home/special.polls.com/polls/media "),
& Nbsp; ('', '/home/polls.com/polls/media "),
& Nbsp; ("obyčejný", "/ opt / webfiles / common"),
)
STATICFILES_PREPEND_LABEL_APPS
Default: ("django.contrib.admin")
Posloupnost app cest, které by měly být před označením jména. Například, django.contrib.admin multimediální soubory by měly být podávány od admin / [JS, CSS, obrázky], spíše než mediální soubory dostat sloužil přímo ze statického kořene.
STATICFILES_MEDIA_DIRNAMES
Default: ("media",)
Sekvence názvy adresářů které mají být použity při vyhledávání mediálních souborů v nainstalovaných aplikací, např pokud aplikace má své mediální soubory v adresáři / statické použití:
STATICFILES_MEDIA_DIRNAMES = (
& Nbsp; "media",
& Nbsp; "statické",
)
STATICFILES_EXCLUDED_APPS
Výchozí: []
Posloupnost app cest, které by měly být ignorovány při hledání pro multimediální soubory:
STATICFILES_EXCLUDED_APPS = (
& Nbsp; "annoying.app"
& Nbsp; "old.company.app"
)
STATICFILES_STORAGE
Default: "staticfiles.storage.StaticFileStorage"
Úložiště použít pro kopírování statických souborů na jednom místě

Co je nového v této verzi:.

• Přidáno resolveru API který abstraktní způsob, jakým staticfiles najde soubory.
• Přidáno staticfiles.urls.staticfiles_urlpatterns, aby se zabránilo catch-all URLPATTERN, které může dělat nejvyšší úrovně urls.py mírně více matoucí. Od Briana Rosner.
• Drobné změny dokumentace
• Aktualizováno testrunner pracovat s Django 1.1.x a 1.2.x..
• Odstraněna vlastní kód načíst úložiště backend.

Co je nového ve verzi 0.2.0:

• přejmenováno build_media a řízení resolve_media příkazy build_static a resolve_media aby se zabránilo zmatky mezi Django je použití termínu & quot; media & quot; (Pro nahrávání) a & quot; static & quot; files.
• Přepracujte většinu z vnitřní logiky, abstrakce základní funkce od příkazů řízení.

Skladování
• Použít souborový systém backend standardně, schopnost přepsat s vlastní skladovací backend
• Odstraněna --interactive možnost zefektivnit statického souboru hosts.
• Přidáno Rozsáhlé testy
• Používá standardní záznam

Požadavky na :

• Django
• Python