escape_once

이미 이스케이프된 HTML 엔티티는 보존하고 아직 변환되지 않은 특수문자만 1회 이스케이프하는 필터입니다.

문법

{{ html_string | escape_once }}

예시

{% assign html = "<b>강조</b> & 텍스트" %}{{ html | escape_once }}

결과

<b>강조</b> & 텍스트

escape_once 필터는 문자열 내에 이미 &, < 등의 형식으로 이스케이프된 엔티티가 존재할 경우 이를 중복 변환하지 않고, 이스케이프되지 않은 특수문자만을 선별하여 변환하는 지능적인 이스케이프 필터입니다.

키워드 조합 페이지에서는 일부 데이터 항목에 기호가 엔티티로 사전 인코딩되어 섞여 들어오는 경우 이중 변환(<)으로 인해 화면에 지저분한 코드가 노출되는 현상을 완벽히 방지합니다. 예를 들어 외부 API 연동 키워드의 상세 문구를 표기할 때 {{ row.snippet | escape_once }}를 적용하면 깔끔한 텍스트를 유지할 수 있습니다.

이 문법을 편집기에서 바로 써 보세요.