django-staticfiles

Django-StaticFiles adalah aplikasi Django yang menyediakan pembantu untuk melayani file statis.
Situs utama untuk Django-StaticFiles adalah bitbucket.org/jezdez/django-staticfiles di mana Anda juga dapat mengajukan tiket.
Anda juga dapat menginstal versi dalam-pengembangan Django-StaticFiles dengan pip menginstal Django-StaticFiles == dev atau easy_install Django-StaticFiles == dev.
Perintah Manajemen
build_static
Mengumpulkan file media dari semua aplikasi yang diinstal dan salinan mereka untuk STATICFILES_STORAGE tersebut.
Anda dapat membatasi aplikasi diurai dengan memberikan daftar nama aplikasi:
jajak pendapat admin python manage.py build_static --exclude-dirs
Duplikat file yang namanya diselesaikan dengan cara yang mirip dengan bagaimana pola resolusi bekerja. File awalnya mencari di lokasi STATICFILES_DIRS, diikuti oleh aplikasi dalam urutan yang ditentukan oleh pengaturan INSTALLED_APPS.
Beberapa opsi yang umum digunakan adalah:
--noinput
& Nbsp; Jangan meminta pengguna untuk masukan apapun.
i POLA atau --ignore = POLA
& Nbsp; Abaikan file atau direktori pencocokan pola glob-gaya ini. Gunakan beberapa kali untuk mengabaikan lagi.
n atau dry-run
& Nbsp; Apakah segala sesuatu kecuali memodifikasi sistem berkas.
l atau --link
& Nbsp; Buat symbolic link ke setiap file bukan menyalin.
--exclude-dirs
& Nbsp; Kecualikan lokasi statis tambahan yang ditentukan dalam pengaturan STATICFILES_DIRS.
Untuk daftar lengkap dari pilihan, lihat perintah manajemen build_static bantuan dengan menjalankan:
python manage.py build_static help
resolve_static
Menyelesaikan satu atau lebih diharapkan path relatif URL ke jalur absolut dari masing-masing file media pada filesystem. Sebagai contoh:
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
Secara default, semua lokasi yang cocok ditemukan. Untuk hanya mengembalikan pertandingan pertama untuk setiap path relatif, gunakan opsi --first:
python manage.py resolve_static css / base.css --first
/home/special.polls.com/core/media/css/base.css
prosesor konteks static_url
Untuk merujuk ke aset berkas statis dari template, pastikan Anda telah mengatur STATIC_URL pengaturan untuk jalur URL di mana file statis dilayani.
Selanjutnya, tambahkan prosesor konteks static_url untuk TEMPLATE_CONTEXT_PROCESSORS pengaturan Anda:
TEMPLATE_CONTEXT_PROCESSORS = (
& Nbsp; 'staticfiles.context_processors.static_url',
)
Template diberikan dengan RequestContext sekarang akan memiliki akses ke variabel konteks STATIC_URL:
Melayani file statis selama pengembangan
Catatan
Jangan gunakan pada server produksi. Fitur ini hanya ditujukan untuk pembangunan. Tolong, jangan menembak diri sendiri di kaki. Terima kasih.
Untuk melayani media yang statis untuk kedua MEDIA_URL dan STATIC_URL tambahkan potongan berikut ke akhir konfigurasi URL utama Anda:
dari django.conf pengaturan impor
jika settings.DEBUG:
& Nbsp; urlpatterns + = pola ('',
& Nbsp; (r '', termasuk ('staticfiles.urls')),
& Nbsp;)
Pengaturan
STATIC_ROOT
Default: '' (string kosong)
Path absolut ke direktori yang menyimpan file statis seperti Media app:
STATIC_ROOT = "/home/polls.com/polls/site_media/static/"
Ini hanya digunakan oleh default statis penyimpanan file (misalnya jika Anda menggunakan STATICFILES_STORAGE yang berbeda, Anda tidak perlu mengatur ini).
STATIC_URL
Default: '' (string kosong)
URL yang menangani file dilayani dari STATIC_ROOT, misalnya:
STATIC_URL = '/ site_media / statis /'
Catatan bahwa ini harus selalu memiliki garis miring.
STATICFILES_DIRS
Default: []
Pengaturan ini mendefinisikan lokasi tambahan aplikasi StaticFiles akan melintasi ketika mencari file media, misalnya jika Anda menggunakan build_static atau manajemen resolve_static perintah atau menggunakan static file melayani pandangan.
Ini harus didefinisikan sebagai urutan (awalan, path) tupel, misalnya:
STATICFILES_DIRS = (
& Nbsp; ('', '/home/special.polls.com/polls/media'),
& Nbsp; ('', '/home/polls.com/polls/media'),
& Nbsp; ('umum', '/ opt / webfiles / common'),
)
STATICFILES_PREPEND_LABEL_APPS
Default: ('django.contrib.admin',)
Sebuah urutan aplikasi jalur yang harus diawali dengan nama label. Sebagai contoh, django.contrib.admin file media harus dilayani dari admin / [js, css, gambar] daripada file media mendapatkan disajikan langsung dari akar statis.
STATICFILES_MEDIA_DIRNAMES
Default: ('Media',)
Sebuah urutan nama direktori yang akan digunakan ketika mencari file media dalam aplikasi diinstal, misalnya jika sebuah aplikasi memiliki file media yang digunakan statis /:
STATICFILES_MEDIA_DIRNAMES = (
& Nbsp; 'Media',
& Nbsp; 'statis',
)
STATICFILES_EXCLUDED_APPS
Default: []
Sebuah urutan jalur aplikasi yang harus diabaikan ketika mencari file media:
STATICFILES_EXCLUDED_APPS = (
& Nbsp; 'annoying.app',
& Nbsp; 'old.company.app',
)
STATICFILES_STORAGE
Default: 'staticfiles.storage.StaticFileStorage'
Penyimpanan yang akan digunakan untuk menyalin file statis untuk satu lokasi

Apa yang baru dalam rilis ini:.

• Ditambahkan penyelesai API yang cara StaticFiles abstrak menemukan file.
• staticfiles.urls.staticfiles_urlpatterns Ditambahkan untuk menghindari menangkap-semua URLPATTERN yang dapat membuat tingkat atas urls.py sedikit lebih membingungkan. Dari Brian Rosner
.
• perubahan dokumentasi kecil
• Diperbarui testrunner untuk bekerja dengan Django 1.1.x dan 1.2.x.
• kode kustom Dihapus untuk memuat penyimpanan backend.

Apa yang baru dalam versi 0.2.0:

• Berganti nama build_media dan manajemen resolve_media perintah untuk build_static dan resolve_media untuk menghindari kebingungan antara penggunaan Django istilah & quot; Media & quot; (Untuk upload) dan & quot; statis & quot; file.
• Mengolah sebagian besar logika internal, abstrak fungsionalitas inti dari perintah manajemen.

Sistem penyimpanan
• Gunakan berkas backend secara default, kemampuan untuk mengesampingkan dengan penyimpanan kustom backend
• Dihapus pilihan --interactive untuk merampingkan berkas statis menyelesaikan.
• Ditambahkan tes ekstensif
• Menggunakan logging standar

Persyaratan :

• Django
• Python