[filters] Jinja - urlize() 필터 ★ - 텍스트 URL을 클릭 가능한 링크로 변환 적용 (= urlize필터 = 얼라이즈필터/얼라이스필터)

1. urlize() 예제 - 텍스트 URL을 클릭 가능한 링크로 변환
2. urlize() 정의
3. urlize() 구문

urlize() 예제 - 텍스트 URL을 클릭 가능한 링크로 변환

[예제1] - 매개변수 없이 가장 간단한 링크로 변환

 

{% set str = "홈짱닷컴 https://homzzang.com" %}

{{ str|urlize }}

 

결과값: 홈짱닷컴 <a href="https://homzzang.com" rel="noopener">https://homzzang.com</a>

---

[예제2] - 링크 표시 문자열 길이 자르기

 

{% set str = "홈짱닷컴 https://homzzang.com/b/jinja-114?sca=filters&page=3" %}

{{ str|urlize(trim_url_limit=20) }}

 

결과값: 홈짱닷컴 <a href="https://homzzang.com/b/jinja-114?sca=filters&amp;page=3" rel="noopener">https://homzzang.com...</a>

---

[예제3] - rel="nofollow"와 target="_blank" 속성 추가

 

{% set str = "홈짱닷컴 https://homzzang.com" %}

{{ str|urlize(nofollow=True, target="_blank") }}

 

결과값: 홈짱닷컴 <a href="https://homzzang.com" rel="nofollow noopener" target="_blank">https://homzzang.com</a>

---

[예제4] - 링크 변환 허용할 추가 스키마 지정

 

{% set str = "공유 폴더 ftp://homzzang.com/shared" %}

{{ str|urlize(extra_schemes=["ftp://"]) }}

 

결과값: 공유 폴더 <a href="ftp://example.com/shared" rel="noopener">ftp://example.com/shared</a> 

urlize() 정의

 

텍스트 URL을 클릭 가능한 링크 태그로 변환 적용하는 필터.

 

---

 

1.

• 일부 상황에서는 이 필터가 링크를 인식하지 못할 수 있음. 일반적으로는 Markdown 라이브러리와 같은 더 포괄적인 포맷터를 사용하는 것이 더 나은 선택임.
• 이 필터는 http://, https://, www., mailto:, 그리고 이메일 주소에서 작동함. 링크 뒤에 구두점(마침표, 쉼표, 닫는 괄호)이 있거나 앞에 구두점(여는 괄호)이 있는 경우, 해당 구두점을 제외하고 링크를 인식함. 헤더 필드를 포함하는 이메일 주소는 인식되지 않음. (예: mailto:?cc=).

 

2.

• Jinja2 2.8 - target 매개변수가 추가됨.
• Jinja2 3.0 - extra_schemes 매개변수가 추가됨.
• Jinja2 3.0 - 스키마 없는 URL에 대해 https:// 링크를 생성.
• Jinja2 3.0 - 구문 분석 규칙이 업데이트됨. mailto: 스키마를 사용하거나 사용하지 않는 이메일 주소를 인식함. IP 주소를 유효성 검사함. 더 많은 경우에 괄호와 대괄호를 무시함.

 

3. 공식 매뉴얼

https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.urlize

 

urlize() 구문

 

jinja-filters.urlize(value: str, trim_url_limit: int | None = None, nofollow: bool = False, target: str | None = None, rel: str | None = None, extra_schemes: Iterable[str] | None = None) → str

 

---

[매개변수]

 

value: str

필수. 링크 추가할 원본 텍스트.

trim_url_limit: int | None = None
선택. 표시되는 URL 값 길이.

nofollow: bool = False

선택. 링크에 rel=nofollow 속성을 추가할지 여부.

 

target: str | None = None

선택. 링크에 target 속성 추가.

 

rel: str | None = None

선택. 링크에 rel 속성 추가.

 

extra_schemes: Iterable[str] | None = None

선택. 링크 변환 대상으로 인식할 추가 스키마 지정.

• 기본 동작 외에 이러한 스키마로 시작하는 URL을 인식함. 추가 스키마가 없으면 기본값으로 설정됨. 
• 기본값은 env.policies["urlize.extra_schemes"]이며, 추가 스키마 없음 의미.

 

---

[반환값]

 

링크 태그로 변환 적용된 문자열 반환.