sorl-url "out-of-band apdorojimas sorl-miniatiūrų miniatiūras.
Diegimas ir sąranka "
Montavimas
Įdiegimas yra taip paprasta, kaip PIP įdiegti sorl-url nors naujausia versija visada galima rasti GitHub.
Sąranka
1. Pridėti sorl-nuorodą savo settings.INSTALLED_APPS.
2. Add URL (r "^ miniatiūros /" apima ("sorl_url.urls")), kad jūsų URL konfigūracijos.
3. Konfigūruoti savo įsipareigojimų nevykdymą (žr naudojimas žemiau).
Galite paskaityti daugiau apie sorl-miniatiūrą, jos reikalavimus ir kaip ji yra įdiegta ir sukonfigūruota ne Read Docs.
Naudojimas
Pagrindinė eiga yra pastatytas aplink naudojimas per šablono žymeles IMAGE_URL į sorl_url šablonų tegus bibliotekoje.
sorl_url netarnauja vaizdus tiesiogiai. Jis generuoja juos sorl-miniatiūrą būtų (saugoti juos į talpyklą per settings.THUMBNAIL_STORAGE) ir tada nukreipia į generuoja paveikslėlio URL.
Šablonas Žymos
Pagrindinis užkalbėjimas sorl_url yra per IMAGE_URL šablonų žymę, kuri naudoja šias pagrindines sintaksė:
{% IMAGE_URL ŠALTINIS FIELD_NAME GEOMETRIJA [key1 = VAL1 key2 = VAL2 ...]%}
arba:
{% IMAGE_URL ŠALTINIS FIELD_NAME GEOMETRIJA [key1 = VAL1 key2 = VAL2 ...] kaip VAR%}
& Nbsp; vaizdo URL {{VAR}}.
{% Tuščias%}
& Nbsp; Tai blokas yra neprivalomas.
{% Endimage_url}
Pavyzdys maldavimas gali būti:
<% Apkrova IMAGE_URL%>
Kuris gali padaryti taip (pridėtinės eilutės lūžiai):& Nbsp; DUwIiwib3B0aW9ucyI6eyJjcm9wIjoiY2VudGVyIn19: 1SiodC: _wL4eWd9crnlF
& Nbsp; X8VJFXgBJdISEQ "alt =" "Jane Doe" />
Norėdami gauti pilną sąrašą galimų variantų, prašome konsultuotis su sorl-Miniatiūra miniatiūros šablonų žymę dokumentus.
URL struktūra
sorl-url generuoja URL forma: /prefix/MODEL_NAME/FIELD_NAME/KEY.ext?config=OPTIONS
prefiksas diktuoja ta vieta, kurioje sorl-url svečiai yra įtrauktos į URLConf
GALIMYBĖS yra konfigūracija, įskaitant dydžio ir kitų variantų pasirašytų ir neskaidri aprašytu argumentai žemiau URL django.core.signing modulį.
Pastaba: config Užklausos argumentas yra privalomi. Jeigu pateikti config rezultatas bus 404.
URL argumentai
Vaizdo variantai išlaikė per config užklausos eilutės argumentas. Vertybės yra neskaidri, o ne enscrypted. Jie serializowany, suspaustos ir pasirašo django.core.signing.
Numatytosios parinktys nurodyti SORL_URL_CONFIG ir kitų sorl nustatymus nėra įtrauktos į užklausos eilutę. Tačiau parašas sūdyti su atributais įvairovė, įskaitant pagrindinio failo pavadinimą ir visų atitinkamų nustatymų maišos užtikrinti, kad pagrindinės savybės ir parametrai yra atnaujinami, URL bus pakeisti taip pat. Atkreipkite dėmesį, kad tai reiškia, kad į SORL_URL_CONFIG pokytis, pavyzdžiui, sukels visus URL, nuolat atnaujinami. Tai gali ar negali sukelti naujų vaizdams generuojamų sorl (priklausomai nuo to, ką buvo pakeista).
Derinimo: lengvai matyti, kas argumentai yra patvirtinta taukų, tiesiog nustatykite settings.THUMBNAIL_DEBUG tiesa ir prideda & aido = True bet generuoja URL pamatyti, kas galimybės yra praėjo.
konfigūravimas Nustatymai
Galimos parinktys ir delspinigiai yra kontroliuojama SORL_URL_CONFIG nustatymas.
SORL_URL_CONFIG turi būti žodyno, kaip objektas mygtukus, atitinkančius MODEL_NAME URL komponento ir žodyno panašūs vertės atstovaujančio modelio konfigūraciją.
Be SORL_URL_PERMANENT_REDIRECT (pagal nutylėjimą: false) gali būti naudojami siekiant kontroliuoti peradresavimo tipą, kuris yra naudojamas.
Modelis konfigūracija
Kiekvienas modelis konfigūracija suteikia šias galimybes:
- Modelis: arba modelis klasės ar Django stiliaus punktyras vardas (app_label.ModelName) (būtina)
- sritys: iš atributai modelį, kuris turėtų būti paveikti šiame konfigūracijos, sąrašas; alternatyviai 2-kortežas formatą (attr_pavadinimas, galimybės), kur galimybės yra žodynas, kuriame yra pagal nutylėjimą turi būti perduota į sorl vidinis anketa get_thumbnail metodą (būtinas)
- Vidinis: sorl posistemės, kaip eilutę atstovaujančio modulio keliu, turi būti naudojamas (Pildyti neprivaloma; nutylėjimą `` sorl.thumbnail.default.backend``)
- Key_field: laukas turi būti naudojamas objektų paieška "pagrindinei daliai URL (Pildyti neprivaloma; nutylėjimą` `id``)
- Key_filter: transformacija funkcija turi būti taikomas pagrindinio URL komponento, siekiant užtikrinti, kad būtų tinkamai paruošti ORM (Pildyti neprivaloma; numatytuosius į `` lambda x: int (x) ``)
- galimybės: žodynas, kuriame yra numatytąsias parinktis, kurios perduodamos į sorl vidinis anketa get_thumbnail metodą. Individualūs laukai gali nepaisyti šių variantų. (Pildyti neprivaloma; nutylėjimą `` {} ``)
Konfigūravimo pavyzdžiai
Minimali konfigūracija gali atrodyti taip:
SORL_URL_CONFIG = {
& nbsp; "profiliai": {
& Nbsp; "Modelis": "profiles.Profile"
& Nbsp; "laukai": ["avataras"],
& Nbsp;}
}
Aukščiau konfigūracija reikštų, kad po URL galiotų: /prefix/profiles/avatar/1.png?config=CONFIG
Daugiau pažangių konfigūracija gali atrodyti taip:
SORL_URL_CONFIG = {
& nbsp; "profiliai": {
& Nbsp; "Modelis": "profiles.Profile"
& Nbsp; "laukai": [
& Nbsp; ("avataras", {
& Nbsp; "formatas": "PNG"
& Nbsp; "pasėlis" apibrėžtį: "iš viršaus",
& Nbsp; "upscale": Tiesa
& Nbsp;}),
& Nbsp; ("pirminės žinios": {
& Nbsp; "formatas": "JPEG"
& Nbsp; "kokybė": 90,
& Nbsp; "colorspace": "GRAY"
& Nbsp;}
& Nbsp;)
& Nbsp;]
& Nbsp; "key_field": "user__username",
& Nbsp; "key_filter": Nieko # nutylėjimą yra lambda x: int (x)
& Nbsp; # bet nė vienas reiškia ne-op (lambda x: x)
& Nbsp;}
}
Aukščiau konfigūracija reikštų, kad šie URL bus veikiami:
- /prefix/profiles/avatar/1.png?config=CONFIG
- /prefix/profiles/background/1.jpg?config=CONFIG
Requirements:
- Python
- sorl-miniatiūra "
Komentarai nerastas