sorl-url

sorl-URL을 sorl - 썸네일 미리보기에 대한 대역 외 처리이다.
설치 및 설정
설치
최신 버전은 GitHub의에 항상 사용할 수 있지만 핍 sorl-URL을 설치할 때 설치가 간단합니다.
설정
1. settings.INSTALLED_APPS에 sorl-URL을 추가합니다.
2. 추가 URL (R '^ 축소판 /'( 'sorl_url.urls') 포함) 당신의 URL의 구성을.
3. 기본값 (아래 사용 참조) 구성합니다.
당신은 sorl - 썸네일, 그 요구 사항을 어떻게 설치 및 읽기 문서 도구에서 구성됩니다에 대한 자세한 내용을 볼 수 있습니다.
용법
핵심 워크 플로우는 sorl_url 템플릿 태그 라이브러리에서 템플릿 태그라는 IMAGE_URL을 통해 사용 주위에 내장되어 있습니다.
sorl_url은 이미지를 직접 제공하지 않습니다. 그것은 sorl-썸네일로 생성 (settings.THUMBNAIL_STORAG​​E 통해 캐시에 저장)하고 생성 된 이미지의 URL로 리디렉션된다.
템플릿 태그
sorl_url의 주요 호출은 다음과 같은 기본 구문을 사용 IMAGE_URL 템플릿 태그를 통해입니다 :
{%의 IMAGE_URL의 SOURCE FIELD_NAME 기하학 [키 1 = VAL1 키 2 = VAL2 ...] %}
나 :
{%의 IMAGE_URL의 SOURCE FIELD_NAME 기하학 [키 1 = VAL1 키 2 = VAL2 ...] VAR의 %로}
& NBSP, 이미지 URL이 VAR {{}}.
{% 빈 %}
& NBSP;이 블록은 선택 사항입니다.
{%의 endimage_url}
호출 예는 다음과 같습니다
<% 부하 IMAGE_URL %>

로 렌더링 할 수있는 (줄 바꿈 추가)
& NBSP; DUwIiwib3B0aW9ucyI6eyJjcm9wIjoiY2VudGVyIn19 : 1SiodC : _wL4eWd9crnlF
& NBSP; X8VJFXgBJdISEQ 'ALT = "신원 미상"/>
사용 가능한 옵션의 전체 목록은 sorl-썸네일의 축소판 템플릿 태그에 대한 설명서를 참조하십시오.
URL 구조
sorl-url은 형태의 URL을 생성 /prefix/MODEL_NAME/FIELD_NAME/KEY.ext?config=OPTIONS을
접두사는 sorl-URL 전망이 URLConf에 포함되는 위치에 의해 결정됩니다
OPTIONS 크기 및 다른 옵션 서명 아래 URL 인수에 기재된 django.core.signing 모듈 난독 포함한 구성이다.
참고 : 구성 쿼리 문자열 인수가 필수입니다. (404)을 일으키는 설정을 제공하지 않으면.
URL 인수
이미지 옵션 구성 쿼리 문자열 인수를 통해 전달됩니다. 값은 난독하지만 enscrypted되지 않습니다. 그들은, 직렬화 된 압축 및 django.core.signing에 의해 서명됩니다.
SORL_URL_CONFIG 및 기타 sorl 설정에 지정된 기본 옵션은 쿼리 문자열에 포함되지 않습니다. 그러나, 서명이 기초 파일 이름 및 속성 및 기본 설정이 업데이트 될 때, URL뿐만 아니라 변화 할 것을 보장하기 위해 모든 관련 설정의 해시 포함한 다양한 속성과 소금된다. 이 SORL_URL_CONFIG의 변경, 예를 들어, 모든 URL이 업데이트를 당할 것을 의미합니다. 이 수도 있고 (변경된 내용에 따라) sorl에 의해 생성되는 새로운 이미지를 얻을 수하지 않을 수 있습니다.
디버깅 : 쉽게 True로 렌더링, 간단하게 설정 settings.THUMBNAIL_DEBUG에 대한 통과 추가 및 생성 된 모든 URL에 충실 = 에코 옵션이 전달되는 것을 보시기되고 있는지 인수를 볼 수 있습니다.
설정 구성
사용 가능한 옵션 및 기본값은 SORL_URL_CONFIG 설정에 의해 제어된다.
SORL_URL_CONFIG는 MODEL_NAME의 URL 구성 요소와 모델 구성을 나타내는 사전 같은 값에 대응 키가있는 사전 같은 객체 여야합니다.
또한 SORL_URL_PERMANENT_REDIRECT (기본값 : FALSE)를 사용 리디렉션의 유형을 제어하기 위해 사용될 수있다.
모델 구성
각 모델의 구성은 다음과 같은 옵션을 제공합니다 :
- 모델 : 모델 클래스 또는 장고 스타일의 점으로 구분 된 이름 (app_label.ModelName) 중 하나 (필수)
- 필드 :이 구성에 의해 노광되어야 모델에 속성의리스트; 대안 옵션이 기본 포함 된 사전 sorl 백엔드의 get_thumbnail 메소드에 전달 될 형식 (attr_name, 옵션)의 2 튜플 (필수)
- 백엔드 (; sorl.thumbnail.default.backend````디폴트 옵션) sorl 백엔드 모듈 경로를 나타내는 문자열로 사용되는
- key_field : 필드는 URL의 주요 부분에 대한 객체 조회에 사용되는 (옵션;`디폴트는`id``)
- key_filter : 변환 기능이 제대로 ORM을 위해 준비되어 있는지 확인하기 위해 키 URL 구성 요소에 적용 할 (옵션, 디폴트를`에`람다 X : INT (X)``)
- 옵션 : 기본 옵션이 포함 된 사전은 sorl 백엔드의 get_thumbnail 메소드에 전달한다. 개별 필드는이 옵션을 오버라이드 (override) 할 수 있습니다. (옵션;`디폴트`{}``)
구성 예제
최소한의 구성은 다음과 같을 수 있습니다 :
SORL_URL_CONFIG = {
& NBSP; '프로필'{
& NBSP; '모델': 'profiles.Profile'
& NBSP; '필드'[ '아바타'],
& NBSP;}
}
위의 구성은 다음 URL이 유효 할 것이라는 점을 의미한다 : /prefix/profiles/avatar/1.png?config=CONFIG
고급 구성은 다음과 같을 수 있습니다 :
SORL_URL_CONFIG = {
& NBSP; '프로필'{
& NBSP; '모델': 'profiles.Profile'
& NBSP; '필드':
& NBSP; ( '아바타', {
& NBSP; '형식': 'PNG',
& NBSP; '작물': '최고'
& NBSP; '고급': 참
& NBSP;})
& NBSP; ( '배경'{
& NBSP; '형식': 'JPEG',
이 & nbsp; '품질'(90)
& NBSP; '색 공간': 'GRAY'
& NBSP;}
& NBSP;)
& NBSP],
& NBSP; 'key_field': 'user__username'를,
& NBSP; 'key_filter', INT (X) : 없음 # 기본값은 람다 x는
& NBSP; #하지만 없음은 (: X 람다 x)는 어떤 조합을 의미하지
& NBSP;}
}
위의 구성은 다음 URL이 노출 될 수있는 것을 의미한다 :
- /prefix/profiles/avatar/1.png?config=CONFIG
- /prefix/profiles/background/1.jpg?config=CONFIG

Requirements:

Python
sorl - 썸네일